--- title: "list-objects" slug: "cli-objectstorage-api-level-list-objects" updated: 2026-09-17T09:10:37Z published: 2026-09-17T09:10:37Z canonical: "cli-fin.ncloud-docs.com/cli-objectstorage-api-level-list-objects" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # list-objects 버킷에 저장된 객체의 목록을 조회합니다. ## 구문 `list-objects` 구문은 다음과 같습니다. ``` aws s3api list-objects \ --bucket \ [--delimiter ] \ [--prefix ] \ [--starting-token ] \ [--page-size ] \ [--max-items ] \ --endpoint-url ``` ## 옵션 `list-objects` 실행 시 지정할 수 있는 옵션을 설명합니다. ### 필수 옵션 `list-objects`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--bucket` | String | Required | 버킷 이름 | ### 선택 옵션 `list-objects`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--delimiter` | String | Optional | 객체를 묶기 위한 구분자 - Prefix와 Delimiter 사이에 있는 객체를 하나로 묶음 | | `--prefix` | String | Optional | 조회할 Prefix | | `--starting-token` | String | Optional | 조회를 시작할 위치 | | `--page-size` | Integer | Optional | 페이지당 항목 수 - `1`~`1000` | | `--max-items` | Integer | Optional | 출력에 포함할 총 항목 수 | ### 공통 옵션 `aws` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Object Storage 옵션](/docs/guide-objectstorage#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 객체 목록 조회 요청이 성공하면 각 객체의 식별 정보와 크기가 반환됩니다. ### 명령 명령 예시는 다음과 같습니다. ``` aws s3api list-objects --bucket my-test-bucket \ --endpoint-url=https://kr.object.fin-ncloudstorage.com ``` 접두사로 객체를 필터링하는 명령 예시는 다음과 같습니다. ``` aws s3api list-objects --bucket my-test-bucket \ --prefix docs/ \ --endpoint-url=https://kr.object.fin-ncloudstorage.com ``` 한 번에 조회할 개수를 제한하는 명령 예시는 다음과 같습니다. ``` aws s3api list-objects --bucket my-test-bucket \ --max-items 2 \ --page-size 2 \ --endpoint-url=https://kr.object.fin-ncloudstorage.com ``` 이전 응답의 `NextToken`으로 다음 페이지를 조회하는 명령 예시는 다음과 같습니다. ``` aws s3api list-objects --bucket my-test-bucket \ --max-items 2 \ --page-size 2 \ --starting-token eyJNYXJrZXIiOiAiZG9jcy9ub3RlLnR= \ --endpoint-url=https://kr.object.fin-ncloudstorage.com ``` ### 출력 출력 예시는 다음과 같습니다. ``` { "Contents": [ { "Key": "docs/large.bin", "LastModified": "2026-09-09T01:38:53.263Z", "ETag": "\"0c4af570340e15f2be9924e70bc34257-13\"", "Size": 104857600, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } }, { "Key": "docs/note.txt:Zone.Identifier", "LastModified": "2026-09-09T01:38:51.154Z", "ETag": "\"cfca1aacd7f6564a550d570b410e11d0\"", "Size": 25, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } }, { "Key": "docs/report.txt", "LastModified": "2026-09-09T01:38:51.154Z", "ETag": "\"317d635cf5b7e94fec06fc58e1b453bd\"", "Size": 22, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } }, { "Key": "images/IMG-01.png", "LastModified": "2026-09-09T01:38:51.186Z", "ETag": "\"270f326e5edcc8cf14bb0058909dfdfd\"", "Size": 1983317, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } }, { "Key": "large.bin", "LastModified": "2026-09-09T01:38:53.135Z", "ETag": "\"0c4af570340e15f2be9924e70bc34257-13\"", "Size": 104857600, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } }, { "Key": "note.txt", "LastModified": "2026-09-09T01:38:51.154Z", "ETag": "\"317d635cf5b7e94fec06fc58e1b453bd\"", "Size": 22, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } }, { "Key": "sample.txt", "LastModified": "2026-09-09T01:38:51.154Z", "ETag": "\"b1a69af9fca78ffacfba90c9562f4793\"", "Size": 21, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } } ] } ``` 접두사로 필터링한 출력 예시는 다음과 같습니다. ``` { "Contents": [ { "Key": "docs/large.bin", "LastModified": "2026-09-09T01:38:53.263Z", "ETag": "\"0c4af570340e15f2be9924e70bc34257-13\"", "Size": 104857600, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } }, { "Key": "docs/report.txt", "LastModified": "2026-09-09T01:38:51.154Z", "ETag": "\"317d635cf5b7e94fec06fc58e1b453bd\"", "Size": 22, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } } ] } ``` 한 번에 조회할 개수를 제한한 출력 예시는 다음과 같습니다. 다음 페이지가 있으면 `NextToken`이 함께 반환됩니다. ``` { "Contents": [ { "Key": "docs/large.bin", "LastModified": "2026-09-09T01:38:53.263Z", "ETag": "\"0c4af570340e15f2be9924e70bc34257-13\"", "Size": 104857600, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } }, { "Key": "docs/note.txt:Zone.Identifier", "LastModified": "2026-09-09T01:38:51.154Z", "ETag": "\"cfca1aacd7f6564a550d570b410e11d0\"", "Size": 25, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } } ], "NextToken": "eyJNYXJrZXIiOiAiZG9jcy9ub3RlLnR=" } ``` 다음 페이지를 조회한 출력 예시는 다음과 같습니다. ``` { "Contents": [ { "Key": "docs/report.txt", "LastModified": "2026-09-09T01:38:51.154Z", "ETag": "\"317d635cf5b7e94fec06fc58e1b453bd\"", "Size": 22, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } }, { "Key": "images/IMG-01.png", "LastModified": "2026-09-09T01:38:51.186Z", "ETag": "\"270f326e5edcc8cf14bb0058909dfdfd\"", "Size": 1983317, "StorageClass": "STANDARD", "Owner": { "DisplayName": "ncp-123456-0", "ID": "ncp-123456-0" } } ], "NextToken": "eyJNYXJrZXIiOiAiaW1hZ2VzL0lNRy0wM=" } ```