---
title: "AWS S3 API"
slug: "archivestorage-s3api"
tags: ["AWS S3 API", "Archive Storage"]
updated: 2026-09-17T09:08:22Z
published: 2026-09-17T09:08:22Z
canonical: "guide.ncloud-docs.com/archivestorage-s3api"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS S3 API

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

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

          참고

          

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

## 호출 도메인(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 가이드](https://api.ncloud-docs.com/docs/storage-objectstorage)를 참조해 주십시오.
- API 인증키를 생성하고 확인하는 방법은 [API 인증키 생성 및 확인](/docs/archivestorage-start#API%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1%EB%B0%8F%ED%99%95%EC%9D%B8)을 참조해 주십시오.

## 오퍼레이션

네이버 클라우드 플랫폼의 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를 사용합니다.
- 디렉터리(폴더) 오브젝트의 이름 끝에 '/'를 사용하지 않을 것을 권장합니다.