HeadContainer
- 印刷する
- PDF
HeadContainer
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
概要
コンテナ(バケット)のメタデータを照会します。
注意
Subaccountの場合、Subaccount専用 External API Gatewayを通じて使用できます。
詳細は、Subaccountをご参照ください。
構文
HEAD /v1/AUTH_{project_id}/{container}
リクエスト
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | プロジェクト IDを入力 |
container | path | string | - 紹介するコンテナ(バケット)名入力 - slash(/)が含まれると、{container}/{object}と認識するので注意 |
X-Auth-Token (Optional) | header | string | 発行した Token値を入力 |
X-Newest (Optional) | header | boolean | - trueの場合すべてのコピーについてクエリし、直近コピーの情報でレスポンス - 該当ヘッダが省略された場合最もスピーディーな情報でレスポンス |
レスポンス
Name | In | Type | Description |
---|---|---|---|
X-Container-Meta-name | header | string | - 該当コンテナ(バケット)のメタデータ - ヘッダ名の name 部分がメタデータのキーロールを果たす |
Content-Length | header | string | レスポンス結果の長さ(Bytes) |
X-Container-Object-Count | header | integer | 該当コンテナ(バケット)のオブジェクト数 |
X-Container-Bytes-Used | header | integer | 該当コンテナ(バケット)が使用する全体容量のサイズ(Bytes) |
X-Container-Read (Optional) | header | string | 該当コンテナの READ ACL |
X-Container-Write (Optional) | header | string | 該当コンテナの WRITE ACL |
X-Container-Meta-Quota-Bytes (Optional) | header | string | 該当コンテナ(バケット)の容量制限値(bytes) |
X-Container-Meta-Quota-Count (Optional) | header | string | 該当コンテナ(バケット)のオブジェクト数の制限値 |
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 | temporary URLのための Secret Key値 |
X-Container-Meta-Temp-URL-Key-2 (Optional) | header | string | temporary URLのための2番目の Secret Key値 |
X-Timestamp | header | integer | 該当コンテナ(バケット)が作成された時刻(UNIX Time) |
X-Container-Sync-Key (Optional) | header | string | not supported |
X-Container-Sync-To (Optional) | header | string | not supported |
Date | header | string | 該当リクエストのレスポンス時間(UTC) |
X-Trans-Id | header | string | 該当リクエストのトランザクション ID |
X-Openstack-Request-Id | header | string | 該当リクエストのトランザクション ID(X-Trans-Idと同じ) |
Content-Type (Optional) | header | string | レスポンス結果の MIMEタイプ |
X-Versions-Location (Optional) | header | string | not supported |
X-History-Location (Optional) | header | string | not supported |
例
リクエスト例(コンテナメタデータの照会)
curl -i -X HEAD -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}
レスポンス例
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
リクエストが成功すると、No Content(204)の状態コードを返します。
この記事は役に立ちましたか?