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

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

# ls

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

## 구문

`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.fin-ncloudstorage.com
```

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

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

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

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

### 출력

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

```
2026-09-08 11:47:26 my-backup-bucket
2026-09-08 11:47:10 my-docs-bucket
2026-09-08 11:43:08 my-temp-bucket
2026-08-06 14:10:13 my-test-bucket
```

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

```
                           PRE docs/
                           PRE images/
2026-09-08 13:34:33  104857600 large.bin
2026-09-08 13:35:07         22 note.txt
2026-09-08 13:11:13         21 sample.txt
```

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

```
2026-09-08 13:32:32    1.9 MiB images/IMG-01.png
2026-09-08 13:34:33  100.0 MiB large.bin
2026-09-08 13:35:07   22 Bytes note.txt
2026-09-08 13:11:13   21 Bytes sample.txt

Total Objects: 5
   Total Size: 101.9 MiB
```