HeadContainer
- 印刷する
- PDF
HeadContainer
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。
概要
コンテナ(バケット)のメタデータを照会します。
構文
HEAD https://{endpoint}/swift/v1/{containerName}
リクエスト
リクエストヘッダ
| ヘッダ名 | 説明 |
|---|---|
| x-ncp-apigw-timestamp | 1970年1月1日 00:00:00 協定世界時(UTC)からの経過時間をミリセカンド(Millisecond)で表したものです。 API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとしてみなす。 |
| x-ncp-iam-access-key | Naverクラウドプラットフォームから発行してもらったAPI Key、またはIAMから発行してもらったAccessKey |
| x-ncp-apigw-signature-v2 | 上記の例題のBodyをAccessKeyとマッピングされるSecretKeyで暗号化した署名 HMAC暗号化のアルゴリズムはHmacSHA256を使用 |
| x-ncp-region_code | 他のクラウドからNAVERクラウドに移行させるデータのバケットが存在するregion code |
リクエストパラメータ
| パラメータ名 | 必須の有無 | タイプ | 制約事項 | 説明 |
|---|---|---|---|---|
| ContainerName | - | string | - | 照会するコンテナ名 |
レスポンス
レスポンスヘッダ
| 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-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-Container-Meta-Quota-Count (Optional) | header | string | 当該コンテナ(バケット)のオブジェクト数の制限値 |
| X-Container-Meta-Quota-Bytes (Optional) | header | string | 当該コンテナ(バケット)の容量制限値 |
| X-Storage-Policy (Optional) | header | integer | 当該コンテナ(バケット)のstorage policy値 |
| X-Container-Read (Optional) | header | integer | 当該コンテナ(バケット)のREAD ACL |
| X-Container-Write (Optional) | header | integer | 当該コンテナ(バケット)のWRITE ACL |
| X-Timestamp | header | integer | 当該コンテナ(バケット)が作成された時刻(UNIX Time) |
| X-Trans-Id | header | string | 当該リクエストのトランザクションID |
| X-Openstack-Request-Id | header | string | 当該リクエストのトランザクションID(X-Trans-Idと同じ) |
| Content-Type | header | string | レスポンス結果のフォーマット |
| Date | header | string | 当該リクエストのレスポンス時間(UTC) |
例
リクエスト例(JSON)
curl -X HEAD "https://archivestorage.apigw.ntruss.com/swift/v1/{containerName}" -H "accept: application/json" -H "x-ncp-region-code: {regionCode}"
-H "x-ncp-iam-access-key: {AccessKey} "
-H "x-ncp-apigw-timestamp: {current timestamp}"
-H "x-ncp-apigw-signature-v2: {generated signature}"
レスポンス例
HTTP/1.1 200 OK
Accept: application/json
connection: keep-alive
Content-Length: 2577
Keep-alive: timeout=60
X-Container-Bytes-Used: 786133
X-Container-Object-Count: 1
X-Timestamp: 1634538594.09393
Content-Type: application/json; charset=utf-8
X-Trans-Id: tx274a77a8975c4a66aeb24-0052d95365
X-Openstack-Request-Id: tx274a77a8975c4a66aeb24-0052d95365
Date: Mon, 18 Apr 2022 11:07:18 GMT
要請に成功した場合、該当コンテナに対するメタデータが返却されます。
この記事は役に立ちましたか?