Classic/VPC 환경에서 이용 가능합니다.
Amazon S3 CLI와 호환되는 Ncloud Storage CLI의 초기 설정 방법과 사용 가능한 명령어를 확인합니다.
초기 설정
Ncloud Storage CLI를 사용하기 위한 설치와 인증 방법을 설명합니다.
CLI 설치
설치 명령어는 다음과 같습니다.
pip3 install awscli
참고
Ncloud Storage는 awscli v2에 최적화되어 있습니다.
인증
인증 정보를 설정하는 방법은 다음과 같습니다. 포탈 마이페이지 > 계정 관리 > 인증키 관리에서 생성한 API 인증키를 사용합니다.
~$ aws configure
AWS Access Key ID [None]: ACCESS_KEY_ID
AWS Secret Access Key [None]: SECRET_KEY
Default region name [None]: kr
Default output format [None]: [Enter]
참고
Ncloud Storage는 현재 KR 리전만 지원합니다.
지원하는 output format은 json, text, table, yaml, yaml-stream입니다.
호출 도메인(Endpoint)
CLI 이용 시 --endpoint-url 옵션은 필수값입니다. 호출 도메인은 다음과 같습니다.
| 리전 | 리전 이름 | 호출 도메인 |
|---|---|---|
| 한국 | kr | https://kr.ncloudstorage.com |
제공 리전은 지속적으로 확대해갈 예정입니다.
명령어
Ncloud Storage CLI에서 지원하는 명령어 목록은 다음과 같습니다.
High-Level
상위 수준의 명령어를 사용하면 Ncloud Storage를 파일 시스템처럼 접근 및 관리가 가능합니다. 명령어는 다음과 같습니다.
| 명령어 | 설명 |
|---|---|
| cp | 객체 복사 |
| ls | 버킷 및 객체 조회 |
| mb | 버킷 생성 |
| mv | 객체 이동 |
| presign | 객체 pre-signed URL 생성 |
| rb | 버킷 삭제 |
| rm | 객체 삭제 |
| sync | 객체 동기화 |
API-Level
API 수준의 명령어는 다음과 같습니다.
| 명령어 | 설명 |
|---|---|
| abort-multipart-upload | 진행 중인 멀티파트 업로드를 중지함 |
| complete-multipart-upload | 멀티파트 업로드를 통해 이미 업로드한 파트를 조합하여 객체를 생성하고 멀티파트 업로드를 완료함 |
| copy-object | Ncloud Storage에 저장한 객체를 복사함 |
| create-bucket | Ncloud Storage에 객체를 저장할 버킷을 생성함 |
| create-multipart-upload | 대용량의 객체를 업로드하기 위해 멀티파트 업로드를 시작하고 업로드 ID를 반환함 |
| delete-bucket | Ncloud Storage에 생성한 버킷을 삭제함 |
| delete-bucket-lifecycle | Ncloud Storage 버킷에 등록한 수명주기 규칙을 삭제함 |
| delete-object | Ncloud Storage에 저장한 객체를 삭제함 |
| delete-objects | Ncloud Storage에 저장한 여러 개의 객체를 동시에 삭제함 |
| get-bucket-encryption | Ncloud Storage 버킷에 설정된 암호화 방식을 조회함 |
| get-bucket-lifecycle-configuration | Ncloud Storage 버킷에 등록한 수명주기 규칙을 조회함 |
| get-bucket-location | Ncloud Storage에 생성한 버킷의 리전 정보를 조회함 |
| get-bucket-versioning | Ncloud Storage에 생성한 버킷의 버전 관리 설정 여부를 조회함 |
| get-object | Ncloud Storage에 생성한 객체를 다운로드함 |
| head-bucket | Ncloud Storage에 생성한 버킷의 속성을 조회함 |
| head-object | Ncloud Storage에 저장한 객체의 메타데이터를 조회함 |
| list-buckets | 사용자가 소유한 모든 버킷의 목록을 조회함 |
| list-multipart-uploads | 현재 진행 중인 멀티파트 업로드의 리스트를 조회함 |
| list-objects | Ncloud Storage 버킷에 저장된 객체의 리스트를 조회함 |
| list-objects-v2 | Ncloud Storage 버킷에 저장된 객체의 리스트를 조회함 |
| list-object-versions | 버전 관리를 사용하는 버킷에 저장한 객체의 모든 버전의 메타데이터를 조회함 |
| list-parts | 특정 멀티파트 업로드를 통해 업로드된 파트의 리스트를 조회함 |
| put-bucket-lifecycle-configuration | Ncloud Storage 버킷에 수명주기 규칙을 등록함 |
| put-bucket-versioning | Ncloud Storage에 생성한 버킷의 버전 관리를 설정함 |
| put-object | Ncloud Storage에 객체를 저장함 |
| restore-object | Deep Archive Class에 저장한 객체에 액세스할 수 있도록 객체를 복원함 |
| upload-part | 멀티파트 업로드의 파트를 업로드함 |
| upload-part-copy | Ncloud Storage에 저장된 대용량의 객체를 복사함 |
명령어 도움말
Ncloud Storage CLI의 원활한 사용을 위해 도움말을 확인하려면 다음 명령어를 실행해 주십시오.
aws help
aws <command> help
aws <command> <subcommand> help