Object operations

The following Swift API operations are performed on objects.

DELETE object

This operation deletes an object's content and metadata from the StorageGRID system.

The following request parameters are required:

The following request header is required:

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

When processing a DELETE Object request, StorageGRID attempts to immediately remove all copies of the object from all stored locations. If successful, StorageGRID returns a response to the client immediately. If all copies cannot be removed within 30 seconds (for example, because a location is temporarily unavailable), StorageGRID queues the copies for removal and then indicates success to the client.

In previous releases, StorageGRID always queued objects for removal. With the introduction of immediate deletion, clients might sometimes receive a slower response, even though object copies are generally being removed more quickly.

For more information on how objects are deleted, see the instructions for administering StorageGRID.

GET object

This operation retrieves the object content and gets the object metadata from a StorageGRID system.

The following request parameters are required:

The following request header is required:

The following request headers are optional:

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

HEAD object

This operation retrieves metadata and properties of an ingested object from a StorageGRID system.

The following request parameters are required:

The following request header is required:

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

PUT object

This operation creates a new object with data and metadata, or replaces an existing object with data and metadata in a StorageGRID system.

Note: StorageGRID supports objects up to 5 TB in size.
Attention: Conflicting client requests, such as a two clients writing to the same key, are resolved on a "latest-wins" basis. The timing for the "latest-wins" evaluation is based on when the StorageGRID system completes a given request, and not on when Swift clients begin an operation.

The following request parameters are required:

The following request header is required:

The following request headers are optional:

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