PutBucket

Prev Next

Available in Classic and VPC

Create a bucket in Object Storage. No request query parameter or request body is used in the operation.

Requests

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

Method URI
PUT {bucket-name}

Request syntax

The request syntax is as follows.

PUT https://{endpoint}/{bucket-name} # path style
PUT https://{bucket-name}.{endpoint} # virtual host style

Request path parameters

The following describes the parameters.

Field Type Required Description
bucket-name String Required Name of the bucket to create
  • Need a unique, DNS-compliant name
  • 3 to 63 characters, allowing lowercase English letters, numbers, special characters "-" and ".", and must begin and end with a lowercase English letter or number
  • Names in the form of IP addresses are not allowed
  • Up to 1000

Request headers

For headers common to all Object Storage APIs, see Object Storage common headers.

Request example

The following is a sample request.

PUT /{bucket-name} HTTP/1.1
Content-Type: text/plain
Host: kr.object.ncloudstorage.com
X-Amz-Date: {Timestamp}
Authorization: {authorization-string}

Responses

The following describes the response format.

Response headers

For response headers common to all Object Storage APIs, see Object Storage common response headers.

Response status codes

For response status codes common to all Object Storage APIs, see Object Storage response status codes.

Response example

The following is a sample response.

HTTP/1.1 200 OK
Date: Thu, 04 Apr 2024 04:51:44 GMT
Accept-Ranges: bytes
x-amz-request-id: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
Content-Length: 0