Retrieve account metadata HEAD /v1/{account}
Retrieves the account metadata
- Number of containers
- Number of objects
- Bytes used by object storage
- Custom metadata specified by the user
When processing the number of bytes used by object storage, handle with care. A large number of objects can be stored in the object storage. If possible, it is recommended to use a 64-bit unsigned integer.
The request body will not be accepted.
The metadata header must not be included in the request.
Upon successful completion, the 204 status code will be returned.
If the authentication token is not suitable, the 401 status code will be returned.
Request headers
X-Auth-Token
Authentication token
| Data Type | Cardinality |
|---|---|
| String | 1..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 |
Response Headers
X-Account-Object-Count
Number of objects in the account
| Data Type | Cardinality |
|---|---|
| Int | 1..1 |
X-Account-Container-Count
Number of containers
| Data Type | Cardinality |
|---|---|
| Int | 1..1 |
X-Account-Bytes-Used
Size of the objects stored in object storage by the account.
| Data Type | Cardinality |
|---|---|
| Int | 1..1 |
X-Account-Meta-name
Account metadata. {name} is the name of the metadata item.
| Data Type | Cardinality |
|---|---|
| String | 0..* |
X-Account-Meta-Temp-URL-Key
Secret key used for temporary URLs. If not set, this header will not be returned.
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
X-Account-Meta-Temp-URL-Key-2
Second secret key used for temporary URLs. If not set, this header will not be returned.
| Data Type | Cardinality |
|---|---|
| String | 0..1 |
Content-Length
Number of bytes of the response body
| Data Type | Cardinality |
|---|---|
| String | 1..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 the transaction was executed
| Data Type | Cardinality |
|---|---|
| Datetime | 1..1 |
Response Elements
None.
Example of Request
curl -i $publicURL -X HEAD -H "X-Auth-Token: $token"
Example of Response
HTTP/1.1 204 No Content
Content-Length: 0
X-Account-Object-Count: 1
X-Account-Meta-Book: MobyDick
X-Timestamp: 1389453423.35964
X-Account-Bytes-Used: 14
X-Account-Container-Count: 2
Content-Type: text/plain; charset=utf-8
Accept-Ranges: bytes
X-Trans-Id: txafb3504870144b8ca40f7-0052d955d4
Date: Fri, 17 Jan 2014 16:09:56 GMT