---
title: "list"
slug: "cli-archivestorage-list"
updated: 2026-09-17T09:16:11Z
published: 2026-09-17T09:16:11Z
canonical: "cli.ncloud-docs.com/cli-archivestorage-list"
---

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

# list

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

어카운트의 컨테이너(버킷) 목록 또는 컨테이너의 오브젝트 목록을 조회합니다.

참고

서브 계정은 어카운트의 컨테이너 목록을 조회하는 `swift list` 명령을 사용할 수 없습니다.

## 구문

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

- 어카운트(컨테이너 목록 조회)

```
swift list \
    [--long] \
    [--lh] \
    [--totals] \
    [--prefix <prefix>] \
    [--json] \
    [--header <header:value>]
```
- 컨테이너(오브젝트 목록 조회)

```
swift list \
    <container> \
    [--long] \
    [--lh] \
    [--totals] \
    [--prefix <prefix>] \
    [--delimiter <delimiter>] \
    [--json] \
    [--header <header:value>]
```

## 옵션

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

### 필수 옵션

`list`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--long` | Boolean | Conditional | `ls -l` 형식의 상세 목록 출력 - `--totals` 입력 시 `--long`, `--lh` 중 하나는 필수 입력 |
| `--lh` | Boolean | Conditional | 크기를 읽기 쉬운 단위로 표시 - `--totals` 입력 시 `--long`, `--lh` 중 하나는 필수 입력 |

### 선택 옵션

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

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `&lt;container&gt;` | String | Optional | 컨테이너 이름 - 미입력 시 어카운트의 컨테이너 목록 조회 |
| `--totals` | Boolean | Optional | 합계만 출력 - `--long` 또는 `--lh`와 함께 사용 |
| `--prefix` | String | Optional | 지정한 접두사로 시작하는 항목만 조회 |
| `--delimiter` | String | Optional | 지정한 구분자를 기준으로 항목을 묶어서 출력 |
| `--json` | Boolean | Optional | 목록 정보를 JSON 형식으로 출력 |
| `--header` | String | Optional | 목록 조회 요청에 사용할 사용자 정의 헤더 - `header:value` 형식으로 입력 |

### 공통 옵션

`swift` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Archive Storage 옵션](/docs/guide-archivestorage#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

명령을 실행하면 컨테이너 이름 또는 오브젝트 이름이 출력됩니다. 옵션에 따라 크기, 최종 수정 일시 등 상세 정보가 함께 출력됩니다.

### 명령

어카운트의 컨테이너 목록을 조회하는 명령 예시는 다음과 같습니다.

```
swift list
```

컨테이너의 오브젝트 목록을 상세 형식으로 조회하는 명령 예시는 다음과 같습니다.

```
swift list test-container-01 --long --lh
```

합계만 조회하는 명령 예시는 다음과 같습니다.

```
swift list test-container-01 --long --lh --totals
```

JSON 형식으로 조회하는 명령 예시는 다음과 같습니다.

```
swift list test-container-01 --json
```

### 출력

어카운트의 컨테이너 목록을 조회하는 출력 예시는 다음과 같습니다.

```
test-container-01
test-segments-01
```

상세 형식으로 조회하면 마지막 줄에 전체 크기 합계가 출력됩니다. 오브젝트 목록을 상세 형식으로 조회하는 출력 예시는 다음과 같습니다.

```
        5.0M 2026-08-19 01:53:39 application/octet-stream large.bin
          54 2026-08-19 01:53:40               text/plain renamed.txt
          54 2026-08-19 01:53:19               text/plain sample.txt
        5.0M
```

합계만 조회하는 출력 예시는 다음과 같습니다.

```
5.0M
```

JSON 형식으로 조회하는 출력 예시는 다음과 같습니다.

```
[
  {
    "bytes": 5242880,
    "content_type": "application/octet-stream",
    "hash": "8f0e1b84bfafca589762d5b0dd4f1286",
    "last_modified": "2026-08-19T01:53:39.919390",
    "name": "large.bin",
    "slo_etag": "\"207cfeb70ee1769505fcfc717e3f8be0\""
  },
  {
    "bytes": 54,
    "content_type": "text/plain",
    "hash": "448575206ef0bb80c79087a7e85c1f5c",
    "last_modified": "2026-08-19T01:53:40.342020",
    "name": "renamed.txt"
  }
]
```