2.4.7. S3 버킷 오브젝트 목록을 반환합니다.
버킷 개체 목록을 반환합니다.
구문
GET /BUCKET?max-keys=25 HTTP/1.1
Host: cname.domain.com
표 2.4. 매개 변수
이름 | 유형 | 설명 |
---|---|---|
| 문자열 | 지정된 접두사가 포함된 오브젝트만 반환합니다. |
| 문자열 | 접두사와 나머지 오브젝트 이름 간의 구분 기호입니다. |
| 문자열 | 반환된 오브젝트 목록의 시작 인덱스입니다. |
| 정수 | 반환할 최대 키 수입니다. 기본값은 1000입니다. |
표 2.5. HTTP 응답
HTTP 상태 | 상태 코드 | 설명 |
---|---|---|
| OK | 검색된 버킷 |
GET /BUCKET
은 다음 필드가 있는 버킷에 대한 컨테이너를 반환합니다.
표 2.6. 버킷 응답 엔티티
이름 | 유형 | 설명 |
---|---|---|
| 엔터티 | 오브젝트 목록의 컨테이너입니다. |
| 문자열 | 콘텐츠가 반환될 버킷의 이름입니다. |
| 문자열 | 오브젝트 키의 접두사입니다. |
| 문자열 | 반환된 오브젝트 목록의 시작 인덱스입니다. |
| 정수 | 반환된 최대 키 수입니다. |
| 문자열 |
설정한 경우 접두사가 동일한 오브젝트가 |
| 부울 |
|
| 컨테이너 | 여러 오브젝트에 동일한 접두사가 포함된 경우 이 목록에 표시됩니다. |
ListBucketResult
에는 각 오브젝트가 콘텐츠
컨테이너 내에 있는 오브젝트가 포함되어 있습니다.
표 2.7. 오브젝트 응답 엔티티
이름 | 유형 | 설명 |
---|---|---|
| 개체 | 오브젝트의 컨테이너입니다. |
| 문자열 | 오브젝트의 키입니다. |
| 날짜 | 오브젝트의 마지막 업데이트 날짜/시간입니다. |
| 문자열 | 오브젝트의 MD-5 해시. (entity 태그) |
| 정수 | 오브젝트의 크기입니다. |
| 문자열 |
항상 |