点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>

天翼云对象存储（经典版）I型API参考-HTTP REST接口PUT Bucket

PUT Bucket操作可以用来：

• 创建一个新的Bucket；
  

• 对已有Bucket的Bucket ACL进行修改；
  

• 对数据位置进行修改，但是不能修改索引位置（香港节点不支持）。
  

只有根用户和具有PUT Bucket权限的子用户才能创建Bucket。

Bucket的命名规范如下：

• Bucket名称必须全局唯一；
  

• Bucket名称长度介于3到63字节之间；
  

• Bucket名称只能由小写字母、数字、短横线（-）和点（.）组成；
  

• Bucket名称可以由一个或者多个小节组成，小节之间用点（.）隔开，各个小节需要：
  

• 只能包含小写字母、数字和短横线（-）。

• 必须以小写字母或者数字开始；
  

• 必须以小写字母或者数字结束。
  

• Bucket名称不能是IP地址形式（如192.162.0.1）；
  

• Bucket名称不能是一组或多组“数字.数字”的组合；
  

• Bucket名称中不能包含双点（..）、横线点（-.）和点横线（.-）；
  

• 不允许使用非法敏感字符，例如暴恐涉政相关信息等。
  

注意：香港节点只有请求头，没有请求体。

请求语法

请求元素

注意：香港节点不支持下列请求元素。

请求参数

请求示例1

请求创建一个名叫picture的bucket，索引位置设置为LaSa，数据位置设置为优先本地，bucket权限设置为公有。

PUT / HTTP/1.1 Host: picture.oos-cn.ctyunapi.cn Content-Length:200 Content-Type: application/xml;charset=utf-8 Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: AWS 7799e793ce4624ee7e5a:9N/W/kmYwFhbqHYFTvQor317qVw= x-amz-acl: public   <CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">     <MetadataLocationConstraint>         <Location>LaSa</Location>     </MetadataLocationConstraint>     <DataLocationConstraint>         <Type>Local</Type>      </DataLocationConstraint> </CreateBucketConfiguration >

返回示例1

HTTP/1.1 200 OK x-amz-request-id: 236A8905248E5A01 Date: Mon, 03Sep 2012 12:00:00 GMT Location: /picture Content-Length: 0 Server: CTYUN

请求示例2

请求创建一个名叫picture1的bucket，索引位置设置为LaSa，数据位置设置为拉萨、成都，调度策略是允许OOS自动调度：

				推荐：TOP云智能建站优惠活动，仅880元即可搭建一个后台管理五端合一的智能网站（PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序），独享百度搜索SEO优势资源，让你的网站不仅有颜值有排面，更有排名，可以实实在在为您带来效益，请点击进入TOP云智能建站>>>，或咨询在线客服了解详情。