---
title: "ls"
slug: "cli-objectstorage-high-level-ls"
updated: 2026-09-17T09:16:11Z
published: 2026-09-17T09:16:11Z
canonical: "cli.ncloud-docs.com/cli-objectstorage-high-level-ls"
---

> ## 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.

# ls

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

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

## 구문

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

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

## 옵션

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

### 선택 옵션

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

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `&lt;s3-uri&gt;` | 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 옵션](/docs/guide-objectstorage#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

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

### 명령

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

```
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
```