Amazon S3 Operation

Amazon S3 Operation tasks perform operations on Amazon S3 buckets or objects.

All of the fields described in this page are specific to this service. To get general information for setting up a task, see Tasks.

Amazon S3 Operation Properties

This table describes the Amazon S3 Operation task properties:

The fields that will be displayed to the user will vary based on the operation being performed.

Field

Description

AWS Region

The AWS region where the S3 bucket is located.

Operation

The Amazon S3 operation to perform. The operations include:

  Download Object Downloads an object from Amazon S3 to the Agent.
  Upload Object Uploads an object from the Agent to Amazon S3.
  Copy Object Copies an object on Amazon S3.
  Restore Object Restores a previously removed object on Amazon S3.  
  List Objects Lists all objects in a bucket.
  Delete Object Removes an object on Amazon S3.
  Delete Bucket Removes a bucket on Amazon S3.  

 

Create Bucket

Creates a new bucket on Amazon S3.

  Empty Bucket Removes all objects in a bucket on Amazon S3.  

Bucket

The name of the bucket on Amazon S3 on which the operation will be performed.

Object Key

The key value (name) of the Amazon S3 object to be used for the operation.

File Name

The fully-qualified path of the file on the Agent that will be used when transferring data to and from Amazon S3.

Version

The version ID string or version date (in YYYY-MM-DD HH:MM:SS format) of the Amazon S3 object. If left blank, the most recent version will be used. Clicking on the magnifying glass () icon allows the user to find and select a specific version.

Encryption

Specifies the type of encryption to use when storing data on Amazon S3. The valid options are:

  No Encryption No encryption is used.
  Server-Side: S3-Managed Key Data is encrypted on the Amazon S3 server using the default key for the Amazon S3 service.
  Server-Size: KMS-Managed Key Data is encrypted on the Amazon S3 server using a key from the AWS Key Management Service (KMS).

Key ID

The ID of the KMS key. If left blank, the AWS-generated default key will be used.

Target Bucket

For operations that utilize a target location, specifies the name of the bucket on Amazon S3 for the target of the operation.

Target Key

For operations that utilize a target location, specifies the key value (name) of the target object.

Days

The number of days in which the object will be kept after being restored from Amazon Glacier storage. After the specified number of days has elapsed, Amazon S3 automatically deletes the object from Amazon S3, but keeps the object in the Amazon Glacier storage. If an object has already been restored, this value overrides the current value.

Uses Versioning

Configures the new Amazon S3 bucket so that it will support versioning. Versioning allows the retrieval of older versions of an object.

See Creating a Process to add this task to a process.