HeadContainer
- Print
- PDF
HeadContainer
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Overview
Views the metadata of containers (buckets).
Caution
The Subaccount can use it through the external API gateway dedicated to Subaccounts.
For more information, see Subaccount.
Syntax
HEAD /v1/AUTH_{project_id}/{container}
Request
| Name | In | Type | Description |
|---|---|---|---|
| project_id | path | string | Enter project ID |
| container | path | string | - Enter the name of the container (bucket) to be viewed - Take precaution when including slash (/) since it can be recognized as {container}/{object} |
| X-Auth-Token (Optional) | header | string | Enter the issued token value |
| X-Newest (Optional) | header | boolean | - If true, it queries all replicas and responds with the information of the most recent replica - If the header is omitted it responds with the information with the fastest response |
Response
| Name | In | Type | Description |
|---|---|---|---|
X-Container-Meta-name | header | string | - Metadata of the container (bucket) - The name part of the header name serves as the metadata's key. |
| Content-Length | header | string | Length of the response result (bytes) |
| X-Container-Object-Count | header | integer | Number of objects in the container (bucket) |
| X-Container-Bytes-Used | header | integer | Total capacity size (bytes) used by the container (bucket) |
| X-Container-Read (Optional) | header | string | READ ACL of the container |
| X-Container-Write (Optional) | header | string | WRITE ACL of the container |
| X-Container-Meta-Quota-Bytes (Optional) | header | string | Capacity limit (bytes) of the container (bucket) |
| X-Container-Meta-Quota-Count (Optional) | header | string | Limit for number of objects in the container (bucket) |
| X-Container-Meta-Access-Control-Allow-Origin (Optional) | header | string | CORS |
| X-Container-Meta-Access-Control-Max-Age (Optional) | header | string | CORS |
| X-Container-Meta-Access-Control-Expose-Headers (Optional) | header | string | CORS |
| X-Container-Meta-Temp-URL-Key (Optional) | header | string | Secret key value for the temporary URL |
| X-Container-Meta-Temp-URL-Key-2 (Optional) | header | string | Second secret key value for the temporary URL |
| X-Timestamp | header | integer | Created time (Unix time) of the container (bucket) |
| X-Container-Sync-Key (Optional) | header | string | not supported |
| X-Container-Sync-To (Optional) | header | string | not supported |
| Date | header | string | Response time of the request (UTC) |
| X-Trans-Id | header | string | Transaction ID of the request |
| X-Openstack-Request-Id | header | string | Transaction ID of the request (same as X-Trans-Id) |
| Content-Type (Optional) | header | string | MIME type of the response result |
| X-Versions-Location (Optional) | header | string | not supported |
| X-History-Location (Optional) | header | string | not supported |
Examples
Request examples (container, metadata views)
curl -i -X HEAD -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}
Response examples
HTTP/1.1 204 No Content
Content-Length: 0
X-Container-Object-Count: 3
X-Timestamp: 1536631895.01856
Accept-Ranges: bytes
Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used: 630036
Content-Type: text/plain; charset=utf-8
X-Trans-Id: tx51f8478e8e924403851a4-005b988014
X-Openstack-Request-Id: tx51f8478e8e924403851a4-005b988014
Date: Wed, 12 Sep 2018 02:55:16 GMT
Upon successful request, it responds to No Content (204) status code.
Was this article helpful?