Table of ContentsView in Frames

Operations on objects

The StorageGRID Webscale system implements operations on objects differently than the Amazon S3 REST API.

Data objects ingested to the StorageGRID Webscale system through Swift, CDMI, or SGAPI cannot be accessed through S3.

The following operations on objects are supported by the StorageGRID Webscale system:

Operation Implementation
DELETE Object

Multi-Factor Authentication (MFA) and the response header x-amz-mfa are not supported.

DELETE Multiple Objects

Multi-Factor Authentication (MFA) and the response header x-amz-mfa are not supported.

Multiple objects can be deleted in the same request message.

Unlike the PUT object operation, the DELETE multiple object operation does not support chunked transfer encoding and the content encoding gzip attributes.

GET Object

The following request headers are not supported and return XNotImplemented:

  • x-amz-restore
  • x-amz-website-redirect-location
GET Object ACL If the necessary access credentials are provided for the account, returns a positive response and the ID, DisplayName, and Permission of the object owner, indicating that the owner has full access to the object.
HEAD Object

The following request headers are not supported and return XNotImplemented:

  • x-amz-restore
  • x-amz-website-redirect-location
OPTIONS / Client applications can issue requests to the S3 port on a Storage Node, without providing S3 authentication credentials, to determine whether the LDR Service is available.
PUT Object

The x-amz-storage-class request header is supported with the following enumerated values:

  • STANDARD: (Default) Specifies a dual-commit ingest operation.
  • REDUCED_REDUNDANCY: Specifies a single-commit ingest operation.
Note: Specifying the REDUCED_REDUNDANCY value does not affect the specified information lifecycle management (ILM) policy, and does not result in data being stored at lower levels of redundancy in the StorageGRID Webscale system.

The PUT Object operation supports the Transfer-Encoding: chunked and Content-Encoding: gzip attributes.

The following request headers are supported:

  • x-amz-server-side-encryption
  • x-amz-meta- name-value pairs for user-defined metadata

    To record the object creation time, so that you can use the User Defined Creation Time option for the reference time in an ILM rule, you need to store the value in a user-defined header named x-amz-meta-creation-time. For example: x-amz-meta-creation-time=1443399726. This field is evaluated as seconds since Jan 1, 1970. For more information, see "Reference time" in the Administrator Guide.

The following request headers are not supported and return XNotImplemented:

  • Expires
  • x-amz-acl
  • x-amz-server-side-encryption-customer-algorithm
  • x-amz-server-side-encryption-customer-key
  • x-amz-server-side-encryption-customer-key-MD5
  • x-amz-website-redirect-location
PUT Object - Copy

The following request headers are supported:

  • x-amz-meta- name-value pairs for user-defined metadata

    To record the object creation time, so that you can use the User Defined Creation Time option for the reference time in an ILM rule, you need to store the value in a user-defined header named x-amz-meta-creation-time. For example: x-amz-meta-creation-time=1443399726. This field is evaluated as seconds since Jan 1, 1970. For more information, see "Reference time" in the Administrator Guide.

  • x-amz-metadata-directive: The default value is COPY, which enables you to update the object metadata and copy the object.

    You can specify REPLACE to overwrite an existing object and the associated metadata.

  • x-amz-copy-source
  • x-amz-copy-source-if-match
  • x-amz-copy-source-if-none-match
  • x-amz-copy-source-if-unmodified-since
  • x-amz-copy-source-if-modified-since
  • x-amz-server-side-encryption
  • x-amz-storage-class

The following request headers are not supported and return XNotImplemented:

  • x-amz-server-side-encryption-customer-algorithm
  • x-amz-server-side-encryption-customer-key
  • x-amz-server-side-encryption-customer-key-MD5
  • x-amz-website-redirect-location

If the x-amz-copy-source object data matches the destination, the request updates object metadata only. If the x-amz-copy-source object data is different than the destination, the request reads and writes the object data within the StorageGRID Webscale system to create a copy.