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 <delim>] \
    [--json] \
    [--header <header:value>]

옵션

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

필수 옵션

list의 필수 옵션입니다.

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

선택 옵션

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

옵션	타입	필수 여부	설명
`<container>`	String	Optional	컨테이너 이름 미입력 시 어카운트의 컨테이너 목록 조회
`--totals`	Boolean	Optional	합계만 출력 `--long` 또는 `--lh`와 함께 사용
`--prefix`	String	Optional	지정한 접두사로 시작하는 항목만 조회
`--delimiter`	String	Optional	지정한 구분자를 기준으로 항목을 묶어서 출력
`--json`	Boolean	Optional	목록 정보를 JSON 형식으로 출력
`--header`	String	Optional	목록 조회 요청에 사용할 표준 HTTP 헤더 `header:value` 형식으로 입력. 사용자 정의 메타데이터(X-Object-Meta-{header}:value)의 경우, 이 명령에서는 메타데이터가 갱신되지 않음 반복 입력 가능 (예시: `--header If-Modified-Since:"Wed, 01 Sep 2026 00:00:00 GMT" --header Accept:application/json`)

공통 옵션

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

예시

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

명령

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

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

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

100M 2026-08-31 05:04:27 application/octet-stream large.bin
  22 2026-08-31 05:43:04               text/plain renamed.txt
  21 2026-08-31 05:43:23               text/plain sample.txt
200M

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

200M

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

[
  {
    "bytes": 104857600,
    "content_type": "application/octet-stream",
    "hash": "2f282b84e7e608d5852449ed940bfc51",
    "last_modified": "2026-08-31T05:00:45.912190",
    "name": "docs/large.bin"
  },
  {
    "bytes": 104857600,
    "content_type": "application/octet-stream",
    "hash": "8e37a59e4d153e7387d0a96c6d81e838",
    "last_modified": "2026-08-31T05:04:27.483750",
    "name": "large.bin",
    "slo_etag": "\"0b8de9a6fad6e17a9e6b730accf781d2\""
  },
  {
    "bytes": 22,
    "content_type": "text/plain",
    "hash": "317d635cf5b7e94fec06fc58e1b453bd",
    "last_modified": "2026-08-31T05:43:04.945070",
    "name": "renamed.txt"
  },
  {
    "bytes": 21,
    "content_type": "text/plain",
    "hash": "b1a69af9fca78ffacfba90c9562f4793",
    "last_modified": "2026-08-31T05:43:23.283120",
    "name": "sample.txt"
  }
]