Classic/VPC 환경에서 이용 가능합니다.
Amazon S3 CLI와 호환되는 Ncloud Storage CLI의 초기 설정 방법과 사용 가능한 명령어를 확인합니다. ## 초기 설정 Ncloud Storage CLI를 사용하기 위한 설치와 인증 방법을 설명합니다. ### CLI 설치 설치 명령어는 다음과 같습니다. ``` pip3 install awscli ``` :::(Info) (참고) Ncloud Storage는 awscli v2에 최적화되어 있습니다. ::: ### 인증 인증 정보를 설정하는 방법은 다음과 같습니다. API 인증키를 확인하는 방법은 [인증키 관리](https://api.ncloud-docs.com/docs/common-ncpapi){target="_blank"}를 참조해 주십시오. ``` ~$ 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] ``` :::(Info) (참고) 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](/docs/cp) | 객체 복사 | | [ls](/docs/ls) | 버킷 및 객체 조회 | | [mb](/docs/mb) | 버킷 생성 | | [mv](/docs/mv) | 객체 이동 | | [presign](/docs/presign) | 객체 pre-signed URL 생성 | | [rb](/docs/rb) | 버킷 삭제 | | [rm](/docs/rm) | 객체 삭제 | | [sync](/docs/sync) | 객체 동기화 | ### API-Level API 수준의 명령어는 다음과 같습니다. | 명령어 | 설명 | | --- | --- | | [abort-multipart-upload](/docs/abort-multipart-upload) |진행 중인 멀티파트 업로드를 중지함 | | [complete-multipart-upload](/docs/complete-multipart-upload) |멀티파트 업로드를 통해 이미 업로드한 파트를 조합하여 객체를 생성하고 멀티파트 업로드를 완료함| | [copy-object](/docs/copy-object) |Ncloud Storage에 저장한 객체를 복사함| | [create-bucket](/docs/create-bucket) |Ncloud Storage에 객체를 저장할 버킷을 생성함| | [create-multipart-upload](/docs/create-multipart-upload) |대용량의 객체를 업로드하기 위해 멀티파트 업로드를 시작하고 업로드 ID를 반환함| | [delete-bucket](/docs/delete-bucket) |Ncloud Storage에 생성한 버킷을 삭제함| | [delete-bucket-lifecycle](/docs/delete-bucket-lifecycle) |Ncloud Storage 버킷에 등록한 수명주기 규칙을 삭제함| | [delete-object](/docs/delete-object) |Ncloud Storage에 저장한 객체를 삭제함| | [delete-objects](/docs/delete-objects) |Ncloud Storage에 저장한 여러 개의 객체를 동시에 삭제함| | [get-bucket-encryption](/docs/get-bucket-encryption) |Ncloud Storage 버킷에 설정된 암호화 방식을 조회함| | [get-bucket-lifecycle-configuration](/docs/get-bucket-lifecycle-configuration) |Ncloud Storage 버킷에 등록한 수명주기 규칙을 조회함| | [get-bucket-location](/docs/get-bucket-location) |Ncloud Storage에 생성한 버킷의 리전 정보를 조회함| | [get-bucket-versioning](/docs/get-bucket-versioning) |Ncloud Storage에 생성한 버킷의 버전 관리 설정 여부를 조회함| | [get-object](/docs/get-object) |Ncloud Storage에 생성한 객체를 다운로드함| | [head-bucket](/docs/head-bucket) |Ncloud Storage에 생성한 버킷의 속성을 조회함| | [head-object](/docs/head-object) |Ncloud Storage에 저장한 객체의 메타데이터를 조회함 | | [list-buckets](/docs/list-buckets) |사용자가 소유한 모든 버킷의 목록을 조회함 | | [list-multipart-uploads](/docs/list-multipart-uploads) |현재 진행 중인 멀티파트 업로드의 리스트를 조회함| | [list-objects](/docs/list-objects) |Ncloud Storage 버킷에 저장된 객체의 리스트를 조회함| | [list-objects-v2](/docs/list-objects-v2) |Ncloud Storage 버킷에 저장된 객체의 리스트를 조회함| | [list-object-versions](/docs/list-object-versions) |버전 관리를 사용하는 버킷에 저장한 객체의 모든 버전의 메타데이터를 조회함 | | [list-parts](/docs/list-parts) |특정 멀티파트 업로드를 통해 업로드된 파트의 리스트를 조회함| | [put-bucket-lifecycle-configuration](/docs/put-bucket-lifecycle-configuration) |Ncloud Storage 버킷에 수명주기 규칙을 등록함| | [put-bucket-versioning](/docs/put-bucket-versioning) |Ncloud Storage에 생성한 버킷의 버전 관리를 설정함| | [put-object](/docs/put-object) |Ncloud Storage에 객체를 저장함| | [restore-object](/docs/restore-object) |Deep Archive Class에 저장한 객체에 액세스할 수 있도록 객체를 복원함| | [upload-part](/docs/upload-part) |멀티파트 업로드의 파트를 업로드함 | | [upload-part-copy](/docs/upload-part-copy) |Ncloud Storage에 저장된 대용량의 객체를 복사함| ## 명령어 도움말 Ncloud Storage CLI의 원활한 사용을 위해 도움말을 확인하려면 다음 명령어를 실행해 주십시오. ``` aws help aws