Additional Header of the Request for Copying an Object
Namespace
obs.CopyObjectHeader
Parameter Description
| Field | Type | Optional or Mandatory | Description |
|---|---|---|---|
| acl | str | Optional | Pre-set access policies, which can be specified during object copy |
| directive | str | Optional | Whether to copy source object attributes to the target object. Possible values are:
|
| if_match | str | Optional | Copies the source object if its ETag is the same as the one specified by this parameter; otherwise, an error code is returned. |
| if_none_match | str | Optional | Copies the source object if its ETag is different from the one specified by this parameter; otherwise, an error code is returned. |
| if_modified_since | str or | Optional | Copies the source object if it is changed after the time specified by this parameter; otherwise, an error code is returned. If this parameter value is a character string, it must conform to the HTTP time format specified in http://www.ietf.org/rfc/rfc2616.txt. |
| if_unmodified_since | str or | Optional | Copies the source object if it is changed before the time specified by this parameter; otherwise, an error code is returned. If this parameter value is a character string, it must conform to the HTTP time format specified in http://www.ietf.org/rfc/rfc2616.txt. |
| location | str | Optional | Location where the object is redirected to, when the bucket is configured with website hosting. |
| destSseHeader | or | Optional | Header for server-side encryption. It is used to encrypt the target object. |
| sourceSseHeader | Optional | Header for server-side decryption. It is used to decrypt the source object. | |
| cacheControl | str | Optional | Rewrites the Cache-Control header in the response. |
| contentDisposition | str | Optional | Rewrites the Content-Disposition header in the response. |
| contentEncoding | str | Optional | Rewrites the Content-Encoding header in the response. |
| contentLanguage | str | Optional | Rewrites the Content-Language header in the response. |
| contentType | str | Optional | Rewrites the Content-Type header in the response. |
| expires | str | Optional | Rewrites the Expires header in the response. |
| storageClass | str | Optional | Storage Classes of the object |
| successActionRedirect | str | Optional | Redirection address after the copy is successful |
| extensionGrants | list of ExtensionGrant | Optional | Extended permission list specified during object copy |
- If the object copy request includes if_unmodified_since, if_match, if_modified_since, or if_none_match, and the specified condition is not met, the object copy will fail with error code 412 Precondition Failed returned.
- if_modified_since and if_none_match can be used together. So do if_unmodified_since and if_match.
Last Article: Response Result of the Request for Deleting an Object
Next Article: Response Result of the Request for Copying an Object
Did this article solve your problem?
Thank you for your score！Your feedback would help us improve the website.