---
title: "PutContainer"
slug: "storage-archivestorage-putcontainer"
tags: ["Archive Storage"]
updated: 2026-09-17T09:58:32Z
published: 2026-09-17T09:58:32Z
canonical: "api.ncloud-docs.com/storage-archivestorage-putcontainer"
---

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

# PutContainer

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

コンテナ(バケット)を作成します。

              参考

              

Subaccountの場合、Subaccount専用の External API Gatewayを通じて使用できます。 詳細は、SubAccountの[PutContainer](/docs/ja/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のための2番目の Secret Key値 |

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

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `project_id` | String | Required | プロジェクト ID - プロジェクト IDの確認方法は、[Archive Storageの概要](/docs/ja/storage-archivestorage#%EC%9D%B8%EC%A6%9D)を参照 |
| `container` | String | Required | 作成するコンテナ(バケット)の名前 |

### リクエスト例

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

#### コンテナ(バケット)の作成リクエスト

コンテナ(バケット)を作成するリクエストのサンプルコードは次の通りです。

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

#### メタデータを含むコンテナ(バケット)の作成リクエスト

メタデータを含むコンテナ(バケット)を作成するリクエストのサンプルコードは次の通りです。

```
curl -X POST "https://kr.archive.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.ncloudstorage.com/v1/AUTH_{project_id}" 
-H "X-Auth-Token: $token"
-H "X-Container-Read: .r:*
```

## レスポンス

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

### レスポンスヘッダ

Archive Storage APIで共通して使用されるレスポンスヘッダの詳細は、[Archive Storageの共通レスポンスヘッダ](/docs/ja/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
```