Classic/VPC 환경에서 이용 가능합니다.
Ncloud Storage 버킷 내 객체의 모든 버전에 대한 메타데이터를 조회합니다.
참고
버전 관리가 설정된 버킷에서만 사용 가능합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
메서드 | URI |
---|---|
GET | - |
요청 헤더
Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 요청 헤더를 참조해 주십시오.
요청 쿼리 파라미터
요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
versions |
Required | Required | 버전 메타데이터 조회 요청
|
key-marker |
String | Optional | 조회 시작 기준 (객체 이름)
|
version-id-marker |
String | Optional | 조회 시작 기준 (객체 버전 아이디)
|
max-keys |
String | Optional | 페이지당 항목 수
|
prefix |
String | Optional | 객체 이름 접두어 |
요청 예시
요청 예시는 다음과 같습니다.
GET /?versions&max-keys=1 HTTP/1.1
Host: bucket.kr.ncloudstorage.com
응답
응답 형식을 설명합니다.
응답 헤더
Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 응답 헤더를 참조해 주십시오.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
ListBucketResult |
Object | - | 버킷 목록 조회 결과 |
ListBucketResult.Name |
String | - | 버킷 이름 |
ListBucketResult.Prefix |
String | - | 버킷 이름 접두어
|
ListBucketResult.NextKeyMarker |
String | - | 다음 조회 기준 (객체 이름)
|
ListBucketResult.NextVersionIdMarker |
String | - | 다음 조회 기준 (객체 버전 아이디)
|
ListBucketResult.MaxKeys |
Integer | - | 페이지당 항목 수 |
ListBucketResult.IsTruncated |
Boolean | - | 이후 페이지 존재 여부
|
ListBucketResult.DeleteMarker |
Array | - | 객체 삭제 마커 정보 |
ListBucketResult.Version |
Array | - | 객체 버전 목록 |
Version
Version
에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
IsLatest |
Boolean | - | 최신 버전 여부
|
Key |
String | - | 객체 이름 |
LastModified |
String | - | 최종 수정 일시
|
ETag |
String | - | 객체 고유 식별자(Entity Tag) |
Size |
Integer | - | 객체 크기(Byte) |
StorageClass |
String | - | 스토리지 클래스
|
ChecksumAlgorithm |
String | - | 객체 체크섬 해시 알고리즘
|
ChecksumType |
String | - | 객체 체크섬 계산 유형
|
VersionId |
String | - | 객체 버전 아이디 |
DeleteMarker
DeleteMarker
에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
IsLatest |
Boolean | - | 최신 버전 여부
|
Key |
String | - | 객체 이름 |
LastModified |
String | - | 생성 일시
|
VersionId |
String | - | 삭제 마커 버전 아이디 |
응답 상태 코드
Ncloud Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud Storage 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult>
<Name>bucket</Name>
<Prefix></Prefix>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<DeleteMarker>
<IsLatest>true</IsLatest>
<Key>test.xlsx</Key>
<LastModified>2025-05-19T08:02:12Z</LastModified>
<VersionId>91f1fe7f-****-****-****-9cc2c468d112</VersionId>
</DeleteMarker>
<Version>
<IsLatest>false</IsLatest>
<Key>test.xlsx</Key>
<LastModified>2025-05-19T03:06:04Z</LastModified>
<ETag>"2dd************************4f6181"</ETag>
<Size>17423</Size>
<StorageClass>STANDARD</StorageClass>
<ChecksumAlgorithm>CRC64NVME</ChecksumAlgorithm>
<ChecksumType>FULL_OBJECT</ChecksumType>
<VersionId>null</VersionId>
</Version>
<Version>
<IsLatest>true</IsLatest>
<Key>object.csv</Key>
<LastModified>2025-05-19T05:55:33Z</LastModified>
<ETag>"db7**********************5c35"</ETag>
<Size>24</Size>
<StorageClass>STANDARD</StorageClass>
<ChecksumAlgorithm>CRC64NVME</ChecksumAlgorithm>
<ChecksumType>FULL_OBJECT</ChecksumType>
<VersionId>null</VersionId>
</Version>
<Version>
<IsLatest>true</IsLatest>
<Key>object.jpg</Key>
<LastModified>2025-05-19T05:56:39Z</LastModified>
<ETag>"a3f******************************23"</ETag>
<Size>2799</Size>
<StorageClass>STANDARD</StorageClass>
<ChecksumAlgorithm>CRC64NVME</ChecksumAlgorithm>
<ChecksumType>FULL_OBJECT</ChecksumType>
<VersionId>null</VersionId>
</Version>
</ListBucketResult>