文档简介：
PUT Bucket
PUT Bucket操作可以用来：
l 创建一个新的Bucket；
l 对已有Bucket的Bucket ACL进行修改；
l 对数据位置进行修改，但是不能修改索引位置。
只有根用户和具有PUT Bucket权限的子用户才能创建Bucket。
Bucket的命名规范具体参见Bucket的命名规范。
请求语法
|
PUT / HTTP/1.1 Host: bucketName.oos-cn.ctyunapi.cn Content-Length: length Date: date Authorization: signatureValue
MetadataRegion
RegionType
DataRegion DataRegion
Strategy
|
请求元素
|
名称 |
描述 |
是否必须 |
|
CreateBucketConfiguration |
设置Bucket索引位置和数据位置的容器。 类型：容器 |
是 |
|
MetadataLocationConstraint |
设置Bucket的索引位置。 类型：容器 父节点：CreateBucketConfiguration |
创建Bucket的时候必须填写，修改Bucket ACL或数据索引位置的时候不能填写。 |
|
DataLocationConstraint |
设置Bucket的数据位置。 类型：容器 父节点：CreateBucketConfiguration |
否 |
|
Type |
数据位置的类型 类型：枚举 有效值：Local(本地) |Specified（指定位置） 默认：Local 父节点：DataLocationConstraint |
否 |
|
LocationList |
指定的数据位置 类型：容器 父节点：DataLocationConstraint |
否 |
|
Location |
索引位置或数据位置 类型：String 有效值：
默认值：无 父节点：MetadataLocationConstraint或Locationlist |
否 |
|
ScheduleStrategy |
指定数据时的调度策略 类型：枚举 有效值：Allowed(允许OOS自动调度)|NotAllowed（不允许OOS自动调度） 默认：Allowed 父节点：DataLocationConstraint |
否 |
请求参数
|
名称 |
描述 |
是否必须 |
|
x-amz-acl |
设置Bucket的ACL（Access Control List） 类型：String 有效值：private | public-read | public-read-write |
否 |
请求示例1
请求创建一个名叫picture的bucket，索引位置设置为Beijing，数据位置设置为优先本地，bucket权限设置为公有。
|
PUT / HTTP/1.1 Host: picture.oos-cn.ctyunapi.cn Content-Length:200 Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: AWS 7799e793ce4624ee7e5a:9N/W/kmYwFhbqHYFTvQor317qVw= x-amz-acl: public
BeiJing
Local
|
返回示例1
|
HTTP/1.1 200 OK x-amz-request-id: 236A8905248E5A01 Date: Mon, 03Sep 2012 12:00:00 GMT Location: /picture Content-Length: 0 Connection: close Server: CTYUN |
请求创建一个名叫picture的bucket，索引位置设置为Beijing，数据位置设置为北京、上海，调度策略是允许OOS自动调度：
|
PUT / HTTP/1.1 Host: picture.oos-cn.ctyunapi.cn Content-Length:200 Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: AWS 7799e793ce4624ee7e5a:9N/W/kmYwFhbqHYFTvQor317qVw=
BeiJing
Specified
BeiJing ShangHai
Allowed
|
请求示例2
修改数据位置为就近。
|
PUT / HTTP/1.1 Host: test-bucket.oos-cn.ctyunapi.cn Authorization: AWS 0c6c84764e3b8eddf928:oqF7NDGpgL33NRJJXFH60Kyjyhk= Date: Sun, 29 Sep 2019 07:16:11 GMT Content-Type: application/x-www-form-urlencoded; charset=utf-8 Content-Length: 170
Local |
返回示例2
|
HTTP/1.1 200 OK Location: test-bucket Date: Sun, 29 Sep 2019 07:16:32 GMT x-amz-request-id: 7088d28e62cc4002 Content-Length: 0 Server: CTYUN |
