AWS S3 API

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

AWS S3에서 제공하는 API를 이용하여 네이버 클라우드 플랫폼의 Archive Storage를 사용하는 예제입니다. 이 가이드에서는 Amazon S3 v2006-03-01 버전을 기준으로 설명합니다.

참고
  • S3 API는 기본적인 기능만 지원하므로 제한적인 용도(Get/Listing)로만 사용할 것을 권장합니다. 이 가이드에서 안내하는 다른 SDK나 콘솔을 사용하면 더 안정적인 환경에서 Archive Storage를 사용할 수 있습니다.
  • 대용량 오브젝트 관리 시 S3 API가 불안정하게 동작할 수 있습니다. 대용량 오브젝트를 관리해야 할 경우에는 대용량 파일 관리를 참조해 주십시오.

호출 도메인(Endpoint)

HTTP/HTTPS 프로토콜을 모두 지원하지만 데이터 보호를 위해 HTTPS 프로토콜을 사용할 것을 권장합니다.

리전별 호출 도메인은 다음과 같습니다.

리전 리전 이름 호출 도메인
한국 kr https://kr.archive.ncloudstorage.com
참고

리전 이름은 소문자로 입력해야 합니다.

인증키(Credential)

네이버 클라우드 플랫폼 포털에서 생성한 API 인증키를 사용합니다. API 인증키 정보에서 Access Key ID는 user name, Secret Key는 user password로 사용합니다.

참고

오퍼레이션

네이버 클라우드 플랫폼의 Archive Storage에서는 일부 S3 API 만 제공합니다. 지원하는 오퍼레이션은 다음과 같습니다.

계정 관련 오퍼레이션

계정 레벨에서는 해당 계정에 속한 버킷 목록을 조회하는 오퍼레이션만 지원합니다.
계정 관련 오퍼레이션은 다음과 같습니다.

오퍼레이션 설명
GET account 계정에 속한 버킷 목록 조회

버킷 오퍼레이션

버킷을 생성, 삭제, 조회, 제어하는 오퍼레이션은 다음과 같습니다.

오퍼레이션 설명
DELETE Bucket 빈 버킷 삭제
GET Bucket 버킷에 포함된 오브젝트 조회. 한 번에 최대 1,000개의 오브젝트가 나열됨
HEAD Bucket 버킷 헤더 조회
GET multipart uploads 완료되지 않았거나 취소된 멀티 파트 업로드 조회
PUT Bucket 버킷 생성. 계정당 버킷 개수는 1,000개로 제한
참고

버킷 내의 오브젝트 목록 조회 GET Bucket (List Objects) Version 2는 지원하지 않습니다.

오브젝트 오퍼레이션

오브젝트를 생성, 삭제, 조회, 제어하는 오퍼레이션은 다음과 같습니다.

오퍼레이션 설명
DELETE Object 버킷에서 오브젝트 삭제
DELETE Multiple Objects 버킷에서 멀티파트 오브젝트 삭제
GET Object 버킷에서 오브젝트 조회
HEAD Object 오브젝트 헤더 조회
PUT Object 버킷에 오브젝트 추가
PUT Object (Copy) 오브젝트 복사본 생성
Initiate Multipart Upload 업로드할 파트 집합에 지정할 업로드 ID 생성
Upload Part 업로드 ID와 연관된 오브젝트의 파트 업로드
Upload Part (Copy) 업로드 ID와 연관된 기존 오브젝트의 파트 업로드
Complete Multipart Upload 업로드 ID와 연관된 파트로 분리된 오브젝트 결합
Abort Multipart Upload 업로드를 중단하고 업로드 ID와 연관된 파트 삭제
List Parts 업로드 ID와 연관된 파트 목록 반환
주의
  • Archive Storage에서 디렉터리(폴더) 오브젝트의 content-type은 application/directory를 사용합니다.
  • 디렉터리(폴더) 오브젝트의 이름 끝에 '/'를 사용하지 않을 것을 권장합니다.