Download S3

Learn more about:

POST Parameters

List with common parameters for all Buddy actions

Name	Type	Description
name `Required`	String	The name of the action.
type `Required`	String	The type of the action. Should be set to `AMAZON_S3`.
bucket_name `Required`	String	The name of the Amazon S3 Bucket.
source_path `Required`	String	The path from which the file will be downloaded.
destination_path `Required`	String	The path in which the file will be saved.
integration `Required`	Integration	The ID of the integration.
overwrite	Boolean	Replace files if they already exist.
recursive	Boolean	If set to `true`, the whole directory tree is downloaded, otherwise only the files from the path are downloaded.
download_excludes	String[]	The paths and/or files that will be left out during the download.
download_includes	String[]	The exceptions from the ignore patterns set in `download_excludes`.

Example

Request

POST https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2/actions

JSON

{
  "name":"Download files from AWS S3/",
  "type":"DOWNLOAD_S3",
  "trigger_time":"ON_EVERY_EXECUTION",
  "bucket_name":"bucketname",
  "source_path":"source",
  "destination_path":"destination",
  "integration":{
    "hash_id":"5ddb7c180fb38be67bd78a88a"
  },
  "overwrite":true,
  "recursive":true,
  "download_excludes": [
    "/tmp",
    "*.log"
  ],
  "download_includes": [
    "/tmp/assets",
    "/tmp/styles"
  ]
}

Sample Response

HTTP

Status: 201 Created
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999

JSON

{
  "url":"https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2/actions/2",
  "html_url":"https://app.buddy.works/buddy/company-website/pipelines/pipeline/2/action/2/edit",
  "id":2,
  "name":"Download files from AWS S3/",
  "type":"DOWNLOAD_S3",
  "trigger_time":"ON_EVERY_EXECUTION",
  "last_execution_status":"INITIAL",
  "source_path":"source",
  "bucket_name":"bucketname",
  "integration":{
    "url":"https://api.buddy.works/workspaces/buddy/user/integrations/5dcd43cee36b2f53f1555978",
    "html_url":"https://app.buddy.works/my-id",
    "hash_id":"5ddb7c180fb38be67bd78a88a",
    "type":"AMAZON"
  },
  "recursive":true,
  "overwrite":true,
  "destination_path":"destination",
  "download_excludes": [
    "/tmp",
    "*.log"
  ],
  "download_includes": [
    "/tmp/assets",
    "/tmp/styles"
  ],
  "pipeline":{
    "url":"https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2",
    "html_url":"https://app.buddy.works/buddy/company-website/pipelines/pipeline/2",
    "id":2,
    "name":"test server",
    "on": "CLICK",
    "refs": [
      "refs/heads/master"
    ],
    "last_execution_status":"SUCCESSFUL",
    "last_execution_revision":"506a3963507943d6908154f4bc9646e829128a08"
  }
}

Last modified on November 16, 2022

Download S3

Knowledge is power!