--- title: "Archive Storage 개요" slug: "storage-archivestorage" tags: ["Archive Storage"] updated: 2026-10-20T01:48:24Z published: 2026-10-20T03:00:25Z canonical: "api.ncloud-docs.com/storage-archivestorage" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Archive Storage 개요 ## 개요 네이버 클라우드 플랫폼 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://archive-storage-external-api.apigw.ntruss.com | https://archive-storage-external-api.apigw.ntruss.com | ### 인증 Archive Storage는 인증 정보를 통해 토큰을 생성하고, 발급된 토큰으로 서비스를 이용할 수 있습니다. 토큰 생성에 필요한 사용자 정보는 [Ncloud API](https://api.ncloud-docs.com/release-20260917/docs/common-ncpapi)를 참조하여 생성한 API 인증키를 사용해 주십시오. 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 - X-Trans-Id와 동일 | | `Date` | String | - | 해당 요청의 응답 시간(UTC) | ## 오퍼레이션 ### 어카운트 오퍼레이션 어카운트에 속한 컨테이너(버킷) 목록 조회, 메타데이터 조회, 메타데이터 설정·변경 오퍼레이션을 설명합니다. 어카운트는 고유의 project ID를 사용하고 Archive Storage 콘솔에서 이용 신청 후 **[API 이용 정보 확인]** 버튼을 통해 확인할 수 있습니다. | 오퍼레이션 | 설명 | | --- | --- | | [GET](/docs/storage-archivestorage-getaccount) | 어카운트에 속한 컨테이너(버킷) 목록 조회 | | [HEAD](/docs/storage-archivestorage-headaccount) | 어카운트의 메타데이터 조회 | | [POST](/docs/storage-archivestorage-postaccount) | 어카운트에 메타데이터 설정 및 변경 | ### 컨테이너(버킷) 오퍼레이션 컨테이너(버킷)을 생성, 삭제, 조회, 제어하는 오퍼레이션을 설명합니다. | 오퍼레이션 | 설명 | | --- | --- | | [PUT](/docs/storage-archivestorage-putcontainer) | 컨테이너(버킷) 생성 | | [GET](/docs/storage-archivestorage-getcontainer) | 컨테이너(버킷)에 속한 오브젝트 목록 조회 | | [HEAD](/docs/storage-archivestorage-headcontainer) | 컨테이너(버킷)의 메타데이터 조회 | | [POST](/docs/storage-archivestorage-postcontainer) | 컨테이너(버킷)에 메타데이터 설정 및 변경 | | [DELETE](/docs/storage-archivestorage-deletecontainer) | 빈 컨테이너(버킷) 삭제 | ### 오브젝트 오퍼레이션 오브젝트를 생성, 삭제, 조회, 제어하는 오퍼레이션을 설명합니다. | 오퍼레이션 | 설명 | | --- | --- | | [PUT](/docs/storage-archivestorage-putobject) | 오브젝트 업로드 동일한 이름의 오브젝트가 있을 경우 덮어쓰기 | | [COPY](/docs/storage-archivestorage-copyobject) | 다른 위치에 있는 오브젝트 복제 | | [GET](/docs/storage-archivestorage-getobject) | 오브젝트 다운로드 | | [HEAD](/docs/storage-archivestorage-headobject) | 오브젝트의 메타데이터 조회 | | [POST](/docs/storage-archivestorage-postobject) | 오브젝트에 메타데이터를 설정 및 변경함 | | [DELETE](/docs/storage-archivestorage-deleteobject) | 오브젝트 삭제 |