Object operations

The following Swift API operations are performed on objects.

Operation Implementation
DELETE object Deletes an object's content and metadata from the StorageGRID Webscale system.

The following request parameters are required:

  • Account
  • Container
  • Object

The following request header is required:

  • X-Auth-Token

A successful execution returns the following response headers with an "HTTP/1.1 204 No Content" response:

  • Content-Length
  • Content-Type
  • Date
  • X-Trans-Id
GET object Retrieves the object content and gets the object metadata from a StorageGRID Webscale system.

The following request parameters are required:

  • Account
  • Container
  • Object

The following request header is required:

  • X-Auth-Token

The following request headers are optional:

  • Accept-Encoding
  • If-Match
  • If-Modified-Since
  • If-None-Match
  • If-Unmodified-Since
  • Range

A successful execution returns the following headers with an "HTTP/1.1 200 OK" response:

  • Accept-Ranges
  • Content-Length
  • Content-Type
  • Date
  • ETag
  • Last-Modified
  • X-Timestamp
  • X-Trans-Id
HEAD object

Retrieves metadata and properties of an ingested object from a StorageGRID Webscale system.

The following request parameters are required:

  • Account
  • Container
  • Object

The following request header is required:

  • X-Auth-Token

A successful execution returns the following headers with an "HTTP/1.1 200 OK" response:

  • Accept-Ranges
  • Content-Length
  • Content-Type
  • Date
  • ETag
  • Last-Modified
  • X-Timestamp
  • X-Trans-Id
PUT object

Creates a new object with data and metadata, or replaces an existing object with data and metadata in a StorageGRID Webscale system.

Note: StorageGRID Webscale supports objects up to 5 TB in size.

The following request parameters are required:

  • Account
  • Container
  • Object

The following request header is required:

  • X-Auth-Token

The following request headers are optional:

  • Content-Encoding
  • Content-Length
  • Content-Type
  • ETag
  • Transfer-Encoding
  • X-Object-Meta-<name> (object-related 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-Object-Meta-Creation-Time. For example: X-Object-Meta-Creation-Time=1443399726. This field is evaluated as seconds since Jan 1, 1970.

    For details, see "Reference time" in the Administrator Guide.

  • X-Storage-Class:reduced_redundancy

    Specifies a single-commit ingest operation. This does not affect the information lifecycle management (ILM) policy and does not result in data being stored at lower levels of redundancy in the StorageGRID Webscale system.

    For details, see information about ILM policies in the Administrator Guide.

A successful execution returns the following headers with an "HTTP/1.1 201 Created" response:

  • Content-Length
  • Content-Type
  • Date
  • ETag
  • Last-Modified
  • X-Trans-Id