The table below describes the headers you can use in a request to upload a part of a multipart upload by copying.
Request header | Description | Required |
---|---|---|
Authorization | See Authentication. | Yes |
Content-Type | Specifies the Internet media type of the data being copied. Valid values are Internet media types (for example, text/plain, application/xml, or image/jpeg). | No |
Date | See Common request headers. | Date or x-amz-date |
Host | See Common request headers. | Yes |
x-amz-copy-source |
Specifies the source bucket and object or object version, in this format: /bucket-name/source-object-name
The initial forward slash (/) is required. Valid values for source-object-version-id are the IDs of versions of the source object specified in the request. The versionId query parameter is not case sensitive. If you include the versionId query parameter in the x-amz-copy-source header with an invalid value while versioning is enabled, HCP returns a 404 (Not Found) status code and does not perform the upload part copy operation. If you include the versionId query parameter in the x-amz-copy-source header while versioning is disabled, the parameter is ignored, and the current version of the specified object is used as the source for the upload part copy operation. |
Yes |
x-amz-copy-source-if-
match |
Specifies one or more values for comparison with the ETag of the specified source object or object version. If the ETag matches one of the specified values, HCP continues processing the request. If the ETag doesn’t match any of the specified values, HCP returns a 412 (Precondition Failed) status code and does not upload the part. To specify the values for this header, use this format: "value"[, "value"]... In this format, each value can be any string of one or more characters and must be enclosed in double quotation marks ("). Alternatively, you can specify a single asterisk (*) as the value for the x-amz-copy-source-if-match header. All ETags match an asterisk in an x-amz-copy-source-if-match header. |
No |
x-amz-copy-source-if-
modified-since |
Specifies a date and time, in Greenwich Mean Time (GMT), for comparison with the date and time the specified source object or object version was last modified. If the modification date and time is later than the specified date and time, HCP continues processing the request. If the modification date and time is equal to or earlier than the specified date and time, HCP returns a 412 (Precondition Failed) status code and does not upload the part. To specify the date and time for this header, use one of these formats: •DDD,ddMMMyyyyHH:mm:ss(+0000|GMT) For example: Tue, 07 Feb 2017 14:27:05 +0000 •DDDD,dd-MMM-yyyyHH:mm:ss(+0000|GMT) For example: Tuesday, 07-Feb-17 14:27:05 +0000 •DDDMMMdHH:mm:ssyyyy For example: Tue Feb 7 14:27:05 2017 In these formats: •DDD is the three-letter abbreviation for the day of the week, with an uppercase first letter (for example, Mon). •DDDD is the day of the week fully spelled out, with an uppercase first letter (for example, Monday). •d is the one- or two-digit day of the month, as applicable. •dd is the two-digit day of the month. •MMM is the three-letter abbreviation for the month, with an uppercase first letter (for example, Feb). •yy is the last two digits of the year. HCP assumes that the intended year is within 80 years before or 20 years after the current year. •yyyy is the four-digit year. •HH is the hour on a 24-hour clock. •mm is the number of minutes. •ss is the number of seconds. If the value specified by the x-amz-copy-source-if-modified-since header doesn’t conform to one of the formats shown above, the header is ignored. |
No |
x-amz-copy-source-if-
none-match |
Specifies one or more values for comparison with the ETag of the specified source object or object version. If the ETag doesn’t match any of the specified values, HCP continues processing the request. If the ETag matches any of the specified values, HCP returns a 412 (Precondition Failed) status code and does not upload the part. To specify the values for this header, use this format: "value"[, "value"]... In this format, each value can be any string of one or more characters and must be enclosed in double quotation marks ("). Alternatively, you can specify a single asterisk (*) as the value for the x-amz-copy-source-if-match header. No ETags match an asterisk in an x-amz-copy-source-if-match header. |
No |
x-amz-copy-source-if-
unmodified-since |
Specifies a date and time, in Greenwich Mean Time (GMT), for comparison with the date and time the specified source object or object version was last modified. If the modification date and time is equal to or earlier than the specified date and time, HCP continues processing the request. If the modification date and time is later than the specified date and time, HCP returns a 412 (Precondition Failed) status code and does not upload the part. For valid values for this header, see the description of the x-amz-copy-source-if-modified-since header above. |
No |
x-amz-copy-source- range |
Copies part of the source object. For valid values for this header, see Uploading a part of a multipart object by copying. | No |
x-amz-date | See Common request headers. | x-amz-date or Date |
© 2015, 2020 Hitachi Vantara LLC. All rights reserved.