CreateBucket

Available in Classic and VPC

Create a Ncloud Storage bucket.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
PUT	-

Note

For more information on how to create the bucket name (Bucket) and Region code (regionCode), see Ncloud Storage API URL.

Request headers

The following describes the request headers.

Note

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage request headers.

Field	Required	Description
`x-amz-bucket-object-lock-enabled`	Optional	Whether object lock is enabled `true` \| `false` (default) `true`: Enable object lock when creating a bucket. `true` also enables version control.
`Content-MD5`	Optional	Base64-encoded 128-bit MD5 hash of the request body Used to verify the integrity of the request body.
`x-amz-checksum-*`	Optional	Checksum hash value Enter the used algorithm in `*` of the key. Supported algorithms: `crc32` \| `crc32c` \| `sha1` \| `sha256` \| `crc64nvme`

Request body

You can include the following data in the body of your request:

Field	Type	Required	Description
`CreateBucketConfiguration`	Object	Required	Created bucket information
`CreateBucketConfiguration.LocationConstraint`	String	Optional	Region code If not entered, the `regionCode` included in the host is automatically applied.

Request example

The request example is as follows:

PUT / HTTP/1.1
Host: bucket.kr.ncloudstorage.com

<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <LocationConstraint>kr</LocationConstraint>
</CreateBucketConfiguration>

Response

This section describes the response format.

Response status codes

For information about the HTTP status codes common to all Ncloud Storage APIs, see Common Ncloud Storage response status codes.

Response example

The response example is as follows:

HTTP/1.1 200 OK
Location: "/bucket"

Documentation Index