S3 API

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

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

네이버 클라우드 플랫폼[공공기관용] Archive Storage API 소개

네이버 클라우드 플랫폼[공공기관용] Archive Storage는 스토리지 관리와 사용에 필요한 S3 API를 제공합니다.

버전: Amazon S3 v2006-03-01

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

리전별 호출 도메인

리전	리전 이름	호출 도메인
공공	kr	https://kr.archive.gov-ncloudstorage.com

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

포탈 마이페이지 > 계정 관리 > 인증키 관리에서 생성한 API 인증키를 사용합니다.
네이버 클라우드 플랫폼[공공기관용] Archive Storage에서는 일부 S3 API 만을 제공하며 사용할 수 있는 오퍼레이션을 아래에서 설명합니다.

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

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

버킷을 생성, 삭제, 조회, 제어하는 오퍼레이션을 설명합니다.

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

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

오브젝트를 생성, 삭제, 조회, 제어하는 오퍼레이션을 설명합니다.

오퍼레이션	설명
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를 사용합니다. 또한 디렉터리(폴더) 오브젝트 이름 마지막에 "/" 사용하지 않는 것을 권장합니다.

참고

상기 S3 API 들은 기본적인 기능만을 지원하므로 Get / Listing 등 제한적인 용도로 사용하시기 권고드리며 본 가이드에서 안내하는 SDK나 콘솔을 사용하시길 권장합니다.
특히 대용량 오브젝트의 관리 시 S3 API로는 불완전하게 동작할 수 있습니다. (DLO가이드, SLO 가이드 참조)

이 문서가 도움이 되었습니까?

태그