2.4.7. S3 버킷 오브젝트 목록을 반환합니다.

버킷 개체 목록을 반환합니다.

구문

GET /BUCKET?max-keys=25 HTTP/1.1
Host: cname.domain.com

표 2.4. 매개 변수

이름유형설명

접두사

문자열

지정된 접두사가 포함된 오브젝트만 반환합니다.

delimiter

문자열

접두사와 나머지 오브젝트 이름 간의 구분 기호입니다.

marker

문자열

반환된 오브젝트 목록의 시작 인덱스입니다.

max-keys

정수

반환할 최대 키 수입니다. 기본값은 1000입니다.

표 2.5. HTTP 응답

HTTP 상태상태 코드설명

200

OK

검색된 버킷

GET /BUCKET 은 다음 필드가 있는 버킷에 대한 컨테이너를 반환합니다.

표 2.6. 버킷 응답 엔티티

이름유형설명

ListBucketResult

엔터티

오브젝트 목록의 컨테이너입니다.

이름

문자열

콘텐츠가 반환될 버킷의 이름입니다.

접두사

문자열

오브젝트 키의 접두사입니다.

마커

문자열

반환된 오브젝트 목록의 시작 인덱스입니다.

MaxKeys

정수

반환된 최대 키 수입니다.

구분자

문자열

설정한 경우 접두사가 동일한 오브젝트가 CommonPrefixes 목록에 표시됩니다.

IsTruncated

부울

true 인 경우 버킷 콘텐츠 서브 세트만 반환됩니다.

CommonPrefixes

컨테이너

여러 오브젝트에 동일한 접두사가 포함된 경우 이 목록에 표시됩니다.

ListBucketResult 에는 각 오브젝트가 콘텐츠 컨테이너 내에 있는 오브젝트가 포함되어 있습니다.

표 2.7. 오브젝트 응답 엔티티

이름유형설명

내용

개체

오브젝트의 컨테이너입니다.

문자열

오브젝트의 키입니다.

LastModified

날짜

오브젝트의 마지막 업데이트 날짜/시간입니다.

etag

문자열

오브젝트의 MD-5 해시. (entity 태그)

크기

정수

오브젝트의 크기입니다.

StorageClass

문자열

항상 STANDARD 를 반환해야 합니다.