GetContainerList
- 印刷する
- PDF
GetContainerList
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。
概要
コンテナ(バケット)リストを照会します。
構文
GET https://{endpoint}/swift/v1
リクエスト
リクエストヘッダ
| ヘッダ名 | 説明 |
|---|---|
| x-ncp-apigw-timestamp | - 1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表したもの - APIGWサーバとの時間差が5分以上の場合は無効なリクエストとみなす |
| x-ncp-iam-access-key | NAVERクラウドプラットフォームで発行された API Keyまたは Sub Accountで発行された AccessKey |
| x-ncp-apigw-signature-v2 | - 上記例の Bodyを AccessKeyとマッピングする SecretKeyで暗号化した署名 - HMAC暗号化アルゴリズムは HmacSHA256を使用 |
| x-ncp-region_code | 他のクラウドから NAVERクラウドに移行させるデータのバケットが存在する region code |
リクエストパラメータ
| パラメータ名 | 要否 | タイプ | 制約事項 | 説明 |
|---|---|---|---|---|
| limit (Optional) | - | integer | - | 呼び出し結果の最大数制限 |
| marker (Optional) | - | string | - | 特定コンテナ以降のリストをインポートする |
| end_marker (Optional) | - | string | - | 特定コンテナ以前のリストをインポートする |
| prefix (Optional) | - | string | - | 該当文字列で始まるコンテナリストを呼び出す |
| reverse (Optional) | - | string | - | コンテナ名でソートしリストを出力 default : false (descending) |
レスポンス
レスポンスヘッダ
| 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) |
| hash | header | string | 該当オブジェクトの MD5チェックサム値 |
| content_type | header | string | 該当オブジェクトタイプ |
レスポンスボディ
| Name | In | Type | Description |
|---|---|---|---|
| name | body | string | 該当オブジェクト名 |
| count | body | integer | 該当オブジェクト数 |
| bytes | body | integer | 該当オブジェクトのサイズ(bytes) |
| last_modified | body | string | 該当オブジェクトが最後に変更された時刻(UTC) |
例
リクエスト例(JSON)
curl -X GET "https://archivestorage.apigw.ntruss.com/swift/v1/?limit=1&marker=test" -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-Account-Bytes-Used: 786133
X-Account-Container-Count: 6
X-Account-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
[
{
"name": "test",
"count": 0,
"bytes": 0,
"last_modified": "2022-04-20T01:10:10.123456"
}
]
この記事は役に立ちましたか?