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 For more information on how to check the project ID, see Archive Storage overview
`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