创建存储桶

此PUT操作用于创建新的存储桶，此接口不支持匿名访问。

创建存储桶需要遵循DNS命名规则：

• 存储桶名称的长度必须介于 3 到 63 个字符之间。

• 存储桶名称只允许包含小写字母、数字和连字符（-），且必须以小写字母或者数字开头和结尾。

• 存储桶名称不得采用 IP 地址格式（例如，192.168.5.4）。

以下示例是有效的存储桶名称：

• my-bucket

• mybucket123

• 123mybucket

以下示例是无效的存储桶名称：

• -mybucket 存储桶名称不能以连字符 (-) 开始。

• mybucket- 存储桶名称不能以连字符 (-) 结束。

• my.bucket 存储桶名称不能包含句点(.)。

请求

• 请求语法

  • 内容

      PUT / HTTP/1.1
      Host: {BucketName}.{Endpoint}
      Content-Length: {length}
      Date: {date}
      Authorization: {SignatureValue} 
      <?xml version="1.0" encoding="UTF-8"?>
      <CreateBucketConfiguration>
        <LocationConstraint>{BucketRegion}</LocationConstraint>
      </CreateBucketConfiguration>    
    

  • 描述

      Endpoint：参考与region地域的关系
      SignatureValue：参考签名算法
    

• 请求参数

  无

• 非公共请求头

• 请求体

响应

• 非公共响应头

  无

• 响应体

  无

示例

• 请求

    PUT / HTTP/1.1
    Host: oss-example.oss-cn-beijing.inspurcloud.com
    Content-Length:0
    x-oss-acl: private
    Date: Wed, 28 Oct 2019 22:32:00 GMT
    Authorization: authorization string    
  

• 响应

    HTTP/1.1 200 OK
    Date: Wed, 28 Oct 2019 22:32:00 GMT
    Content-Length: 0
    Connection: keep-alive                                                        
  

错误码