Home > Storage > PowerScale (Isilon) > Product Documentation > Protocols > Dell PowerScale: OneFS S3 API Guide > CopyObject
This API creates a copy of an object that is already stored in OneFS. Table 13 shows the details about the OneFS S3 CopyObject API request parameters and request body. If not specified, OneFS silently ignores all unsupported request parameters and the request body, without returning an error code to the client.
Request parameters/body | Supported | Description |
Bucket | Yes | Required: Yes This is the name of the destination bucket. |
Cache-Control | No | N/A |
Content-Disposition | No | N/A |
Content-Encoding | No | N/A |
Content-Language | No | N/A |
Content-Type | No | N/A. OneFS ignores it and set to binary/octet-stream only. |
Expires | No | N/A |
Key | Yes | Required: Yes This is the key of the destination object. |
x-amz-acl | Yes | This is the canned ACL to apply to the object. OneFS does not support aws-exec-read and log-delivery-write. Valid values: private | public-read | public-read-write | authenticated-read | bucket-owner-read | bucket-owner-full-control |
x-amz-copy-source | Yes | Required: Yes This is the name of the source bucket and key name of the source object |
x-amz-copy-source-if-match | Yes | This copies the object if its ETag matches the specified tag. |
x-amz-copy-source-if-modified-since | Yes | This copies the object if it has been modified since the specified time. |
x-amz-copy-source-if-none-match | Yes | This copies the object if its ETag is different than the specified ETag. |
x-amz-copy-source-if-unmodified-since | Yes | This copies the object if it has not been modified since the specified time. |
x-amz-copy-source-server-side-encryption-customer-algorithm | No | N/A |
x-amz-copy-source-server-side-encryption-customer-key | No | N/A |
x-amz-copy-source-server-side-encryption-customer-key-MD5 | No | N/A |
x-amz-grant-full-control | Yes | This gives the grantee READ, READ_ACP, and WRITE_ACP permissions on the object. |
x-amz-grant-read | Yes | This allows the grantee to read the object data and its metadata. |
x-amz-grant-read-acp | Yes | This allows the grantee to read the object ACL. |
x-amz-grant-write-acp | Yes | This allows the grantee to write the ACL for the applicable object. |
x-amz-metadata-directive | Yes | This specifies whether the metadata is copied from the source object or replaced with metadata that is provided in the request. Valid values: COPY | REPLACE |
x-amz-object-lock-legal-hold | No | N/A |
x-amz-object-lock-mode | No | N/A |
x-amz-object-lock-retain-until-date | No | N/A |
x-amz-request-payer | No | N/A |
x-amz-server-side-encryption | No | N/A |
x-amz-server-side-encryption-aws-kms-key-id | No | N/A |
x-amz-server-side-encryption-context | No | N/A |
x-amz-server-side-encryption-customer-algorithm | No | N/A |
x-amz-server-side-encryption-customer-key | No | N/A |
x-amz-server-side-encryption-customer-key-MD5 | No | N/A |
x-amz-storage-class | No | N/A. OneFS ignores it and sets it to STANDARD only. |
x-amz-tagging | No | N/A |
x-amz-tagging-directive | No | N/A |
x-amz-website-redirect-location | No | N/A |
Note: Amazon S3 allows specifying a grantee using the following headers: email address, id, uri in the x-amz-grant-read, x-amz-grant-read-acp, x-amz-grant-write-acp, and x-amz-grant-full-control. OneFS does not support an email address to specify a grantee, and a 501 NotImplemented code is returned.