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
- git: aws-cli 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를 참조하여 생성한 API 인증키를 사용합니다.
Role을 부여받은 서버는 별도의 인증 설정 없이 Object Storage 명령어를 사용할 수 있습니다. 이 경우 Metadata API의 인증키 조회 API를 사용하므로 타임아웃이 발생할 수 있으며, 다음 명령어로 타임아웃을 연장할 수 있습니다.
```
export AWS_METADATA_SERVICE_TIMEOUT=10
```

구문

aws는 다음 구문으로 실행합니다.

aws s3 <subcommand> [options] --endpoint-url <endpoint-url>
aws s3api <subcommand> [options] --endpoint-url <endpoint-url>

s3는 파일 단위 작업에 최적화된 high-level 명령어이고, s3api는 Object Storage API와 1:1로 대응하는 API-level 명령어입니다.

도움말을 확인하는 명령어는 다음과 같습니다.

aws help
aws <command> help
aws <command> <subcommand> help

옵션

aws에서 공통으로 사용할 수 있는 옵션입니다.

옵션	타입	필수 여부	설명
`--endpoint-url`	String	Required	명령을 호출할 엔드포인트 URL 리전별 호출 도메인은 Object Storage API 가이드 참조
`--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	버킷 생성
ls	버킷, 폴더 또는 객체 목록 조회
cp	객체 업로드, 다운로드 및 복사
sync	디렉터리와 버킷 간 동기화
rm	객체 삭제
rb	버킷 삭제

API-level

Object Storage API와 1:1로 대응하는 s3api 관련 명령어는 다음과 같습니다.

명령어	설명
create-bucket	버킷 생성
list-buckets	버킷 목록 조회
delete-bucket	버킷 삭제
get-bucket-cors	버킷 CORS 규칙 조회
put-bucket-cors	버킷 CORS 규칙 설정
put-object	객체 업로드
get-object	객체 다운로드
list-objects	객체 목록 조회
put-object-acl	객체 접근 제어 목록 설정
delete-object	객체 삭제
create-multipart-upload	멀티파트 업로드 시작
upload-part	멀티파트 업로드의 파트 업로드
complete-multipart-upload	멀티파트 업로드 완료
list-multipart-uploads	진행 중인 멀티파트 업로드 목록 조회
abort-multipart-upload	멀티파트 업로드 중단

Object Storage 연관 리소스

Object Storage CLI에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.

Object Storage CLI 서비스 사용 방법
- Object Storage 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 Object Storage 사용하는 방법
- Object Storage API 가이드: Object Storage API를 호출하는 방법
- Object Storage 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 관한 사용 가이드
- 요금 소개, 특징, 상세 기능: Object Storage의 요금 체계, 특징, 상세 기능 요약
- 서비스 최신 소식: Object Storage 관련 최신 소식
- 자주 하는 질문: Object Storage 사용자들이 자주 하는 질문
- 고객 지원: CLI 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의