ListObjects

개요

버킷으로 GET 요청을 보내면 오브젝트 목록을 반환합니다. 이때 한 번에 반환되는 오브젝트 개수는 1,000개로 제한되고 임의의 순서로 반환됩니다.

스토리지 클래스 오퍼레이션이 NCP 오브젝트 스토리지에 구현되지 않았을 때는 응답 코드에서 반환된 StorageClass의 값은 기본값입니다.

오퍼레이션에 사용되는 헤더, 페이로드는 없습니다.

구문

GET https://{endpoint}/{bucket-name} # path style
GET https://{bucket-name}.{endpoint} # virtual host style

파라미터(선택사항)

예시

요청 예시

다음은 이름이 'apiary'인 버킷에 속한 오브젝트 조회를 요청하는 예입니다.

GET /apiary HTTP/1.1
Content-Type: text/plain
Host: kr.object.gov-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>