--- title: "upload" slug: "cli-archivestorage-upload" updated: 2026-09-17T09:16:11Z published: 2026-09-17T09:16:11Z canonical: "cli.ncloud-docs.com/cli-archivestorage-upload" --- > ## 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. # upload Classic/VPC 환경에서 이용 가능합니다. 지정한 파일 또는 디렉터리를 컨테이너(버킷)에 업로드합니다. 참고 `--segment-size`로 분할 업로드하면 세그먼트는 매니페스트와 별도의 컨테이너에 저장됩니다. `--segment-container`를 입력하지 않으면 `<container>_segments` 컨테이너가 자동으로 생성됩니다. 다운로드는 매니페스트를 업로드한 컨테이너에서 수행합니다. ## 구문 `upload` 구문은 다음과 같습니다. ``` swift upload \ \ \ [--object-name ] \ [--segment-size ] \ [--segment-container ] \ [--use-slo] \ [--use-dlo] \ [--leave-segments] \ [--changed] \ [--skip-identical] \ [--skip-container-put] \ [--ignore-checksum] \ [--object-threads ] \ [--segment-threads ] \ [--meta ] \ [--header ] ``` ## 옵션 `upload` 실행 시 지정할 수 있는 옵션을 설명합니다. ### 필수 옵션 `upload`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `<container>` | String | Required | 컨테이너 이름 | | `<file-or-directory>` | List | Required | 파일 또는 디렉터리 경로 - 공백으로 구분하여 여러 개 입력 가능 - `-` 입력 시 표준 입력에서 내용을 읽음 (`--object-name` 필수 입력) | ### 선택 옵션 `upload`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--object-name` | String | Optional | 오브젝트 이름 - 디렉터리 업로드 시에는 오브젝트 이름의 접두사로 사용 | | `--segment-size` | Integer | Optional | 분할 업로드할 세그먼트 크기 (Byte) - 지정한 크기 이하로 파일을 나누어 업로드하고 매니페스트 파일 생성 | | `--segment-container` | String | Optional | 세그먼트를 업로드할 컨테이너 이름 - 미입력 시 `<container>_segments` 컨테이너가 자동으로 생성되어 업로드 | | `--use-slo` | Boolean | Optional | `--segment-size`와 함께 사용 시 Static Large Object 생성 - 클러스터가 SLO를 지원하는 경우, 기본으로 적용되므로 별도 지정 불필요 | | `--use-dlo` | Boolean | Optional | `--segment-size`와 함께 사용 시 Dynamic Large Object 생성 | | `--leave-segments` | Boolean | Optional | 덮어쓰기 시 이전 매니페스트 오브젝트의 세그먼트 유지 | | `--changed` | Boolean | Optional | 마지막 업로드 이후 변경된 파일만 업로드 | | `--skip-identical` | Boolean | Optional | 로컬 파일과 오브젝트가 동일한 경우, 업로드하지 않음 | | `--skip-container-put` | Boolean | Optional | 컨테이너가 이미 존재한다고 가정하고 자동 생성하지 않음 | | `--ignore-checksum` | Boolean | Optional | 업로드 시 체크섬 검증 비활성화 | | `--object-threads` | Integer | Optional | 오브젝트 업로드에 사용할 스레드 수 - 기본값: `10` | | `--segment-threads` | Integer | Optional | 세그먼트 업로드에 사용할 스레드 수 - 기본값: `10` | | `--meta` | String | Optional | 메타데이터 항목 - `name:value` 형식으로 입력 | | `--header` | String | Optional | 업로드 요청에 사용할 사용자 정의 헤더 - `header:value` 형식으로 입력 | ### 공통 옵션 `swift` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Archive Storage 옵션](/docs/guide-archivestorage#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 업로드 요청이 성공하면 업로드된 오브젝트 이름이 출력됩니다. ### 명령 파일 하나를 업로드하는 명령 예시는 다음과 같습니다. ``` swift upload test-container-01 sample.txt ``` 디렉터리 전체를 업로드하는 명령 예시는 다음과 같습니다. ``` swift upload test-container-01 docs ``` 대용량 파일을 세그먼트로 나누어 별도 컨테이너에 업로드하는 명령 예시는 다음과 같습니다. ``` swift upload test-container-01 large.bin \ --segment-size 1048576 \ --segment-container test-segments-01 ``` 오브젝트 이름을 지정하고 메타데이터를 함께 설정하는 명령 예시는 다음과 같습니다. ``` swift upload test-container-01 sample.txt \ --object-name renamed.txt \ --meta Purpose:Documentation ``` ### 출력 파일 하나를 업로드하는 출력 예시는 다음과 같습니다. ``` sample.txt ``` 디렉터리 전체를 업로드하는 출력 예시는 다음과 같습니다. ``` docs/report.txt ``` 대용량 파일을 세그먼트로 나누어 업로드하는 출력 예시는 다음과 같습니다. ``` large.bin segment 4 large.bin segment 2 large.bin segment 0 large.bin segment 3 large.bin segment 1 large.bin ``` 오브젝트 이름을 지정하고 메타데이터를 함께 설정하여 업로드하는 출력 예시는 다음과 같습니다. ``` renamed.txt ```