Description - Creates a copy of an object that is already stored in Amazon S3.

Runtime Class - com.ibi.agents.XDCopyObjectAgent


Configuration

This action requires a Amazon S3 Generic as well as the following required parameters.

Parameter Groups

 ParameterTypeDescription
*Bucket Name:string The name of the S3 bucket containing the object to copy.
*Key:stringThe location, key which points to the object within the specified bucket.
Version ID:stringThe S3 version ID which uniquely identifies a specific version of the source object to copy.
Modified Since:string The modified constraint that restricts this action to executing only if the source object has been modified after the specified date.
* - denotes required
 ParameterTypeDescription
*Bucket Name:stringThe name of the S3 bucket to which the new object will be copied.
*Key:stringThe location, key which points to the object within the specified bucket.
ACL:stringAccess Control List for the new bucket.

Select from one of the following options:
  • private {Private} - Specifies that the owner is granted Permission.FullControl.
  • public-read {PublicRead} - Specifies that the owner is granted Permission.FullControl and the GroupGrantee.AllUsers group grantee is granted Permission.Read access.
  • public-read-write {PublicReadWrite} - Specifies that the owner is granted Permission.FullControl and the GroupGrantee.AllUsers group grantee is granted Permission.Read and Permission.Write access.
  • authenticated-read {AuthenticatedRead} - Specifies that the owner is granted Permission.FullControl and the GroupGrantee.AuthenticatedUsers group grantee is granted Permission.Read access.
  • log-delivery-write {LogDeliveryWrite} - Specifies that the owner is granted Permission.FullControl and the GroupGrantee.LogDelivery group grantee is granted Permission.Write access, so that access logs can be delivered.
  • bucket-owner-read {BucketOwnerRead} - Specifies that the owner of the bucket is granted Permission.Read. The owner of the bucket is not necessarily the same as the owner of the object.
  • bucket-owner-full-control {BucketOwnerFullControl} - Specifies that the owner of the bucket is granted Permission.FullControl. The owner of the bucket is not necessarily the same as the owner of the object.
  • aws-exec-read {AwsExecRead} - Owner gets FULL_CONTROL. Amazon EC2 gets READ access to GET an Amazon Machine Image (AMI) bundle from Amazon S3.
Destination Storage Class:stringAmazon S3 storage class to use when storing the newly copied object

Select from one of the following options:
  • STANDARD {Standard}
  • REDUCED_REDUNDANCY {ReducedRedundancy}
  • GLACIER {Glacier}
  • STANDARD_IA {StandardInfrequentAccess}
* - denotes required

Output Events

NameDescription
onFailOperationCould not perform the operation requested.
onInvalidStorageClassThe storage class you specified is not valid.
onNoSuchBucketThe specified bucket does not exist.
onFailUnreachableThe host was located but cannot be reached.
onFailConnectCould not connect to the external system.
onInvalidVersionInvalid Version
onFailTimeoutThe operation timed out.
onNoSuchKeyThe specified key does not exist.
onInvalidAccessKeyIDThe AWS access key ID you provided does not exist in our records.