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

> ## 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.

# PostContainer

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

컨테이너(버킷)에 메타데이터를 설정하거나 변경합니다.

          참고

          

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

## 요청

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

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

### 요청 헤더

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `X-Auth-Token` | String | Optional | 발급한 토큰(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-Remove-Versions-Location` | String | Optional | 사용하지 않음 |
| `X-Remove-History-Location` | String | Optional | 사용하지 않음 |
| `X-Container-Meta-name` | String | Optional | 해당 컨테이너(버킷)의 메타데이터 - 헤더명의 `name` 부분이 메타데이터의 키 역할을 함 - 추가, 업데이트, 삭제 가능하며, 삭제는 빈 값으로 요청 |
| `X-Remove-Container-Meta-name` | String | Optional | 해당 컨테이너(버킷)의 메타데이터 삭제 - 헤더명의 `name` 부분이 메타데이터의 키 역할을 함 - `X-Remove-Container-Read` 혹은 `X-Remove-Container-Meta-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 POST "https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}" 
-H "X-Auth-Token: $token"
-H "X-Container-Meta-{name}: $container-metadata-string"
```

#### 컨테이너 메타데이터 업데이트 요청

컨테이너의 메타데이터를 업데이트하는 요청 예시는 다음과 같습니다.

```
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"
```

#### 컨테이너 메타데이터 삭제 요청

컨테이너의 메타데이터를 삭제하는 요청 예시는 다음과 같습니다.

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

## 응답

응답 형식을 설명합니다.

### 응답 헤더

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

### 응답 예시

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

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

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

```
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txefe14b178c56469b8576f-005b987d66
X-Openstack-Request-Id: txefe14b178c56469b8576f-005b987d66
Date: Wed, 12 Sep 2018 02:43:50 GMT
```

#### 컨테이너 메타데이터 업데이트를 요청한 경우의 응답

컨테이너의 메타데이터 업데이트를 요청했을 때의 예시는 다음과 같습니다.

```
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx66932a917b854a458544a-005b987d78
X-Openstack-Request-Id: tx66932a917b854a458544a-005b987d78
Date: Wed, 12 Sep 2018 02:44:08 GMT
```

#### 컨테이너 메타데이터 삭제를 요청한 경우의 응답

컨테이너의 메타데이터 삭제를 요청했을 때의 예시는 다음과 같습니다.

```
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx590d9493661147e780d99-005b987df5
X-Openstack-Request-Id: tx590d9493661147e780d99-005b987df5
Date: Wed, 12 Sep 2018 02:46:13 GMT
```