GetContainer
- 印刷する
- PDF
GetContainer
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。
概要
コンテナ(バケット)に属するオブジェクトリストとコンテナ(バケット)のメタデータを照会します。
構文
GET /v1/AUTH_{project_id}/{container}
リクエスト
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | プロジェクトIDを入力します。 |
container | path | string | コンテナ名を入力します。 |
limit (Optional) | query | integer | 呼び出し結果の最大個数を制限します。 |
marker (Optional) | query | string | 特定オブジェクト以降のリストを取得します。 |
end_marker (Optional) | query | string | 特定オブジェクト以前のリストを取得します。 |
prefix (Optional) | query | string | 該当文字列ではじまるオブジェクトリストを呼び出します。 |
format (Optional) | query | string | 呼び出し結果のフォーマットを指定します。(json, xml, plain) |
delimiter (Optional) | query | string | 該当をセパレーターとして使い、オブジェクトリストを階層構造で表現できます。 |
path (Optional) | query | string | 該当パス内部のオブジェクトリストを表示します。pathオプションよりprefix/delimiterオプションをお勧めします。 |
X-Auth-Token (Optional) | header | string | 発行したToken値を入力します。 |
X-Newest (Optional) | header | boolean | trueの場合、すべてのコピー本に対して問合せを行い、一番最近のコピー本情報でレスポンスします。該当ヘッダが省略された場合、一番レスポンスが早い情報でレスポンスします。 |
Accept (Optional) | header | string | 呼び出し結果のフォーマットを指定します。(application/json, application/xml, text/xml) |
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値を入力します。 |
レスポンス
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 | string | 該当コンテナ(バケット)のstorage policy値です。 |
X-Container-Read (Optional) | header | string | 該当コンテナ(バケット)のREAD ACLです。 |
X-Container-Write (Optional) | header | string | 該当コンテナ(バケット)のWRITE ACLです。 |
X-Container-Sync-Key (Optional) | header | string | not supported |
X-Container-Sync-To (Optional) | header | string | not supported |
X-Versions-Location (Optional) | header | string | not supported |
X-History-Location (Optional) | header | string | not supported |
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) |
hash | body | string | 該当オブジェクトのMD5チェックサム値です。 |
last_modified | body | string | 該当オブジェクトが最後に変更された時刻です。 (UTC) |
content_type | body | string | 該当オブジェクトのタイプです。 |
bytes | body | integer | 該当オブジェクトのサイズです。 (bytes) |
name | body | string | 該当オブジェクトの名称です。 |
例示
リクエスト例示(JSON)
curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=json
レスポンス例示
HTTP/1.1 200 OK
Content-Length: 352
X-Container-Object-Count: 2
X-Timestamp: 1536631895.01856
Accept-Ranges: bytes
X-Storage-Policy: standard01
Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used: 420024
Content-Type: application/json; charset=utf-8
X-Trans-Id: tx6bb706abe32b4ae5a49e8-005b978263
X-Openstack-Request-Id: tx6bb706abe32b4ae5a49e8-005b978263
Date: Tue, 11 Sep 2018 08:52:51 GMT
[
{
"hash":"9bd5b4f25faf491080654a34d57c3636",
"last_modified":"2018-09-11T02:12:29.991410",
"bytes":210012,
"name":"ncloud-test-object-0.txt",
"content_type":"text/plain"
},
{
"hash":"9bd5b4f25faf491080654a34d57c3636",
"last_modified":"2018-09-11T02:12:29.992600",
"bytes":210012,
"name":"ncloud-test-object-1.txt",
"content_type":"text/plain"
}
]
リクエスト例示(XML)
curl -i -X GET -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}?format=XML
レスポンス例示
HTTP/1.1 200 OK
Content-Length: 520
X-Container-Object-Count: 2
X-Timestamp: 1536631895.01856
Accept-Ranges: bytes
X-Storage-Policy: standard01
Last-Modified: Tue, 11 Sep 2018 02:11:36 GMT
X-Container-Bytes-Used: 420024
Content-Type: application/xml; charset=utf-8
X-Trans-Id: txfff4e8574d7e43f38b8e8-005b9782ef
X-Openstack-Request-Id: txfff4e8574d7e43f38b8e8-005b9782ef
Date: Tue, 11 Sep 2018 08:55:11 GMT
<?xml version="1.0" encoding="UTF-8"?>
<container name="ncloud-container-0">
</container>
リクエストが成功するとOK (200), No Content (204)ステータスコードをレスポンスします。
No Content (204)である場合はContent-Typeがplainであり、リクエストに該当される内容がない場合に発生します。
コンテナ(バケット)が存在しない場合は、Not Found (404)ステータスコードをレスポンスします。
この記事は役に立ちましたか?