--- title: "download" slug: "cli-archivestorage-download" updated: 2026-09-17T09:16:11Z published: 2026-09-17T09:16:11Z canonical: "cli.ncloud-docs.com/cli-archivestorage-download" --- > ## 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. # download Classic/VPC 환경에서 이용 가능합니다. 컨테이너(버킷)의 오브젝트를 다운로드합니다. ## 구문 `download` 구문은 다음과 같습니다. - 어카운트(전체 컨테이너 및 오브젝트 다운로드) ``` swift download \ --all \ [--marker ] \ [--prefix ] \ [--remove-prefix] \ [--output-dir ] \ [--object-threads ] \ [--container-threads ] \ [--no-download] \ [--skip-identical] \ [--ignore-checksum] \ [--ignore-mtime] \ [--no-shuffle] \ [--header ] ``` - 컨테이너(컨테이너 내 전체 오브젝트 다운로드) ``` swift download \ \ [--marker ] \ [--prefix ] \ [--remove-prefix] \ [--output-dir ] \ [--object-threads ] \ [--container-threads ] \ [--no-download] \ [--skip-identical] \ [--ignore-checksum] \ [--ignore-mtime] \ [--no-shuffle] \ [--header ] ``` - 오브젝트(단일 또는 다중 오브젝트 다운로드) ``` swift download \ [ ...] \ [--output ] \ [--output-dir ] \ [--object-threads ] \ [--no-download] \ [--skip-identical] \ [--ignore-checksum] \ [--ignore-mtime] \ [--header ] ``` ## 옵션 `download` 실행 시 지정할 수 있는 옵션을 설명합니다. ### 필수 옵션 `download`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `<container>` | String | Conditional | 컨테이너 이름 - `--all` 미입력 시 필수 입력 | | `--all` | Boolean | Conditional | 어카운트의 모든 오브젝트 다운로드 - `<container>` 미입력 시 필수 입력 | ### 선택 옵션 `download`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `<object>` | List | Optional | 오브젝트 이름 - 공백으로 구분하여 여러 개 입력 가능 - 미입력 시 컨테이너의 모든 오브젝트 다운로드 | | `--prefix` | String | Optional | 지정한 접두사로 시작하는 항목만 다운로드 | | `--remove-prefix` | Boolean | Optional | 접두사를 제외한 이름으로 저장 - `--prefix`와 함께 사용 | | `--marker` | String | Optional | 컨테이너 또는 어카운트 다운로드를 시작할 기준 위치 | | `--output` | String | Optional | 단일 파일 다운로드 시 저장할 파일 경로 - `-` 입력 시 표준 출력으로 전달 | | `--output-dir` | String | Optional | 오브젝트를 저장할 디렉터리 - 미입력 시 현재 디렉터리에 저장 - 오브젝트를 하나만 지정한 경우 사용 불가(`--output` 사용) | | `--no-download` | Boolean | Optional | 다운로드를 수행하되 디스크에 저장하지 않음 | | `--skip-identical` | Boolean | Optional | 로컬 파일과 오브젝트가 동일한 경우, 다운로드하지 않음 | | `--ignore-checksum` | Boolean | Optional | 다운로드 시 체크섬 검증 비활성화 | | `--ignore-mtime` | Boolean | Optional | `X-Object-Meta-Mtime` 헤더를 무시하고 새로운 시간 정보로 저장 | | `--no-shuffle` | Boolean | Optional | 오브젝트 저장소에 나열된 순서대로 다운로드 - 미입력 시 임의 순서로 다운로드 | | `--object-threads` | Integer | Optional | 오브젝트 다운로드에 사용할 스레드 수 - 기본값: `10` | | `--container-threads` | Integer | Optional | 컨테이너 다운로드에 사용할 스레드 수 - 기본값: `10` | | `--header` | String | Optional | 다운로드 요청에 사용할 사용자 정의 헤더 - `header:value` 형식으로 입력 - 반복 입력 가능 | ### 공통 옵션 `swift` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Archive Storage 옵션](/docs/guide-archivestorage#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 명령을 실행하면 다운로드한 오브젝트 이름과 소요 시간 정보가 출력됩니다. ### 명령 오브젝트 하나를 다운로드하는 명령 예시는 다음과 같습니다. ``` swift download test-container-01 sample.txt ``` 접두사로 필터링하여 저장 디렉터리를 지정하고 동일한 파일은 건너뛰는 명령 예시는 다음과 같습니다. ``` swift download test-container-01 \ --prefix docs/ \ --output-dir ./download \ --skip-identical ``` 어카운트의 모든 오브젝트를 순서대로 다운로드하는 명령 예시는 다음과 같습니다. ``` swift download \ --all \ --no-shuffle ``` ### 출력 오브젝트 하나를 다운로드하는 출력 예시는 다음과 같습니다. ``` sample.txt [auth 0.000s, headers 0.109s, total 0.109s, 0.000 MB/s] ``` 접두사로 필터링하여 다운로드하는 출력 예시는 다음과 같습니다. ``` ./download/docs/report.txt [auth 0.000s, headers 0.071s, total 0.071s, 0.000 MB/s] ``` 어카운트의 모든 오브젝트를 다운로드하는 출력 예시는 다음과 같습니다. ``` test-container-01/renamed.txt [auth 0.000s, headers 0.129s, total 0.129s, 0.000 MB/s] test-container-01/sample.txt [auth 0.000s, headers 0.132s, total 0.132s, 0.000 MB/s] test-container-01/large.bin [auth 0.000s, headers 0.236s, total 0.372s, 14.090 MB/s] ```