ls

Classic/VPC 환경에서 이용 가능합니다.

버킷이나 폴더, 객체 목록을 조회합니다.

구문

ls 구문은 다음과 같습니다.

aws s3 ls \
    [<s3-uri>] \
    [--recursive] \
    [--page-size <page-size>] \
    [--human-readable] \
    [--summarize] \
    --endpoint-url <endpoint-url>

옵션

ls 실행 시 지정할 수 있는 옵션을 설명합니다.

선택 옵션

ls의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`<s3-uri>`	String	Optional	버킷 또는 경로의 S3 URI `s3://{bucket_name}[/{prefix}]` 형식으로 입력 미입력 시 계정이 소유한 전체 버킷 조회
`--recursive`	Boolean	Optional	지정한 경로의 하위 Prefix까지 조회
`--page-size`	Integer	Optional	페이지당 항목 수 `1`~`1000`
`--human-readable`	Boolean	Optional	객체 크기를 Bytes, KiB, MiB, GiB 등 읽기 쉬운 단위로 표시
`--summarize`	Boolean	Optional	조회 결과의 총 객체 개수와 전체 크기 표시

공통 옵션

aws 명령에서 공통으로 사용하는 옵션에 대한 정보는 Object Storage 옵션을 참조해 주십시오.

예시

목록 조회 요청이 성공하면 버킷 이름 또는 객체의 최종 수정 일시, 크기, 이름이 출력됩니다.

명령

계정이 소유한 전체 버킷 목록을 조회하는 명령 예시는 다음과 같습니다.

aws s3 ls \
    --endpoint-url=https://kr.object.ncloudstorage.com

버킷의 객체 목록을 조회하는 명령 예시는 다음과 같습니다.

aws s3 ls s3://my-test-bucket \
    --endpoint-url=https://kr.object.ncloudstorage.com

버킷의 객체 총 개수와 크기를 조회하는 명령 예시는 다음과 같습니다.

aws s3 ls s3://my-test-bucket \
    --recursive \
    --human-readable \
    --summarize \
    --endpoint-url=https://kr.object.ncloudstorage.com

출력

계정이 소유한 전체 버킷 목록을 조회하는 출력 예시는 다음과 같습니다.

2026-04-28 10:31:27 my-docs-bucket
2026-09-02 14:30:20 my-backup-bucket
2026-08-19 11:36:46 my-test-bucket

버킷의 객체 목록을 조회하는 출력 예시는 다음과 같습니다.

                           PRE docs/
                           PRE img/
2026-09-02 15:41:01    5242880 large.bin
2026-09-02 14:33:24         24 notes.txt
2026-09-02 14:33:23         46 sample.txt

버킷의 객체 총 개수와 크기를 조회하는 출력 예시는 다음과 같습니다.

2026-09-02 14:33:23   41 Bytes docs/report.txt
2026-09-02 15:39:50   70 Bytes img/image.png
2026-09-02 15:41:01    5.0 MiB large.bin
2026-09-02 14:33:24   24 Bytes notes.txt
2026-09-02 14:33:23   46 Bytes sample.txt

Total Objects: 5
   Total Size: 5.0 MiB