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의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`<container>`	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 옵션을 참조해 주십시오.

예시

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

명령

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

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"
  }
]