---
title: "PutContainer "
slug: "storage-archivestorage-putcontainer"
tags: ["Archive Storage"]
updated: 2026-10-22T10:47:58Z
published: 2026-10-22T10:47:58Z
canonical: "api-gov.ncloud-docs.com/storage-archivestorage-putcontainer"
---

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

# PutContainer

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

컨테이너(버킷)를 생성합니다.

          참고

          

Subaccount의 경우, Subaccount 전용 External API Gateway를 통해 사용할 수 있습니다. 자세한 내용은 SubAccount의 [PutContainer](/docs/storage-archivestorage-putcontainer-subaccount) API를 참조해 주십시오.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| PUT | /v1/AUTH_{project_id}/{container} |

### 요청 헤더

헤더에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `X-Auth-Token` | String | Required | 발급한 토큰(Token) 값 |
| `X-Container-Read` | String | Optional | 해당 컨테이너(버킷)의 READ ACL(접근 권한) |
| `X-Container-Write` | String | Optional | 해당 컨테이너(버킷)의 WRITE ACL(접근 권한) |
| `X-Container-Sync-Key` | String | Optional | 사용하지 않음 |
| `X-Container-Sync-To` | String | Optional | 사용하지 않음 |
| `X-Versions-Location` | String | Optional | 사용하지 않음 |
| `X-History-Location` | String | Optional | 사용하지 않음 |
| `X-Container-Meta-name` | String | Optional | 해당 컨테이너(버킷)의 메타데이터 - 헤더명의 `name` 부분이 메타데이터의 키 역할을 함 - 추가, 업데이트, 삭제 가능하며, 삭제는 빈 값으로 요청 |
| `X-Container-Meta-Access-Control-Allow-Origin` | String | Optional | CORS 설정 - 접근 가능한 소스 도메인 |
| `X-Container-Meta-Access-Control-Max-Age` | String | Optional | CORS 설정(초) - 결과를 캐싱할 수 있는 최대 시간 |
| `X-Container-Meta-Access-Control-Expose-Headers` | String | Optional | CORS 설정 - 노출되지 않으나 접근을 허용하는 헤더 |
| `X-Container-Meta-Quota-Bytes` | String | Optional | 해당 컨테이너(버킷)의 용량 제한값 |
| `X-Container-Meta-Quota-Count` | String | Optional | 해당 컨테이너(버킷)의 오브젝트 수의 제한값 |
| `X-Container-Meta-Temp-URL-Key` | String | Optional | temporary URL을 위한 Secret Key 값 |
| `X-Container-Meta-Temp-URL-Key-2` | String | Optional | temporary URL을 위한 두 번째 Secret Key 값 |

### 요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `project_id` | String | Required | 프로젝트 ID - 프로젝트 ID 확인 방법은 [Archive Storage 개요](/docs/storage-archivestorage#%EC%9D%B8%EC%A6%9D) 참조 |
| `container` | String | Required | 생성할 컨테이너(버킷) 이름 |

### 요청 예시

요청 예시는 다음과 같습니다.

#### 컨테이너(버킷) 생성 요청

컨테이너(버킷)를 생성하는 요청 예시는 다음과 같습니다.

```
curl -X PUT "https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}" 
-H "X-Auth-Token: $token"
```

#### 메타데이터를 포함한 컨테이너(버킷) 생성 요청

메타데이터를 포함한컨테이너(버킷)를 생성하는 요청 예시는 다음과 같습니다.

```
curl -X POST "https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}" 
-H "X-Auth-Token: $token"
-H "X-Container-Meta-{name}: $container-metadata-string"
```

#### ACL을 포함한 컨테이너(버킷) 생성 요청

ACL을 포함한 컨테이너(버킷)를 생성하는 요청 예시는 다음과 같습니다.

```
curl -X POST "https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}" 
-H "X-Auth-Token: $token"
-H "X-Container-Read: .r:*
```

## 응답

응답 형식을 설명합니다.

### 응답 헤더

Archive Storage API에서 공통으로 사용하는 응답 헤더에 대한 자세한 내용은 [Archive Storage 공통 응답 헤더](/docs/storage-archivestorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
| --- | --- | --- | --- |
| 200 | - | OK | 요청 성공 |
| 204 | - | No Content | Content-Type이 `plain`이고, 요청에 해당되는 내용이 없는 경우 발생 |
| 403 | - | Not Found | 컨테이너(버킷)이 존재하지 않는 경우 발생 |

### 응답 예시

응답 예시는 다음과 같습니다.

#### 컨테이너 생성을 요청한 경우의 응답

컨테이너 생성을 요청했을 때의 응답 예시는 다음과 같습니다.

```
HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txa8b5404ac864437293727-005b9878d1
X-Openstack-Request-Id: txa8b5404ac864437293727-005b9878d1
Date: Wed, 12 Sep 2018 02:24:17 GMT
```

#### 메타데이터를 포함한 컨테이너 생성을 요청한 경우의 응답

메타데이터를 포함한 컨테이너 생성을 요청했을 때의 응답 예시는 다음과 같습니다.

```
HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx8282719a30554e2b8e0c7-005b987946
X-Openstack-Request-Id: tx8282719a30554e2b8e0c7-005b987946
Date: Wed, 12 Sep 2018 02:26:14 GMT
```

#### ACL을 포함한 컨테이너 생성을 요청한 경우의 응답

ACL을 포함한 컨테이너 생성을 요청했을 때의 응답 예시는 다음과 같습니다.

```
HTTP/1.1 201 Created
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx691a8ed48a3f4152ae904-005b98799c
X-Openstack-Request-Id: tx691a8ed48a3f4152ae904-005b98799c
Date: Wed, 12 Sep 2018 02:27:41 GMT
```