---
title: "PostContainer"
slug: "storage-archivestorage-postcontainer-subaccount"
tags: ["Archive Storage"]
updated: 2026-09-17T09:58:32Z
published: 2026-09-17T09:58:32Z
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

Classic/VPC環境で利用できます。

コンテナ(バケット)にメタデータを設定したり、変更したりします。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| POST | /{containerName} |

### リクエストヘッダ

ヘッダの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `x-ncp-apigw-timestamp` | String | Required | タイムスタンプの値 - 1970年1月1日 00:00:00協定世界時(UTC)からの経過時間をミリ秒で表したもの - API Gatewayサーバとの時間差が5分以上の場合は有効ではないリクエストとみなす |
| `x-ncp-iam-access-key` | String | Required | NAVERクラウドプラットフォームで発行された API Keyまたは Sub Accountで発行された Access Key |
| `x-ncp-apigw-signature-v2` | String | Required | Bodyを Access Key IDとマッピングする Secret Keyで暗号化した署名 - HMACの暗号化アルゴリズムは HmacSHA256を使用 |
| `x-ncp-region_code` | String | Required | コンテナのリージョンコード - <例> 韓国: `KR` \| シンガポール: `SGN` |
| `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設定 - 公開はされないが、アクセスを許可するヘッダ |

### リクエストパスパラメータ

パラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `containerName` | String | Required | 設定または変更するコンテナ(バケット)の名前 |

### リクエスト例

リクエストのサンプルコードは次の通りです。

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

## レスポンス

レスポンス形式を説明します。

### レスポンスヘッダ

ヘッダの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `Server` | String | - | レスポンスサーバ |
| `Date` | String | - | リクエストのレスポンスタイム(UTC) |
| `Connection` | String | - | クライアントとサーバ間の TCP接続状態 |
| `X-Storage-Policy` | Integer | - | コンテナのストレージポリシーの値 |
| `X-Timestamp` | Integer | - | コンテナが作成された時刻(Unix Timestamp) |
| `X-Container-Bytes-Used` | Integer | - | コンテナが使用中の容量 |
| `X-Trans-Id` | String | - | リクエストのトランザクション ID |
| `X-Openstack-Request-Id` | String | - | リクエストのトランザクション ID - `X-Trans-Id`と同じ |
| `X-Container-Object-Count` | Integer | - | コンテナに保存されているオブジェクト数 |
| `X-Container-Meta-Access-Control-Allow-Origin` | String | - | CORS設定 - 入力されたアクセス可能なドメイン |
| `Referrer-Policy` | String | - | HTTP Referrerヘッダの処理方式 |
| `x-ncp-apigw-response-origin` | String | - | レスポンスの原本の出典 |
| `x-ncp-trace-id` | String | - | トランザクショントレース用 ID |

### レスポンス例

レスポンスのサンプルコードは次の通りです。

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