产品推荐：

1、安全稳定的云服务器租用，2核/2G/5M仅37元，点击抢购>>>；

2、高防物理服务器20核/16G/50M/500G防御仅350元，点击抢购>>>

3、百度智能建站（五合一网站）仅880元/年，点击抢购>>> 模板建站（PC+手机站）仅480元/年，点击抢购>>>

4、阿里云服务器2核2G3M仅99元/年、2核4G5M仅199元/年，新老同享，点击抢购>>> 

5、腾讯云服务器2核2G4M仅99元/年、新老同享，点击抢购>>>   

点击这里注册天翼云特邀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自动调度：

PUT / HTTP/1.1
Host: picture1.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=
 
<CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <MetadataLocationConstraint>
        <Location>LaSa</Location>
    </MetadataLocationConstraint>
    <DataLocationConstraint>
         <Type>Specified</Type>    
          <LocationList>
            <Location>LaSa</Location>
            <Location>ChengDu</Location>
          </LocationList>
          <ScheduleStrategy>Allowed</ScheduleStrategy>
    </DataLocationConstraint>
</CreateBucketConfiguration>

返回示例2

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

请求示例3

修改数据位置为就近。

PUT / HTTP/1.1
Host: ctyuntest0929.oos-cn.ctyunapi.cn
Authorization: AWS 0c6c84764e3b8eddf928:oqF7NDGpgL33NRJJXFH60Kyjyhk=
Date: Sun, 29 Sep 2019 07:16:11 GMT
Content-Type: application/xml;charset=utf-8
Content-Length: 170
 
<CreateBucketConfiguration xmlns="    
  <DataLocationConstraint>
    <Type>Local</Type>
  </DataLocationConstraint>
</CreateBucketConfiguration>

返回示例3

HTTP/1.1 200 OK
Location: /ctyuntest0929
Date: Sun, 29 Sep 2019 07:16:32 GMT
x-amz-request-id: 7088d28e62cc4002
Content-Length: 0
Server: CTYUN