--- title: "list-object-versions" slug: "list-object-versions" updated: 2026-10-30T05:44:21Z published: 2026-10-30T09:00:04Z canonical: "cli.ncloud-docs.com/list-object-versions" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # list-object-versions Classic/VPC 환경에서 이용 가능합니다. Ncloud Storage 버킷에 저장한 객체의 버전 목록과 메타데이터를 조회합니다. 참고 Sub Account 사용자가 이 명령을 실행하려면 View/ListBucketVersions 액션 권한이 필요합니다. ## 구문 `list-object-versions` 구문은 다음과 같습니다. ``` aws s3api list-object-versions \ --bucket \ [--prefix ] \ [--optional-object-attributes ] \ [--starting-token ] \ [--page-size ] \ [--max-items ] \ --endpoint-url ``` ## 옵션 `list-object-versions` 실행 시 지정할 수 있는 옵션을 설명합니다. ### 필수 옵션 `list-object-versions`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--bucket` | String | Required | 버킷 이름 | ### 선택 옵션 `list-object-versions`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--prefix` | String | Optional | 조회할 Prefix | | `--optional-object-attributes` | String | Optional | 응답에 추가로 포함할 객체 속성 - `RestoreStatus`: 객체 복원 상태 - 출력의 `Versions` 목록 중 복원을 요청한 Deep Archive Class 객체 버전에 `RestoreStatus` 필드가 반환됨 - `IsRestoreInProgress`: 복원 진행 여부 (`true`: 복원 중, `false`: 복원 완료) - `RestoreExpiryDate`: 복원 만료 시간 (복원이 완료된 경우에만 반환) - 복원본이 삭제되면 반환되지 않음 - 객체 복원은 [restore-object](/docs/restore-object) 참조 | | `--starting-token` | String | Optional | 조회를 시작할 위치 | | `--page-size` | Integer | Optional | 페이지당 항목 수 - `1`~`1000` | | `--max-items` | Integer | Optional | 출력에 포함할 총 항목 수 | ### 공통 옵션 `aws` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Ncloud Storage 옵션](/docs/storage-ncloudstorage#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 객체 버전 조회 요청이 성공하면 각 버전의 식별 정보와 최신 버전 여부가 반환됩니다. ### 명령 명령 예시는 다음과 같습니다. ``` aws s3api list-object-versions --bucket my-test-bucket \ --endpoint-url=https://kr.ncloudstorage.com ``` ### 출력 출력 예시는 다음과 같습니다. ``` { "Versions": [ { "ETag": "\"0625bd26765357783b665dab605fdc7c\"", "ChecksumAlgorithm": [ "CRC32" ], "ChecksumType": "FULL_OBJECT", "Size": 20, "StorageClass": "STANDARD", "Key": "img/copy.png", "VersionId": "11111111-2222-3333-4444-555555555553", "IsLatest": true, "LastModified": "2026-08-19T02:49:44Z" }, { "ETag": "\"0625bd26765357783b665dab605fdc7c\"", "ChecksumAlgorithm": [ "CRC32" ], "ChecksumType": "FULL_OBJECT", "Size": 20, "StorageClass": "STANDARD", "Key": "img/image.png", "VersionId": "11111111-2222-3333-4444-555555555551", "IsLatest": true, "LastModified": "2026-08-19T02:49:43Z" }, { "ETag": "\"0625bd26765357783b665dab605fdc7c\"", "ChecksumAlgorithm": [ "CRC32" ], "ChecksumType": "FULL_OBJECT", "Size": 20, "StorageClass": "DEEP_ARCHIVE", "Key": "img/image2.png", "VersionId": "11111111-2222-3333-4444-555555555552", "IsLatest": true, "LastModified": "2026-08-19T02:49:44Z" }, { "ETag": "\"85641ff9e82a40a643bc74450bc8999f\"", "ChecksumAlgorithm": [ "CRC32" ], "ChecksumType": "FULL_OBJECT", "Size": 48, "StorageClass": "STANDARD", "Key": "sample.txt", "VersionId": "null", "IsLatest": true, "LastModified": "2026-08-19T02:44:28Z" } ], "RequestCharged": null, "Prefix": "" } ``` ## 연관 명령어 연관 명령어는 다음과 같습니다. - [list-objects-v2](/docs/list-objects-v2) - [get-object](/docs/get-object) - [put-object](/docs/put-object) - [delete-object](/docs/delete-object)