S3CopyObjectOperation
Contains
the configuration parameters for a PUT Copy object operation. S3 Batch Operations passes every
object to the underlying
CopyObject
API
operation. For more information about the parameters for this operation,
see CopyObject.
Contents
- AccessControlGrants
-
Type: Array of S3Grant data types
Required: No
- BucketKeyEnabled
-
Specifies whether Amazon S3 should use an S3 Bucket Key for object encryption with server-side encryption using Amazon KMS (SSE-KMS). Setting this header to
true
causes Amazon S3 to use an S3 Bucket Key for object encryption with SSE-KMS.Specifying this header with an object action doesn’t affect bucket-level settings for S3 Bucket Key.
Type: Boolean
Required: No
- CannedAccessControlList
-
Type: String
Valid Values:
private | public-read | public-read-write | aws-exec-read | authenticated-read | bucket-owner-read | bucket-owner-full-control
Required: No
- ChecksumAlgorithm
-
Indicates the algorithm that you want Amazon S3 to use to create the checksum. For more information, see Checking object integrity in the Amazon S3 User Guide.
Type: String
Valid Values:
CRC32 | CRC32C | SHA1 | SHA256
Required: No
- MetadataDirective
-
Type: String
Valid Values:
COPY | REPLACE
Required: No
- ModifiedSinceConstraint
-
Type: Timestamp
Required: No
- NewObjectMetadata
-
If you don't provide this parameter, Amazon S3 copies all the metadata from the original objects. If you specify an empty set, the new objects will have no tags. Otherwise, Amazon S3 assigns the supplied tags to the new objects.
Type: S3ObjectMetadata data type
Required: No
- NewObjectTagging
-
Type: Array of S3Tag data types
Required: No
- ObjectLockLegalHoldStatus
-
The legal hold status to be applied to all objects in the Batch Operations job.
Type: String
Valid Values:
OFF | ON
Required: No
- ObjectLockMode
-
The retention mode to be applied to all objects in the Batch Operations job.
Type: String
Valid Values:
COMPLIANCE | GOVERNANCE
Required: No
- ObjectLockRetainUntilDate
-
The date when the applied object retention configuration expires on all objects in the Batch Operations job.
Type: Timestamp
Required: No
- RedirectLocation
-
Specifies an optional metadata property for website redirects,
x-amz-website-redirect-location
. Allows webpage redirects if the object is accessed through a website endpoint.Type: String
Length Constraints: Minimum length of 1. Maximum length of 2048.
Required: No
- RequesterPays
-
Type: Boolean
Required: No
- SSEAwsKmsKeyId
-
Type: String
Length Constraints: Minimum length of 1. Maximum length of 2000.
Required: No
- StorageClass
-
Type: String
Valid Values:
STANDARD | STANDARD_IA | ONEZONE_IA | GLACIER | INTELLIGENT_TIERING | DEEP_ARCHIVE | GLACIER_IR
Required: No
- TargetKeyPrefix
-
Specifies the folder prefix that you want the objects to be copied into. For example, to copy objects into a folder named
Folder1
in the destination bucket, set theTargetKeyPrefix
property toFolder1
.Type: String
Length Constraints: Minimum length of 1. Maximum length of 1024.
Required: No
- TargetResource
-
Specifies the destination bucket Amazon Resource Name (ARN) for the batch copy operation. For example, to copy objects to a bucket named
destinationBucket
, set theTargetResource
property toarn:aws:s3:::destinationBucket
.Type: String
Length Constraints: Minimum length of 1. Maximum length of 128.
Pattern:
arn:[^:]+:s3:.*
Required: No
- UnModifiedSinceConstraint
-
Type: Timestamp
Required: No
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: