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 문서를 참조해 주십시오.

인증

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 인증키를 참조해 주십시오.
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 <subcommand> [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 참조
`--os-password`	String	Conditional	API 인증키의 Secret Key `--os-auth-url` 입력 시 필수 입력 Ncloud API 참조
`--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	인증 환경 변수 출력
post	컨테이너(버킷) 생성 및 메타데이터 변경
upload	파일 또는 디렉터리 업로드
list	컨테이너(버킷) 목록 또는 오브젝트 목록 조회
stat	어카운트, 컨테이너(버킷), 오브젝트 정보 조회
download	오브젝트 다운로드
copy	오브젝트 복사
tempurl	오브젝트 접근용 임시 URL 생성
delete	컨테이너(버킷) 또는 오브젝트 삭제
capabilities	클러스터 지원 기능 및 제한값 조회

Archive Storage 연관 리소스

Archive Storage CLI에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.

Archive Storage CLI 서비스 사용 방법
- Archive Storage 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 Archive Storage 사용하는 방법
- Archive Storage API 가이드: Archive Storage API를 호출하는 방법
- Archive Storage 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 관한 사용 가이드
- 요금 소개, 특징, 상세 기능: Archive Storage의 요금 체계, 특징, 상세 기능 요약
- 서비스 최신 소식: Archive Storage 관련 최신 소식
- 자주 하는 질문: Archive Storage 사용자들이 자주 하는 질문
- 고객 지원: CLI 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의