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.

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: