此操作用来获取Bucket的索引位置和数据位置,只有根用户和拥有GET Bucket location权限的子用户才能执行此操作。
注意香港节点不支持此接口。
请求语法
GET /?location HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue
请求参数
名称 | 描述 | 是否必须 |
---|---|---|
BucketName | 存储桶名称。 | 是 |
响应结果
名称 描述 BucketConfiguration 设置Bucket索引位置和数据位置的容器。
类型:容器。
子节点:MetadataLocationConstraint、DataLocationConstraint。
MetadataLocationConstraint 设置Bucket的索引位置。
类型:容器。
父节点:CreateBucketConfiguration。
子节点:Location。
DataLocationConstraint 设置Bucket的数据位置。
类型:容器。
父节点:CreateBucketConfiguration。
子节点:Type、LocationList、ScheduleStrategy。
Type 数据位置的类型。
类型:枚举。
取值:
Local:本地。
Specified:指定位置。
默认Local。
父节点:DataLocationConstraint。
LocationList 指定的数据位置。
类型:容器。
父节点:DataLocationConstraint。
子节点:Location。
Location 索引位置或数据位置。
类型:字符串。
取值:
父节点为MetadataLocationConstraint,表示索引位置,有效值为:ChengDu、FuZhou、GuiYang、HangZhou、LaSa、LanZhou、QingDao、ShenYang、ShenZhen、WuHan、WuHu、WuLuMuQi、ZhengZhou、SH2、SuZhou
父节点为LocationList,表示数据位置,有效值为:ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou
父节点:MetadataLocationConstraint或LocationList。
ScheduleStrategy 指定数据时的调度策略
类型:枚举
取值:
Allowed:允许OOS自动调度。
NotAllowed:不允许OOS自动调度。
父节点:DataLocationConstraint
请求示例
获取一个名叫docs的Bucket的数据位置和索引位置:
GET /?location HTTP/1.1
Host: docs.oos-cn.ctyunapi.cn
Content-Type: application/xml;charset=utf-8
Date: Mon, 03 Sep 2012 12:00:00 GMT
Authorization: SignatureValue
响应示例
HTTP/1.1 200 OK
x-amz-request-id: b9e8da1354774e89d14437463b484a500f111b0507090b0d0f
Date: Mon, 03 Sep 2012 12:00:00 GMT
Content-Type: application/xml;charset=utf-8
Content-Length: 200
Server: CTYUN
<BucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<MetadataLocationConstraint>
<Location>LaSa</Location>
</MetadataLocationConstraint>
<DataLocationConstraint>
<Type>Local</Type>
</DataLocationConstraint>
</BucketConfiguration>