--- title: "Ncloud Storage 개요" slug: "storage-ncloudstorage" updated: 2026-10-13T23:54:20Z published: 2026-10-14T09:00:27Z 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 환경에서 이용 가능합니다. Ncloud Storage는 인터넷 상에 데이터를 저장하고 관리할 수 있는 네이버 클라우드 플랫폼의 오브젝트 스토리지 서비스입니다. Ncloud Storage에서는 버킷과 객체 관리 기능에 대한 CLI를 Amazon S3 CLI와 호환되는 `aws` 명령어로 제공합니다. ## Ncloud Storage 공통 설정 Ncloud Storage CLI를 사용하기 위한 설치와 인증 방법, 공통으로 사용하는 명령어와 옵션 형식을 설명합니다. ### 설치 Ncloud Storage CLI는 AWS CLI를 설치하여 사용합니다. 설치 명령어는 다음과 같습니다. ``` pip3 install awscli ``` 참고 `pip3` 명령어로는 AWS CLI v1이 설치되며, 이 가이드의 예시는 v1 출력을 기준으로 작성되었습니다. AWS CLI v2 설치 방법은 [AWS CLI 설치 가이드](https://docs.aws.amazon.com/ko_kr/cli/latest/userguide/getting-started-install.html)를 참조해 주십시오. ### 인증 인증 정보를 설정하는 명령어는 다음과 같습니다. ``` 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] ``` 참고 - `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)를 참조해 주십시오. - Ncloud Storage는 현재 KR 리전만 지원합니다. - 지원하는 출력 형식은 `json`, `text`, `table`, `yaml`, `yaml-stream`입니다. ### 구문 `aws`는 다음 구문으로 실행합니다. ``` aws s3 [options] --endpoint-url aws s3api [options] --endpoint-url ``` 참고 - CLI 이용 시 `--endpoint-url` 옵션을 반드시 입력해야 합니다. 리전별 호출 도메인은 다음과 같습니다. - 리전: 한국 - 리전 이름: kr - 호출 도메인: https://kr.ncloudstorage.com - 제공 리전은 지속적으로 확대할 예정입니다. `s3`는 Ncloud Storage를 파일 시스템처럼 다루는 High-level 명령어이고, `s3api`는 Ncloud Storage API와 1:1로 대응하는 API-level 명령어입니다. 참고 [put-bucket-website](/docs/put-bucket-website)로 정적 웹 사이트 호스팅을 설정한 버킷은 `http://{bucket}.kr.website.ncloudstorage.com` URL로도 접근할 수 있습니다. 이 URL은 `aws` 명령어가 아닌 웹 브라우저나 HTTP 클라이언트로 호출하며, HTTP와 `GET`·`HEAD`·`OPTIONS` 메서드만 지원합니다. 도움말을 확인하는 명령어는 다음과 같습니다. ``` aws help aws help aws help ``` ### 옵션 `aws`에서 공통으로 사용할 수 있는 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--endpoint-url` | String | Required | 명령을 호출할 엔드포인트 URL - `https://kr.ncloudstorage.com` - KR 리전만 지원 | | `--region` | String | Optional | 리전 - `kr` | | `--profile` | String | Optional | 자격 증명 파일과 설정 파일에서 사용할 프로필 이름 - 기본값: `default` - 자격 증명 외에 리전, 출력 형식 등 프로필에 저장된 설정도 함께 적용 | | `--no-sign-request` | Boolean | Optional | 요청 서명 비활성화 - 자격 증명을 로드하지 않고 익명으로 요청 | | `--cli-input-json`, `--cli-input-yaml` | String | Optional | JSON 또는 YAML 형식으로 명령의 파라미터 입력 - `file://` 접두사를 사용해 로컬 파일 경로 지정 - JSON과 YAML 동시 지정 불가 - API-level 명령만 지원 | | `--generate-cli-skeleton` | String | Optional | 명령을 실행하지 않고 파라미터 템플릿 생성 - `input` (기본값) \| `yaml-input` \| `output` - API-level 명령만 지원 | | `--cli-auto-prompt` | Boolean | Optional | 옵션 자동 프롬프트 활성화 - 명령과 옵션을 대화형으로 선택하여 입력 | | `--no-cli-auto-prompt` | Boolean | Optional | 옵션 자동 프롬프트 비활성화 | | `--output` | String | Optional | 응답 결과의 형식 - `json` (기본값) \| `text` \| `table` \| `yaml` \| `yaml-stream` | | `--query` | String | Optional | 응답 결과 필터링 시 사용할 JMESPath 쿼리 | | `--color` | String | Optional | 출력 색상 사용 여부 - `on` \| `off` \| `auto` (기본값) | | `--no-paginate` | Boolean | Optional | 자동 페이지네이션 비활성화 - 결과의 첫 번째 페이지만 조회 | | `--no-cli-pager` | Boolean | Optional | CLI 페이저 비활성화 - 페이저를 거치지 않고 표준 출력으로 결과 반환 | | `--ca-bundle` | String | Optional | SSL 인증서를 검증할 때 사용할 CA 인증서 번들 경로 | | `--no-verify-ssl` | Boolean | Optional | SSL 인증서 검증 비활성화 | | `--cli-connect-timeout` | Integer | Optional | 최대 연결 시간 (초) - 기본값: `60` - `0` 입력 시 타임아웃 없이 차단 상태로 동작 | | `--cli-read-timeout` | Integer | Optional | 최대 읽기 시간 (초) - 기본값: `60` - `0` 입력 시 타임아웃 없이 차단 상태로 동작 | | `--debug` | Boolean | Optional | 디버그 로깅 활성화 | ## Ncloud Storage 명령어 `aws` 명령어에서 실행할 수 있는 하위 명령어 목록입니다. ### High-level High-level 명령어를 사용하면 Ncloud Storage를 파일 시스템처럼 접근하고 관리할 수 있습니다. 관련 명령어는 다음과 같습니다. | 명령어 | 설명 | | --- | --- | | [mb](/docs/mb) | 버킷 생성 | | [ls](/docs/ls) | 버킷 및 객체 조회 | | [cp](/docs/cp) | 객체 복사 | | [mv](/docs/mv) | 객체 이동 | | [sync](/docs/sync) | 객체 동기화 | | [presign](/docs/presign) | 객체 사전 서명(Pre-signed) URL 생성 | | [rm](/docs/rm) | 객체 삭제 | | [rb](/docs/rb) | 버킷 삭제 | ### API-level API-level 명령어는 Ncloud Storage API와 1:1로 대응합니다. 관련 명령어는 다음과 같습니다. | 명령어 | 설명 | | --- | --- | | [create-bucket](/docs/create-bucket) | Ncloud Storage에 객체를 저장할 버킷 생성 | | [list-buckets](/docs/list-buckets) | 사용자가 소유한 모든 버킷의 목록 조회 | | [head-bucket](/docs/head-bucket) | Ncloud Storage에 생성한 버킷의 속성 조회 | | [get-bucket-location](/docs/get-bucket-location) | Ncloud Storage에 생성한 버킷의 리전 정보 조회 | | [delete-bucket](/docs/delete-bucket) | Ncloud Storage에 생성한 버킷 삭제 | | [get-bucket-versioning](/docs/get-bucket-versioning) | 버킷의 버전 관리 설정 여부 조회 | | [put-bucket-versioning](/docs/put-bucket-versioning) | 버킷의 버전 관리 설정 | | [get-bucket-encryption](/docs/get-bucket-encryption) | 버킷에 설정된 암호화 방식 조회 | | [put-bucket-encryption](/docs/put-bucket-encryption) | 버킷에 기본 서버측 암호화(SSE) 설정 | | [delete-bucket-encryption](/docs/delete-bucket-encryption) | 버킷에 설정된 암호화 설정 삭제 | | [get-bucket-cors](/docs/get-bucket-cors) | 버킷에 설정된 CORS 규칙 조회 | | [put-bucket-cors](/docs/put-bucket-cors) | 버킷에 CORS 규칙 설정 | | [delete-bucket-cors](/docs/delete-bucket-cors) | 버킷에 설정된 CORS 규칙 삭제 | | [get-bucket-website](/docs/get-bucket-website) | 버킷에 설정된 정적 웹 사이트 호스팅 설정 조회 | | [put-bucket-website](/docs/put-bucket-website) | 버킷에 정적 웹 사이트 호스팅 설정 | | [delete-bucket-website](/docs/delete-bucket-website) | 버킷에 설정된 정적 웹 사이트 호스팅 설정 삭제 | | [get-bucket-policy](/docs/get-bucket-policy) | 버킷에 설정된 버킷 정책 조회 | | [put-bucket-policy](/docs/put-bucket-policy) | 버킷에 버킷 정책 설정 | | [delete-bucket-policy](/docs/delete-bucket-policy) | 버킷에 설정된 버킷 정책 삭제 | | [get-bucket-policy-status](/docs/get-bucket-policy-status) | 버킷에 설정된 버킷 정책의 공개 여부 조회 | | [get-public-access-block](/docs/get-public-access-block) | 버킷에 설정된 공개 액세스 차단 설정 조회 | | [put-public-access-block](/docs/put-public-access-block) | 버킷에 공개 액세스 차단 설정 | | [delete-public-access-block](/docs/delete-public-access-block) | 버킷에 설정된 공개 액세스 차단 설정을 기본값으로 되돌림 | | [get-bucket-ownership-controls](/docs/get-bucket-ownership-controls) | 버킷의 객체 소유권 설정 조회 | | [put-bucket-ownership-controls](/docs/put-bucket-ownership-controls) | 버킷의 객체 소유권 설정 | | [delete-bucket-ownership-controls](/docs/delete-bucket-ownership-controls) | 버킷의 객체 소유권 설정 삭제(지원하지 않음) | | [get-bucket-lifecycle-configuration](/docs/get-bucket-lifecycle-configuration) | 버킷에 등록한 수명주기 규칙 조회 | | [put-bucket-lifecycle-configuration](/docs/put-bucket-lifecycle-configuration) | 버킷에 수명주기 규칙 등록 | | [delete-bucket-lifecycle](/docs/delete-bucket-lifecycle) | 버킷에 등록한 수명주기 규칙 삭제 | | [get-object-lock-configuration](/docs/get-object-lock-configuration) | 버킷에 설정된 Object Lock 설정 조회 | | [put-object-lock-configuration](/docs/put-object-lock-configuration) | 버킷에 Object Lock 설정 적용 | | [get-bucket-logging](/docs/get-bucket-logging) | 버킷에 설정된 서버 액세스 로깅 설정 조회 | | [put-bucket-logging](/docs/put-bucket-logging) | 버킷에 서버 액세스 로깅 설정 | | [put-object](/docs/put-object) | Ncloud Storage에 객체 저장 | | [get-object](/docs/get-object) | Ncloud Storage에 생성한 객체 다운로드 | | [head-object](/docs/head-object) | Ncloud Storage에 저장한 객체의 메타데이터 조회 | | [copy-object](/docs/copy-object) | Ncloud Storage에 저장한 객체 복사 | | [get-object-attributes](/docs/get-object-attributes) | Ncloud Storage에 저장한 객체의 속성 조회 | | [list-objects](/docs/list-objects) | 버킷에 저장된 객체의 리스트 조회 | | [list-objects-v2](/docs/list-objects-v2) | 버킷에 저장된 객체의 리스트 조회 | | [list-object-versions](/docs/list-object-versions) | 버전 관리를 사용하는 버킷에 저장한 객체의 모든 버전 메타데이터 조회 | | [delete-object](/docs/delete-object) | Ncloud Storage에 저장한 객체 삭제 | | [delete-objects](/docs/delete-objects) | Ncloud Storage에 저장한 여러 개의 객체를 동시에 삭제 | | [restore-object](/docs/restore-object) | Deep Archive Class에 저장한 객체 복원 | | [get-object-legal-hold](/docs/get-object-legal-hold) | 객체에 설정된 법적 보존(Legal Hold) 상태 조회 | | [put-object-legal-hold](/docs/put-object-legal-hold) | 객체에 법적 보존(Legal Hold) 설정 | | [get-object-retention](/docs/get-object-retention) | 객체에 설정된 보존(Retention) 정보 조회 | | [put-object-retention](/docs/put-object-retention) | 객체에 보존(Retention) 설정 | | [create-multipart-upload](/docs/create-multipart-upload) | 멀티파트 업로드를 시작하고 업로드 ID 반환 | | [upload-part](/docs/upload-part) | 멀티파트 업로드의 파트 업로드 | | [upload-part-copy](/docs/upload-part-copy) | Ncloud Storage에 저장된 대용량의 객체 복사 | | [list-parts](/docs/list-parts) | 특정 멀티파트 업로드를 통해 업로드된 파트의 리스트 조회 | | [list-multipart-uploads](/docs/list-multipart-uploads) | 현재 진행 중인 멀티파트 업로드의 리스트 조회 | | [complete-multipart-upload](/docs/complete-multipart-upload) | 업로드한 파트를 조합하여 객체를 생성하고 멀티파트 업로드 완료 | | [abort-multipart-upload](/docs/abort-multipart-upload) | 진행 중인 멀티파트 업로드 중지 | ## Ncloud Storage 연관 리소스 Ncloud Storage CLI에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다. - Ncloud Storage CLI 서비스 사용 방법 - [Ncloud Storage 사용 가이드](https://guide.ncloud-docs.com/docs/ncloudstorage-overview): 네이버 클라우드 플랫폼 콘솔에서 Ncloud Storage 사용하는 방법 - [Ncloud Storage API 가이드](https://api.ncloud-docs.com/docs/storage-ncloudstorage): Ncloud Storage API를 호출하는 방법 - [Ncloud Storage 사용 환경 가이드](https://guide.ncloud-docs.com/docs/environment-environment-1-1): VPC, Classic 환경 및 지원 여부에 관한 사용 가이드 - [요금 소개, 특징, 상세 기능](https://www.ncloud.com/product/storage/ncloudStorage): Ncloud Storage의 요금 체계, 특징, 상세 기능 요약 - [서비스 최신 소식](https://www.ncloud.com/intro/news?categoryCode=STRG&serviceCode=SV_0269): Ncloud Storage 관련 최신 소식 - [자주 하는 질문](https://www.ncloud.com/support/faq/prod?categoryCode2=STRG&categoryCode3=SV_0269): Ncloud Storage 사용자들이 자주 하는 질문 - [고객 지원](https://www.ncloud.com/v2/support/question/service): CLI 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의