ListObjects
- 印刷する
- PDF
ListObjects
- 印刷する
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。
概要
バケットにGETリクエストを送ると、オブジェクトリストを返却します。この場合、一度に返却されるオブジェクトの個数は1,000個に制限されるし、任意の順番に返却されます。
ストレージクラスオペレーションがNCPのオブジェクトストレージに実装されてない場合はレスポンスコードで返却されたStorageClassの値は基本値です。
オペレーションに使われるヘッダ、ペイロードはありません。
リクエスト
構文
GET https://{endpoint}/{bucket-name} # path style
GET https://{bucket-name}.{endpoint} # virtual host style
パラメータ
パラメータ名 | 必須 | タイプ | 制約事項 | 説明 |
---|---|---|---|---|
prefix | No | string | prefixではじまるオブジェクト名のみにレスポンスするように制限します。 | |
delimiter | No | string | prefixとdelimiterの間にあるオブジェクトを一つに統合します。 | |
encoding-type | No | string | XMLでサポートしないユニコード文字がオブジェクト名に使われた場合、パラメータをurlに設定するとエンコーディング問題を解決できます。 | |
max-keys | No | string | Min: 0 Max: 1000 | レスポンスに表示するオブジェクト個数を制限します。基本値であり、最大値は1,000です。 |
marker | No | string | UTF-8バイナリ順番でリストがはじまるべきの位置からオブジェクトを指定します。 |
例示
リクエスト例示
次は名称が'apiary'であるバケットに属するオブジェクト照会をリクエストする例です。
GET /apiary HTTP/1.1
Content-Type: text/plain
Host: kr.object.ncloudstorage.com
X-Amz-Date: 20160822T225156Z
Authorization: {authorization-string}
レスポンス例示
HTTP/1.1 200 OK
Date: Wed, 24 Aug 2016 17:36:24 GMT
Accept-Ranges: bytes
x-amz-request-id: 9f39ff2e-55d1-461b-a6f1-2d0b75138861
Content-Type: application/xml
Content-Length: 909
<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Name>apiary</Name>
<Prefix/>
<Marker/>
<MaxKeys>1000</MaxKeys>
<Delimiter/>
<IsTruncated>false</IsTruncated>
<Contents>
<Key>drone-bee</Key>
<LastModified>2016-08-25T17:38:38.549Z</LastModified>
<ETag>"0cbc6611f5540bd0809a388dc95a615b"</ETag>
<Size>4</Size>
<Owner>
<ID>{account-id}</ID>
<DisplayName>{account-id}</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Contents>
<Contents>
<Key>soldier-bee</Key>
<LastModified>2016-08-25T17:49:06.006Z</LastModified>
<ETag>"37d4c94839ee181a2224d6242176c4b5"</ETag>
<Size>11</Size>
<Owner>
<ID>{account-id}</ID>
<DisplayName>{account-id}</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Contents>
<Contents>
<Key>worker-bee</Key>
<LastModified>2016-08-25T17:46:53.288Z</LastModified>
<ETag>"d34d8aada2996fc42e6948b926513907"</ETag>
<Size>467</Size>
<Owner>
<ID>{account-id}</ID>
<DisplayName>{account-id}</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
</Contents>
</ListBucketResult>
この記事は役に立ちましたか?