PutContainer

Prev Next

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

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