ListObjectsV2

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

개요

버킷으로 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
fetch-owner	No	boolean	true, false	소유자 필드는 기본적으로 "version 2" 메서드에는 없음 소유자 필드를 반환하려면 true로 설정
start-after	No	string		UTF-8 바이너리 순서로 목록이 시작되어야 하는 위치부터 오브젝트 지정
continuation-token	No	string		토큰으로 다음 오브젝트 목록을 조회할 수 있음

예시

요청 예시

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

GET /apiary?list-type=2 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></Prefix>
  <NextContinuationToken>1a8jKPiaWXb4OhJOLGR9KE495oNwIO1KbsTYDLDvtMArEbHtv8h-NKvDagEgx5nJYDx3X4G7r2bDBBMsD9bZN88ECyHcMDZI_HuE-kq5RiM9I_v2ocKx5h7K9QBXV_0NUCWj0EGYwoBOxyJUyhrrbTRN3swqI9xgmavCCZ2IziP8</NextContinuationToken>
  <KeyCount>1000</KeyCount>
  <MaxKeys>1000</MaxKeys>
  <Delimiter></Delimiter>
  <IsTruncated>true</IsTruncated>
  <Contents>
    <Key>drone-bee</Key>
    <LastModified>2016-08-25T17:38:38.549Z</LastModified>
    <ETag>"0cbc6611f5540bd0809a388dc95a615b"</ETag>
    <Size>4</Size>
    <StorageClass>Standard</StorageClass>
  </Contents>
  <Contents>
     <Key>soldier-bee</Key>
    <LastModified>2016-08-25T17:49:06.006Z</LastModified>
    <ETag>"37d4c94839ee181a2224d6242176c4b5"</ETag>
    <Size>11</Size>
    <StorageClass>Standard</StorageClass>
  </Contents>
  <Contents>
    <Key>worker-bee</Key>
    <LastModified>2016-08-25T17:46:53.288Z</LastModified>
    <ETag>"d34d8aada2996fc42e6948b926513907"</ETag>
    <Size>467</Size>
    <StorageClass>Standard</StorageClass>
  </Contents>
</ListBucketResult>

이 문서가 도움이 되었습니까?

What's Next

HeadBucket

개요
구문
파라미터(선택사항)
예시