帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

PUT Bucket

创建一个新的存储空间,创建成功后,空间的 owner 就是 API 调用者。

存储空间的名称有一定的要求:

  • 遵守 DNS 命名规则。
  • 长度在 6 ~ 63 之间。
  • 只能包含 小写字母,数字和连接字符 -
  • 只能以小写字母或数字开头或结尾。
  • 不能是有效 IP 地址。

如下面的是合法名称:

  • [√] mybucket
  • [√] my-bucket

下面的是非法名称:

  • [X] Invalid Bucket
  • [X] .mybucket
  • [X] mybucket-
  • [X] my_bucket

匿名无法调用此 API ,请先注册青云并创建 Access Key 。

Request Syntax

PUT / HTTP/1.1
Host: <bucket-name>.<zone-id>.qingstor.com
Date: <date>
Authorization: <authorization-string>

Request Parameters

没有请求参数

Request Headers

参见公共请求头

Status Code

成功则返回 201; 若 Bucket 已存在则 409 bucket_already_exists. Bucket 个数配额超出限制(可通过发工单提高) 返回 403 too_many_buckets. 其他失败的返回码参考错误码列表

Request Body

没有请求消息体

Response Headers

参见公共响应头

Example

Example Request

PUT / HTTP/1.1
Host: mybucket.pek3a.qingstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
Authorization: authorization string

Example Response

HTTP/1.1 201 CREATED
Server: QingStor
Date: Sun, 16 Aug 2015 09:05:00 GMT
Content-Length: 0
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b