--- title: "Object Storage 개요" slug: "guide-objectstorage" updated: 2026-09-17T09:16:11Z published: 2026-09-17T09:16:11Z canonical: "cli.ncloud-docs.com/guide-objectstorage" --- > ## 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. # Object Storage 개요 Classic/VPC 환경에서 이용 가능합니다. Object Storage는 인터넷 상에 데이터를 저장하고 관리할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. Object Storage에서는 버킷과 객체 관리 기능에 대한 CLI를 Amazon S3 CLI와 호환되는 `aws` 명령어로 제공합니다. ## Object Storage 공통 설정 Object Storage CLI를 사용하기 위한 설치와 인증 방법, 공통으로 사용하는 명령어와 옵션 형식을 설명합니다. ### 설치 Object Storage CLI는 AWS CLI를 설치하여 사용합니다. 설치 명령어는 다음과 같습니다. ``` pip install awscli==1.15.85 ``` 참고 - awscli 1.16.x 이상 버전은 일부 기능을 지원하지 않으므로 1.15.x 버전 사용을 권장합니다. - awscli 1.15.85 버전은 Python 3.8 이하 버전에서 동작합니다. - 관련 자료는 다음을 참조해 주십시오. - 문서: [awscli 1.15.85](https://pypi.org/project/awscli/1.15.85/) - git: [aws-cli 1.15.85](https://github.com/aws/aws-cli/tree/1.15.85/) ### 인증 인증 정보를 설정하는 명령어는 다음과 같습니다. ``` aws configure ``` 명령을 실행하면 다음 항목을 차례로 입력합니다. ``` AWS Access Key ID [****************leLy]: {access_key_id} AWS Secret Access Key [None]: {secret_key} Default region name [None]: [Enter] Default output format [None]: [Enter] ``` 참고 - `access_key_id`와 `secret_key`는 [Ncloud API](https://api.ncloud-docs.com/docs/common-ncpapi)를 참조하여 생성한 API 인증키를 사용합니다. - Role을 부여받은 서버는 별도의 인증 설정 없이 Object Storage 명령어를 사용할 수 있습니다. 이 경우 Metadata API의 인증키 조회 API를 사용하므로 타임아웃이 발생할 수 있으며, 다음 명령어로 타임아웃을 연장할 수 있습니다. ``` export AWS_METADATA_SERVICE_TIMEOUT=10 ``` ### 구문 `aws`는 다음 구문으로 실행합니다. ``` aws s3 [options] --endpoint-url aws s3api [options] --endpoint-url ``` `s3`는 파일 단위 작업에 최적화된 high-level 명령어이고, `s3api`는 Object Storage API와 1:1로 대응하는 API-level 명령어입니다. 도움말을 확인하는 명령어는 다음과 같습니다. ``` aws help aws help aws help ``` ### 옵션 `aws`에서 공통으로 사용할 수 있는 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--endpoint-url` | String | Required | 명령을 호출할 엔드포인트 URL - 리전별 호출 도메인은 [Object Storage API 가이드](https://api.ncloud-docs.com/docs/storage-objectstorage#%ED%98%B8%EC%B6%9C%EB%8F%84%EB%A9%94%EC%9D%B8Endpoint) 참조 | | `--region` | String | Optional | 리전 - 한국 리전만 지원 | | `--profile` | String | Optional | 자격 증명 파일과 설정 파일에서 사용할 프로필 이름 - 기본값: `default` - 자격 증명 외에 리전, 출력 형식 등 프로필에 저장된 설정도 함께 적용 | | `--no-sign-request` | 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 | 자동 페이지네이션 비활성화 - 결과의 첫 번째 페이지만 조회 | | `--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 | 디버그 로깅 활성화 | ## Object Storage 명령어 `aws` 명령어에서 실행할 수 있는 하위 명령어 목록입니다. ### High-level 파일 단위 작업에 사용하는 `s3` 관련 명령어는 다음과 같습니다. | 명령어 | 설명 | | --- | --- | | [mb](/docs/cli-objectstorage-high-level-mb) | 버킷 생성 | | [ls](/docs/cli-objectstorage-high-level-ls) | 버킷, 폴더 또는 객체 목록 조회 | | [cp](/docs/cli-objectstorage-high-level-cp) | 객체 업로드, 다운로드 및 복사 | | [sync](/docs/cli-objectstorage-high-level-sync) | 디렉터리와 버킷 간 동기화 | | [rm](/docs/cli-objectstorage-high-level-rm) | 객체 삭제 | | [rb](/docs/cli-objectstorage-high-level-rb) | 버킷 삭제 | ### API-level Object Storage API와 1:1로 대응하는 `s3api` 관련 명령어는 다음과 같습니다. | 명령어 | 설명 | | --- | --- | | [create-bucket](/docs/cli-objectstorage-api-level-create-bucket) | 버킷 생성 | | [list-buckets](/docs/cli-objectstorage-api-level-list-buckets) | 버킷 목록 조회 | | [delete-bucket](/docs/cli-objectstorage-api-level-delete-bucket) | 버킷 삭제 | | [get-bucket-cors](/docs/cli-objectstorage-api-level-get-bucket-cors) | 버킷 CORS 규칙 조회 | | [put-bucket-cors](/docs/cli-objectstorage-api-level-put-bucket-cors) | 버킷 CORS 규칙 설정 | | [put-object](/docs/cli-objectstorage-api-level-put-object) | 객체 업로드 | | [get-object](/docs/cli-objectstorage-api-level-get-object) | 객체 다운로드 | | [list-objects](/docs/cli-objectstorage-api-level-list-objects) | 객체 목록 조회 | | [put-object-acl](/docs/cli-objectstorage-api-level-put-object-acl) | 객체 접근 제어 목록 설정 | | [delete-object](/docs/cli-objectstorage-api-level-delete-object) | 객체 삭제 | | [create-multipart-upload](/docs/cli-objectstorage-api-level-create-multipart-upload) | 멀티파트 업로드 시작 | | [upload-part](/docs/cli-objectstorage-api-level-upload-part) | 멀티파트 업로드의 파트 업로드 | | [complete-multipart-upload](/docs/cli-objectstorage-api-level-complete-multipart-upload) | 멀티파트 업로드 완료 | | [list-multipart-uploads](/docs/cli-objectstorage-api-level-list-multipart-uploads) | 진행 중인 멀티파트 업로드 목록 조회 | | [abort-multipart-upload](/docs/cli-objectstorage-api-level-abort-multipart-upload) | 멀티파트 업로드 중단 | ## Object Storage 연관 리소스 Object Storage CLI에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다. - Object Storage CLI 서비스 사용 방법 - [Object Storage 사용 가이드](https://guide.ncloud-docs.com/docs/storage-storage-6-1): 네이버 클라우드 플랫폼 콘솔에서 Object Storage 사용하는 방법 - [Object Storage API 가이드](https://api.ncloud-docs.com/docs/storage-objectstorage): Object Storage API를 호출하는 방법 - [Object Storage 사용 환경 가이드](https://guide.ncloud-docs.com/docs/environment-environment-1-1): VPC, Classic 환경 및 지원 여부에 관한 사용 가이드 - [요금 소개, 특징, 상세 기능](https://www.ncloud.com/product/storage/objectStorage): Object Storage의 요금 체계, 특징, 상세 기능 요약 - [서비스 최신 소식](https://www.ncloud.com/intro/news?categoryCode=STRG&serviceCode=SV_0011): Object Storage 관련 최신 소식 - [자주 하는 질문](https://www.ncloud.com/support/faq/prod?categoryCode2=STRG&categoryCode3=SV_0011): Object Storage 사용자들이 자주 하는 질문 - [고객 지원](https://www.ncloud.com/v2/support/question/service): CLI 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의