ListObjects
- Print
- PDF
ListObjects
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
Overview
Gets objects by making a GET request to the bucket. Up to 1000 objects can be returned at a time, in any order.
If a StorageClass operation is not implemented in NAVER Cloud Platform’s Object Storage, the StorageClass value returned in the response code is the default value.
No header or payload is used for the operation.
Request
Syntax
GET https://{endpoint}/{bucket-name} # path style
GET https://{bucket-name}.{endpoint} # virtual host style
Parameters
Parameter Name | Required | Type | Restrictions | Description |
---|---|---|---|---|
prefix | No | string | Restricts it to respond only to object names beginning with prefix. | |
delimiter | No | string | Toggles objects between prefix and delimiter. | |
encoding-type | No | string | If Unicode characters not supported by XML are used in the object name, you can resolve the encoding problem by setting the parameter to url. | |
max-keys | No | string | Min: 0 Max: 1000 | Limits the number of objects to display in the response. The default and maximum value is 1,000. |
marker | No | string | Specifies the object from where the list should start in UTF-8 binary order. |
Examples
Request example
The following request gets objects in the bucket with the name of “apiary.”
GET /apiary HTTP/1.1
Content-Type: text/plain
Host: kr.object.ncloudstorage.com
X-Amz-Date: 20160822T225156Z
Authorization: {authorization-string}
Response example
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>
Was this article helpful?