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 명령에서 공통으로 사용하는 옵션에 대한 정보는 Ncloud Storage 옵션을 참조해 주십시오.

예시

목록 조회 요청이 성공하면 버킷의 생성 일시와 이름 또는 각 객체의 최종 수정 일시, 크기, 이름이 출력됩니다. 하위 Prefix는 PRE {prefix}/ 형식으로 표시됩니다.

명령

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

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

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

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

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

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

출력

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

2026-08-21 14:06:10 my-encrypted-bucket
2026-08-19 11:57:28 my-locked-bucket
2026-08-21 14:06:07 my-sync-bucket
2026-08-19 11:44:27 my-test-bucket

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

PRE img/
2026-08-19 11:56:40   12582912 large.bin
2026-08-19 11:44:28         48 sample.txt

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

2026-08-19 11:49:44   20 Bytes img/copy.png
2026-08-19 11:49:43   20 Bytes img/image.png
2026-08-19 11:49:44   20 Bytes img/image2.png
2026-08-19 11:56:40   12.0 MiB large.bin
2026-08-19 11:44:28   48 Bytes sample.txt

Total Objects: 5
   Total Size: 12.0 MiB