--- title: "Ncloud Storage 개요" slug: "storage-ncloudstorage" updated: 2026-07-23T08:59:37Z published: 2026-07-23T08:59:37Z canonical: "cli.ncloud-docs.com/storage-ncloudstorage" --- > ## 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. # Ncloud Storage 개요 Classic/VPC 환경에서 이용 가능합니다. Amazon S3 CLI와 호환되는 Ncloud Storage CLI의 초기 설정 방법과 사용 가능한 명령어를 확인합니다. ## 초기 설정 Ncloud Storage CLI를 사용하기 위한 설치와 인증 방법을 설명합니다. ### CLI 설치 설치 명령어는 다음과 같습니다. ``` pip3 install awscli ``` 참고 Ncloud Storage는 awscli v2에 최적화되어 있습니다. ### 인증 인증 정보를 설정하는 방법은 다음과 같습니다. API 인증키를 확인하는 방법은 [인증키 관리](https://api.ncloud-docs.com/docs/common-ncpapi)를 참조해 주십시오. ``` ~$ 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](/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-cors](/docs/delete-bucket-cors) | Ncloud Storage 버킷에 설정된 CORS 규칙을 삭제함 | | [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-cors](/docs/get-bucket-cors) | Ncloud Storage 버킷에 설정된 CORS 규칙을 조회함 | | [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에 생성한 객체를 다운로드함 | | [get-object-attributes](/docs/get-object-attributes) | Ncloud Storage에 저장한 객체의 속성을 조회함 | | [get-object-legal-hold](/docs/get-object-legal-hold) | Ncloud Storage 객체에 설정된 법적 보존(Legal Hold) 상태를 조회함 | | [get-object-lock-configuration](/docs/get-object-lock-configuration) | Ncloud Storage 버킷에 설정된 Object Lock 설정을 조회함 | | [get-object-retention](/docs/get-object-retention) | Ncloud Storage 객체에 설정된 보존(Retention) 정보를 조회함 | | [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-cors](/docs/put-bucket-cors) | Ncloud Storage 버킷에 CORS 규칙을 설정함 | | [put-bucket-encryption](/docs/put-bucket-encryption) | Ncloud Storage 버킷에 기본 서버측 암호화(SSE)를 설정함 | | [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에 객체를 저장함 | | [put-object-legal-hold](/docs/put-object-legal-hold) | Ncloud Storage 객체에 법적 보존(Legal Hold)을 설정함 | | [put-object-lock-configuration](/docs/put-object-lock-configuration) | Ncloud Storage 버킷에 Object Lock 설정을 적용함 | | [put-object-retention](/docs/put-object-retention) | Ncloud Storage 객체에 보존(Retention)을 설정함 | | [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 help aws help ```