Amazon Simple Storage Service (Amazon S3) is an object storage service that offers industry leading scalability, data availability, security, and performance.

Connect Amazon S3 with Devo SOAR

1. Navigate to Automations > Integrations.

2. Search for Amazon S3.

3. Click Details, then the + icon. Enter the required information in the following fields.

4. Label: Enter a connection name.

5. Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.

6. Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).

7. Remote Agent: Run this integration using the Devo SOAR Remote Agent.

8. S3 Bucket: (Optional): To access AWS API, provide the name of anyone bucket that you have access to.

9. S3 Datacenter URL (Optional): End Point of the Datacenter in case using personal S3 server. Example: https://s3.logichub.com

10. Access Key: To access AWS API, provide a valid Access Key.

11. Secret Key: To access AWS API, provide a valid Secret Key.

12. After you've entered all the details, click Connect.

Actions for Amazon S3

Download a File

Download file from Amazon S3.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of results:

• has_error: True/False

• error: message/null

• result: File ID

Upload a File

Upload a file to Amazon S3.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of results:

• has_error: True/False

• error: message/null

• result: Success/Failure message.

List Files

List files of Amazon S3 bucket.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of results:

• has_error: True/False

• error: message/null

• result: List of files.

Update Bucket Policy

Update Amazon S3 Bucket Policy.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of results:

• has_error: True/False

• error: message/null

• result: Success/Failure message.

Update Bucket ACL

Update Amazon S3 Bucket Access Control Lists.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of results:

• has_error: True/False

• error: message/null

• result: Success/Failure message

Delete an Object

Delete an object from Amazon S3 Bucket.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of results:

• has_error: True/False

• error: message/null

• result: Success/Failure message.

Load a CSV File

Load a CSV file to JSON from Amazon S3.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

A JSON object containing multiple rows of results:

• has_error: True/False

• error: message/null

• result: Success/Failure message.

Create S3 Bucket

Create a Bucket in Amazon S3.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

JSON containing the following items:

``` {json}{ "has_error": false, "result": "Bucket Created Successfully", "error": null }

## Put Object

Put Object in Amazon S3 Bucket.

### Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

| Input Name     | Description                                                                                                                                        | Required |
| :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | :------- |
| S3 Bucket Name | [Jinja-templated](doc:jinja-template) text containing the name of the S3 Bucket. Example: {{bucket_name}}                                          | Required |
| ACL            | Select the canned ACL to apply to the file. (Default is Private)                                                                                   | Optional |
| File ID        | [Jinja-templated](doc:jinja-template) text containing the id of file whose data is to be written in S3 bucket. Example: {{file_id}}                | Required |
| File Path      | [Jinja-templated](doc:jinja-template) text containing the path along with file name of the file to be created in S3 bucket. Example: {{file_path}} | Required |

### Output

JSON containing following items:


``` {json}{
    "has_error": false,
    "result": "Object Uploaded Successfully",
    "error": null
}

Release Notes

• v2.0.0 - Updated architecture to support IO via filesystem

• v1.3.4 - Description Updated - Description of Upload File action has been updated.

• v1.3.3 - Bug Fixed - Upload File action fixed and changed the authentication mechanism.

• v1.3.1 - Added 2 actions to create s3 bucket and put object in the bucket.