AWS S3 API
- 인쇄
- PDF
AWS S3 API
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
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로 사용합니다.
참고
- 오퍼레이션 사용 방법에 대한 자세한 정보는 Object Storage API 가이드를 참조해 주십시오.
- API 인증키를 생성하고 확인하는 방법은 API 인증키 생성 및 확인을 참조해 주십시오.
오퍼레이션
네이버 클라우드 플랫폼의 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를 사용합니다.
- 디렉터리(폴더) 오브젝트의 이름 끝에 '/'를 사용하지 않을 것을 권장합니다.
이 문서가 도움이 되었습니까?