taggingDirective
Specifies whether the object tag-set is copied from the source object or replaced with the tag-set that's provided in the request.
The default value is COPY
.
Directory buckets - For directory buckets in a CopyObject
operation, only the empty tag-set is supported. Any requests that attempt to write non-empty tags into directory buckets will receive a 501 Not Implemented
status code. When the destination bucket is a directory bucket, you will receive a 501 Not Implemented
response in any of the following situations:
When you attempt to
COPY
the tag-set from an S3 source object that has non-empty tags.When you attempt to
REPLACE
the tag-set of a source object and set a non-empty value tox-amz-tagging
.When you don't set the
x-amz-tagging-directive
header and the source object has non-empty tags. This is because the default value ofx-amz-tagging-directive
isCOPY
. Because only the empty tag-set is supported for directory buckets in aCopyObject
operation, the following situations are allowed:When you attempt to
COPY
the tag-set from a directory bucket source object that has no tags to a general purpose bucket. It copies an empty tag-set to the destination object.When you attempt to
REPLACE
the tag-set of a directory bucket source object and set thex-amz-tagging
value of the directory bucket destination object to empty.When you attempt to
REPLACE
the tag-set of a general purpose bucket source object that has non-empty tags and set thex-amz-tagging
value of the directory bucket destination object to empty.When you attempt to
REPLACE
the tag-set of a directory bucket source object and don't set thex-amz-tagging
value of the directory bucket destination object. This is because the default value ofx-amz-tagging
is the empty value.