- 인쇄
- PDF
Archive Storage 개요
- 인쇄
- PDF
개요
네이버 클라우드 플랫폼 Archive Storage는 스토리지 관리와 사용에 필요한 OpenStack Swift API를 제공합니다.
버전: 2.15.1 (Pike)
Subaccount의 경우 일부 API는 기존 호출 도메인이 아닌 Subaccount 전용 External API Gateway를 통해 사용할 수 있습니다.
공통 설정
호출 도메인(Endpoint)
HTTP/HTTPS 프로토콜을 모두 지원하지만 데이터 보호를 위해 HTTPS 사용을 권장합니다.
리전별 URL
리전 | 인증 URL | 서비스 URL |
---|---|---|
한국 | https://kr.archive.ncloudstorage.com:5000 | https://kr.archive.ncloudstorage.com |
한국 | https://archivestorage.apigw.ntruss.com/swift/v1 | https://archivestorage.apigw.ntruss.com/swift/v1 |
한국 | https://archive-storage-external-api.apigw.ntruss.com | https://archive-storage-external-api.apigw.ntruss.com |
인증
네이버 클라우드 플랫폼 Archive Storage는 인증 정보를 통해 토큰을 생성하고 발급된 토큰으로 서비스를 이용할 수 있습니다.
토큰 생성에 필요한 유저 정보는 포탈 마이페이지 > 계정 관리 > 인증키 관리에서 생성한 API 인증키를 사용하고 (Access Key ID는 user name, Secret Key는 user password)
유저가 속한 project ID와 domain ID 정보는 Archive Storage 콘솔에서 이용 신청 후 [API 이용 정보 확인] 버튼을 통해 확인할 수 있습니다.
아래는 OpenStack Swift API를 사용하여 네이버 클라우드 플랫폼 Archive Storage에 접근할 때 사용할 수 있는 모든 오퍼레이션을 설명합니다.
예를 포함하여 오퍼레이션 사용법에 대한 추가 정보를 확인하려면 버킷 오퍼레이션, 오브젝트 오퍼레이션 페이지를 참고하세요.
요청 헤더
Archive Storage API에서 공통으로 사용하는 요청 헤더를 소개합니다.
헤더 | 설명 |
---|---|
X-Auth-Token | String |
응답 헤더
Archive Storage API에서 공통으로 사용하는 응답 헤더를 소개합니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
Content-Type | String | - | 응답 결과의 MIME 타입 |
Content-Length | String | - | 응답 결과의 길이 (Bytes) |
X-Trans-Id | String | - | 해당 요청의 트랜잭션 ID |
X-Openstack-Request-Id | String | - | 해당 요청의 트랜잭션 ID
|
Date | String | - | 해당 요청의 응답 시간(UTC) |
오퍼레이션
어카운트 오퍼레이션
어카운트에 속한 컨테이너(버킷) 목록 조회, 메타데이터 조회, 메타데티어 설정을 조회하는 오퍼레이션을 설명합니다.
어카운트는 고유의 project ID를 사용하고 Archive Storage 콘솔에서 이용 신청 후 [API 이용 정보 확인] 버튼을 통해 확인할 수 있습니다.
오퍼레이션 | 설명 |
---|---|
GET | 어카운트에 속한 컨테이너(버킷) 목록 조회 |
HEAD | 어카운트의 메타데이터 조회 |
POST | 어카운트에 메타데이터 설정 및 변경 |
컨테이너(버킷) 오퍼레이션
컨테이너(버킷)을 생성, 삭제, 조회, 제어하는 오퍼레이션을 설명합니다.
오퍼레이션 | 설명 |
---|---|
PUT | 컨테이너(버킷) 생성 |
GET | 컨테이너(버킷)에 속한 오브젝트 목록 조회 |
HEAD | 컨테이너(버킷)의 메타데이터 조회 |
POST | 컨테이너(버킷)에 메타데이터 설정 및 변경 |
DELETE | 빈 컨테이너(버킷) 삭제 |
오브젝트 오퍼레이션
오브젝트를 생성, 삭제, 조회, 제어하는 오퍼레이션을 설명합니다.
오퍼레이션 | 설명 |
---|---|
PUT | 오브젝트 업로드 동일한 이름의 오브젝트가 있을 경우 덮어쓰기 |
COPY | 다른 위치에 있는 오브젝트 복제 |
GET | 오브젝트 다운로드 |
HEAD | 오브젝트의 메타데이터 조회 |
POST | 오브젝트에 메타데이터를 설정 및 변경함 |
DELETE | 오브젝트 삭제 |