Chapter 2. Object Storage API operations

Manage the accounts, containers, and objects in the Object Storage system.

For a complete description of HTTP 1.1 header definitions, see Header Field Definitions.

MethodURIDescription
Accounts
GET/v1/{account}​{?limit,​marker,​end_marker,​format,​prefix,​delimiter}

Shows details for a specified account and lists containers, sorted by name, in the account.

POST/v1/{account}

Creates, updates, or deletes account metadata.

HEAD/v1/{account}

Shows metadata for a specified account.

Containers
GET/v1/{account}/{container}​{?limit,​marker,​end_marker,​prefix,​format,​delimiter,​path}

Shows details for a specified container and lists objects, sorted by name, in the container.

PUT/v1/{account}/{container}

Creates a container.

DELETE/v1/{account}/{container}

Deletes an empty container.

POST/v1/{account}/{container}

Creates, updates, or deletes custom metadata for a container.

HEAD/v1/{account}/{container}

Shows container metadata, including the number of objects and the total bytes of all objects stored in the container.

Objects
GET/v1/{account}/{container}/{object}​{?signature,​expires,​multipart-manifest}

Downloads the object content and gets the object metadata.

PUT/v1/{account}/{container}/{object}​{?multipart-manifest,​signature,​expires}

Creates a new object with specified data content and metadata, or replaces an existing object with specified data content and metadata.

COPY/v1/{account}/{container}/{object}

Copies an object to another object in the object store.

DELETE/v1/{account}/{container}/{object}​{?multipart-manifest}

Permanently deletes an object from the object store.

HEAD/v1/{account}/{container}/{object}​{?signature,​expires}

Shows object metadata.

POST/v1/{account}/{container}/{object}

Creates or updates object metadata.

Questions? Discuss on ask.openstack.org
Found an error? Report a bug against this page

loading table of contents...