aws s3api copy-object
Creates a copy of an object that is already stored in Amazon S3. AWS CLI reference
46 options Its page in the AWS CLI reference
Options
Show its 46 options
--aclThe canned access control list (ACL) to apply to the object.--annotation-directiveSpecifies whether you want to copy annotations from the source object or exclude them.--bucket-key-enabledSpecifies whether Amazon S3 should use an S3 Bucket Key for object encryption with server-side encryption using Key Management Service (KMS) keys (SSE-KMS).--bucketThe name of the destination bucket.--cache-controlSpecifies the caching behavior along the request/reply chain.--checksum-algorithmIndicates the algorithm that you want Amazon S3 to use to create the checksum for the object.--content-dispositionSpecifies presentational information for the object.--content-encodingSpecifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field.--content-languageThe language the content is in.--content-typeA standard MIME type that describes the format of the object data.--copy-source-if-matchCopies the object if its entity tag (ETag) matches the specified tag.--copy-source-if-modified-sinceCopies the object if it has been modified since the specified time.--copy-source-if-none-matchCopies the object if its entity tag (ETag) is different than the specified ETag.--copy-source-if-unmodified-sinceCopies the object if it hasn't been modified since the specified time.--copy-source-sse-customer-algorithmSpecifies the algorithm to use when decrypting the source object (for example, AES256).--copy-source-sse-customer-key-md5, --sse-customer-key-md5Specifies the 128-bit MD5 digest of the encryption key according to RFC 1321.--copy-source-sse-customer-keySpecifies the customer-provided encryption key for Amazon S3 to use to decrypt the source object.--copy-sourceSpecifies the source object for the copy operation.--expected-bucket-ownerThe account ID of the expected destination bucket owner.--expected-source-bucket-ownerThe account ID of the expected source bucket owner.--expiresThe date and time at which the object is no longer cacheable.--grant-full-controlGives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object.--grant-read-acpAllows grantee to read the object ACL.--grant-readAllows grantee to read the object data and its metadata.--grant-write-acpAllows grantee to write the ACL for the applicable object.--if-matchCopies the object if the entity tag (ETag) of the destination object matches the specified tag.--if-none-matchCopies the object only if the object key name at the destination does not already exist in the bucket specified.--keyThe key of the destination object.--metadata-directiveSpecifies whether the metadata is copied from the source object or replaced with metadata that's provided in the request.--metadataA map of metadata to store with the object in S3.--object-lock-event-hold-duration-daysThe event hold duration in days to apply to the object copy.--object-lock-event-hold-duration-yearsThe event hold duration in years to apply to the object copy.--object-lock-event-holdThe event hold status to apply to the object copy.--object-lock-legal-hold-statusSpecifies whether you want to apply a legal hold to the object copy.--object-lock-modeThe Object Lock mode that you want to apply to the object copy.--object-lock-retain-until-dateThe date and time when you want the Object Lock of the object copy to expire.--request-payerConfirms that the requester knows that they will be charged for the request.--server-side-encryptionThe server-side encryption algorithm used when storing this object in Amazon S3.--sse-customer-algorithmSpecifies the algorithm to use when encrypting the object (for example, AES256).--sse-customer-keySpecifies the customer-provided encryption key for Amazon S3 to use in encrypting data.--ssekms-encryption-contextSpecifies the Amazon Web Services KMS Encryption Context as an additional encryption context to use for the destination object encryption.--ssekms-key-idSpecifies the KMS key ID (Key ID, Key ARN, or Key Alias) to use for object encryption.--storage-classIf the x-amz-storage-class header is not used, the copied object will be stored in the STANDARD Storage Class by default.--tagging-directiveSpecifies whether the object tag-set is copied from the source object or replaced with the tag-set that's provided in the request.--taggingThe tag-set for the object copy in the destination bucket.--website-redirect-locationIf the destination bucket is configured as a website, redirects requests for this object copy to another object in the same bucket or to an external URL.