Retrieve container metadata HEAD /v1/{account}/{container}
Retrieves the container metadata, including the number of objects and their size in bytes
Upon successful completion, the 204 status code is returned.
Request headers
X-Auth-Token
Authentication token. If omitted, the request will fail, unless access using an ACL is permitted. Refer to ACL for details.
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Newest
When "True" is set, object storage searches for and returns the newest replica out of all of the replicas. If this header is omitted, object storage selects one normal replica and returns it. When "True" is specified in this header, it becomes extremely costly. Only use this item when absolutely necessary.
| Data Type | Cardinality |
|---|---|
| Boolean | 0..1 |
Request Parameter
{account}
Name uniquely assigned by project
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
{container}
Container name
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
Response Headers
Content-Length
Number of bytes of the response body
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
X-Container-Object-Count
Number of objects in the container
| Data Type | Cardinality |
|---|---|
| Int | 1..1 |
X-Container-Meta-name
Container metadata. {name} is the name of the metadata item.
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
X-Container-Bytes-Used
Size (in bytes) of the objects in the container
| Data Type | Cardinality |
|---|---|
| Int | 1..1 |
X-Container-Read
Read permissions ACL. If omitted, this will not be returned. Refer to Read Permissions for details.
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Write
Write permissions ACL. If omitted, this will not be returned. Refer to Write Permissions for details.
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Versions-Location
Versioning settings of objects in a container. If omitted, this will not be returned.
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
Content-Type
MIME type of the response body
| Data Type | Cardinality |
|---|---|
| String | 1..1 |
X-Trans-Id
ID assigned to this request. This is used when inquiring about issues.
| Data Type | Cardinality |
|---|---|
| Uuid | 1..1 |
Date
Datetime when transaction was executed.
| Data Type | Cardinality |
|---|---|
| Datetime | 1..1 |
X-Container-Meta-Web-Index
Object name of Index file.
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Meta-Web-Error
Object name of Error page file.
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Meta-Web-Listing
When display of directory lists is enabled, "True" is returned.
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Container-Meta-Web-Listing-CSS
Object name of the style sheet for displaying directory lists.
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
Response Elements
None.
Example of Request
curl -i $publicURL/marktwain -X HEAD -H "X-Auth-Token: $token"
Example of Response
HTTP/1.1 204 No Content
Content-Length: 0
X-Container-Object-Count: 1
Accept-Ranges: bytes
X-Container-Meta-Book: TomSawyer
X-Timestamp: 1389727543.65372
X-Container-Meta-Author: SamuelClemens
X-Container-Bytes-Used: 14
Content-Type: text/plain; charset=utf-8
X-Trans-Id: tx0287b982a268461b9ec14-0052d826e2
Date: Thu, 16 Jan 2014 18:37:22 GMT