--- title: "Archive Storage 개요" slug: "guide-archivestorage" updated: 2026-09-22T02:17:09Z published: 2026-09-22T02:17:09Z canonical: "cli.ncloud-docs.com/guide-archivestorage" --- > ## 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. # Archive Storage 개요 Classic/VPC 환경에서 이용 가능합니다. Archive Storage는 대용량 데이터를 저렴한 비용으로 장기간 보관할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. Archive Storage에서는 컨테이너(버킷)와 오브젝트 관리 기능에 대한 CLI를 OpenStack Swift CLI와 호환되는 `swift` 명령어로 제공합니다. ## Archive Storage 공통 설정 Archive Storage CLI를 사용하기 위한 설치와 인증 방법, 공통으로 사용하는 명령어와 옵션 형식을 설명합니다. ### 설치 Archive Storage CLI는 OpenStack Swift 클라이언트를 설치하여 사용합니다. Python 버전에 따라 다음 명령어로 설치해 주십시오. Python 3.9 이하의 설치 명령어는 다음과 같습니다. ``` pip install python-keystoneclient==3.17.0 pip install python-swiftclient==3.6.0 ``` Python 3.10 이상의 설치 명령어는 다음과 같습니다. ``` pip install python-keystoneclient==5.1.0 pip install python-swiftclient==4.3.0 ``` 참고 OpenStack Swift CLI에 대한 자세한 내용은 [OpenStack Swift CLI 문서](https://docs.openstack.org/ocata/cli-reference/swift.html)를 참조해 주십시오. ### 인증 Archive Storage는 인증 정보로 토큰을 발급받아 서비스를 이용합니다. 인증 명령어는 다음과 같습니다. ``` swift --os-auth-url https://kr.archive.ncloudstorage.com:5000/v3 --auth-version 3 \ --os-username {access_key_id} --os-password {secret_key} \ --os-user-domain-id {domain_id} --os-project-id {project_id} \ auth ``` 참고 - `access_key_id`와 `secret_key`를 확인하는 방법은 [API 인증키](https://api.ncloud-docs.com/docs/common-ncpapi#1%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1)를 참조해 주십시오. - `project_id`와 `domain_id`는 네이버 클라우드 플랫폼 콘솔에서 Archive Storage 서비스 이용 신청 후 **Container Management** 메뉴의 **[API 이용 정보 확인]** 버튼을 클릭하여 확인해 주십시오. 인증에 성공하면 스토리지 URL과 인증 토큰이 반환됩니다. ``` export OS_STORAGE_URL=https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id} export OS_AUTH_TOKEN={token} ``` 반환된 `export` 명령을 실행해 `OS_STORAGE_URL`과 `OS_AUTH_TOKEN`을 환경 변수로 선언하면 재인증 없이 서비스를 요청할 수 있습니다. ``` export OS_STORAGE_URL=https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id} export OS_AUTH_TOKEN={token} swift list ``` 환경 변수로 선언하지 않고 `--os-storage-url`, `--os-auth-token` 옵션에 값을 직접 입력할 수도 있습니다. ``` swift --os-storage-url https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id} \ --os-auth-token {token} \ list ``` 참고 서비스 인증 URL과 토큰값을 환경 변수로 저장해서 사용하지 않고, 인증 명령어를 이용해서 인증 정보를 요청할 때마다 인증 정보를 함께 입력하는 방식은 매번 인증을 수행하므로 권장하지 않습니다. ### 구문 `swift`는 다음 구문으로 실행합니다. ``` swift [options] ``` ### 옵션 `swift`에서 공통으로 사용할 수 있는 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--os-storage-url` | String | Conditional | 서비스 URL - `--os-auth-token`과 함께 입력 - 인증 정보를 직접 입력하는 경우, 미입력 | | `--os-auth-token` | String | Conditional | 발급받은 인증 토큰 - `--os-storage-url`과 함께 입력 - 인증 정보를 직접 입력하는 경우, 미입력 | | `--os-auth-url` | String | Conditional | 인증 URL - `--os-storage-url`, `--os-auth-token`을 입력하지 않는 경우, 필수 입력 - 한국 리전: `https://kr.archive.ncloudstorage.com:5000/v3` | | `--auth-version` | String | Conditional | 인증 API 버전 - `--os-auth-url` 입력 시 필수 입력 - `3` | | `--os-username` | String | Conditional | API 인증키의 Access Key ID - `--os-auth-url` 입력 시 필수 입력 - [Ncloud API](https://api.ncloud-docs.com/docs/common-ncpapi) 참조 | | `--os-password` | String | Conditional | API 인증키의 Secret Key - `--os-auth-url` 입력 시 필수 입력 - [Ncloud API](https://api.ncloud-docs.com/docs/common-ncpapi) 참조 | | `--os-user-domain-id` | String | Conditional | 사용자가 속한 도메인 ID - `--os-auth-url` 입력 시 필수 입력 - 콘솔에서 **Archive Storage** > **Container Management** 메뉴의 **[API 이용 정보 확인]** 버튼을 클릭하여 확인 | | `--os-project-id` | String | Conditional | 사용자가 속한 프로젝트 ID - `--os-auth-url` 입력 시 필수 입력 - 콘솔에서 **Archive Storage** > **Container Management** 메뉴의 **[API 이용 정보 확인]** 버튼을 클릭하여 확인 | ## Archive Storage 명령어 `swift` 명령어에서 실행할 수 있는 하위 명령어 목록입니다. | 명령어 | 설명 | | --- | --- | | [auth](/docs/cli-archivestorage-auth) | 인증 환경 변수 출력 | | [post](/docs/cli-archivestorage-post) | 컨테이너(버킷) 생성 및 메타데이터 변경 | | [upload](/docs/cli-archivestorage-upload) | 파일 또는 디렉터리 업로드 | | [list](/docs/cli-archivestorage-list) | 컨테이너(버킷) 목록 또는 오브젝트 목록 조회 | | [stat](/docs/cli-archivestorage-stat) | 어카운트, 컨테이너(버킷), 오브젝트 정보 조회 | | [download](/docs/cli-archivestorage-download) | 오브젝트 다운로드 | | [copy](/docs/cli-archivestorage-copy) | 오브젝트 복사 | | [tempurl](/docs/cli-archivestorage-tempurl) | 오브젝트 접근용 임시 URL 생성 | | [delete](/docs/cli-archivestorage-delete) | 컨테이너(버킷) 또는 오브젝트 삭제 | | [capabilities](/docs/cli-archivestorage-capabilities) | 클러스터 지원 기능 및 제한값 조회 | ## Archive Storage 연관 리소스 Archive Storage CLI에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다. - Archive Storage CLI 서비스 사용 방법 - [Archive Storage 사용 가이드](https://guide.ncloud-docs.com/docs/archivestorage-overview): 네이버 클라우드 플랫폼 콘솔에서 Archive Storage 사용하는 방법 - [Archive Storage API 가이드](https://api.ncloud-docs.com/docs/storage-archivestorage): Archive Storage API를 호출하는 방법 - [Archive Storage 사용 환경 가이드](https://guide.ncloud-docs.com/docs/environment-environment-1-1): VPC, Classic 환경 및 지원 여부에 관한 사용 가이드 - [요금 소개, 특징, 상세 기능](https://www.ncloud.com/product/storage/archiveStorage): Archive Storage의 요금 체계, 특징, 상세 기능 요약 - [서비스 최신 소식](https://www.ncloud.com/intro/news?categoryCode=STRG&serviceCode=SV_0100): Archive Storage 관련 최신 소식 - [자주 하는 질문](https://www.ncloud.com/support/faq/prod?categoryCode2=STRG&categoryCode3=SV_0100): Archive Storage 사용자들이 자주 하는 질문 - [고객 지원](https://www.ncloud.com/v2/support/question/service): CLI 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의