---
title: "PostContainer"
slug: "storage-archivestorage-postcontainer-subaccount"
tags: ["Archive Storage"]
updated: 2026-09-17T10:12:27Z
published: 2026-09-17T10:12:27Z
canonical: "api.ncloud-docs.com/storage-archivestorage-postcontainer-subaccount"
---

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

# PostContainer

Available in Classic and VPC

Set or change metadata on a container (bucket).

## Request

This section describes the request format. The method and URI are as follows:

| Method | URI |
| --- | --- |
| POST | /{containerName} |

### Request headers

The following describes the headers.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `x-ncp-apigw-timestamp` | String | Required | Timestamp value - It indicates the elapsed time in milliseconds since January 1, 1970 00:00:00 UTC. - Request is considered invalid if the timestamp differs from the current time by more than 5 minutes. |
| `x-ncp-iam-access-key` | String | Required | API key issued by NAVER Cloud Platform or access key issued by Sub Account |
| `x-ncp-apigw-signature-v2` | String | Required | Signature used to encrypt the body of the above example with the secret key that maps with the access key ID - Use the HMAC-SHA256 encryption algorithm. |
| `x-ncp-region_code` | String | Required | Region code of the container - e.g., Korea: `KR` \| Singapore: `SGN` |
| `X-Container-Meta-Access-Control-Allow-Origin` | String | Optional | CORS setting - Accessible source domain |
| `X-Container-Meta-Access-Control-Max-Age` | String | Optional | CORS setting - Maximum time to cache results (in seconds) |
| `X-Container-Meta-Access-Control-Expose-Headers` | String | Optional | CORS setting - Header that is not visible but allows access |

### Request path parameters

The following describes the parameters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `containerName` | String | Required | Name of the container (bucket) to set or edit |

### Request example

The request example is as follows:

```
curl -X POST "https://archive-storage-external-api.apigw.ntruss.com/{containerName}" -H "accept: application/json" -H "X-Container-Meta-Access-Control-Allow-Origin: http://localhost" -H "x-ncp-region-code: {regionCode}"
-H "x-ncp-iam-access-key: {AccessKey} "
-H "x-ncp-apigw-timestamp: {current timestamp}"
-H "x-ncp-apigw-signature-v2: {generated signature}"
```

## Response

This section describes the response format.

### Response headers

The following describes the headers.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `Server` | String | - | Response server |
| `Date` | String | - | Response time of the request (UTC) |
| `Connection` | String | - | TCP connection status between client and server |
| `X-Storage-Policy` | Integer | - | Storage policy value for the container |
| `X-Timestamp` | Integer | - | Creation time of the container (Unix timestamp) |
| `X-Container-Bytes-Used` | Integer | - | Amount of capacity the container is using |
| `X-Trans-Id` | String | - | Transaction ID of the request |
| `X-Openstack-Request-Id` | String | - | Transaction ID of the request - Identical to `X-Trans-Id` |
| `X-Container-Object-Count` | Integer | - | Number of objects stored in the container |
| `X-Container-Meta-Access-Control-Allow-Origin` | String | - | CORS settings - Entered accessible domains |
| `Referrer-Policy` | String | - | HTTP Referrer header handling method |
| `x-ncp-apigw-response-origin` | String | - | Original source of the response |
| `x-ncp-trace-id` | String | - | ID for transaction tracking |

### Response example

The response example is as follows:

```
HTTP/1.1 204 No Content
Server: nginx
Date: Tue, 16 Apr 2024 01:56:58 GMT
Connection: keep-alive
X-Storage-Policy: standard00
X-Timestamp: 1711960998.26335
X-Container-Bytes-Used: 0
X-Openstack-Request-Id: txf770951820a44a91bc450-00661de4f8
X-Container-Object-Count: 0
X-Container-Meta-Access-Control-Allow-Origin: http://localhost
X-Trans-Id: txf770951820a44a91bc450-00661de4f8
Referrer-Policy: unsafe-url
x-ncp-trace-id: 6cd9l6lj66d356cchgc4rjcc1o
x-ncp-apigw-response-origin: ENDPOINT
```