---
title: "PutContainer"
slug: "storage-archivestorage-putcontainer"
tags: ["Archive Storage"]
updated: 2026-09-17T10:12:27Z
published: 2026-09-17T10:12:27Z
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

Available in Classic and VPC

Create a container (bucket).

              Note

              

Sub accounts can use it through the external API Gateway dedicated to sub accounts. For more information, see the [PutContainer](/docs/en/storage-archivestorage-putcontainer-subaccount) API of Sub Account.

## Requests

The following describes the request format for the endpoint. The request format is as follows.

| Method | URI |
| --- | --- |
| PUT | /v1/AUTH_{project_id}/{container} |

### Request headers

The following describes the headers.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Auth-Token` | String | Required | Value of the issued token |
| `X-Container-Read` | String | Optional | READ ACL (access permissions) of the container (bucket) |
| `X-Container-Write` | String | Optional | WRITE ACL (access permissions) of the container (bucket) |
| `X-Container-Sync-Key` | String | Optional | Not used |
| `X-Container-Sync-To` | String | Optional | Not used |
| `X-Versions-Location` | String | Optional | Not used |
| `X-History-Location` | String | Optional | Not used |
| `X-Container-Meta-name` | String | Optional | Metadata for the container (bucket) - The `name` part of the header name acts as a key for metadata - It can be added, updated, or deleted, with deletion requested as an empty value |
| `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 (in seconds) - Maximum time to cache results |
| `X-Container-Meta-Access-Control-Expose-Headers` | String | Optional | CORS setting - Header that is not visible but allows access |
| `X-Container-Meta-Quota-Bytes` | String | Optional | Capacity limit of the container (bucket) |
| `X-Container-Meta-Quota-Count` | String | Optional | Limit for number of objects in the container (bucket) |
| `X-Container-Meta-Temp-URL-Key` | String | Optional | Secret key value for the temporary URL |
| `X-Container-Meta-Temp-URL-Key-2` | String | Optional | Second secret key value for the temporary URL |

### Request path parameters

The following describes the parameters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `project_id` | String | Required | Project ID - For more information on how to check the project ID, see [Archive Storage overview](/docs/en/storage-archivestorage#%EC%9D%B8%EC%A6%9D) |
| `container` | String | Required | Name of the container (bucket) to create |

### Request example

The following is a sample request.

#### Request creation of container (bucket)

The following is a sample request of creating a container (bucket).

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

#### Request creation of container (bucket) with metadata

The following is a sample request of creating a container (bucket) that includes metadata.

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

#### Request creation of container (bucket) with ACL

The following is a sample request of creating a container (bucket) including an ACL.

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

## Responses

The following describes the response format.

### Response headers

For response headers common to all Archive Storage APIs, see [Archive Storage common response headers](/docs/en/storage-archivestorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94).

### Response status codes

The following describes the response status codes.

| HTTP status code | Code | Message | Description |
| --- | --- | --- | --- |
| 200 | - | OK | Request succeeded |
| 204 | - | No Content | It occurs when the Content-Type is `plain` and there is nothing in the request |
| 403 | - | Not Found | It occurs when the container (bucket) doesn't exist |

### Response example

The following is a sample response.

#### Response when requesting creation of container

The following is a sample response when requesting a container creation.

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

#### Response when requesting creation of container with metadata

The following is a sample response when requesting a container creation with metadata.

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

#### Response when requesting creation of container with ACL

The following is a sample response when requesting a container creation with 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
```