GetBucketLocation用于查看Bucket所属的数据中心位置信息。

请求语法

GET /?location HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

响应元素(Response Elements)

表 1. 响应元素
名称 类型 描述
LocationConstraint 字符串 Bucket所在的区域。

有效值: oss-cn-hangzhouoss-cn-qingdaooss-cn-beijingoss-cn-hongkongoss-cn-shenzhenoss-cn-shanghai

细节分析

  • 只有Bucket的拥有者才能查看Bucket的Location信息,否则返回403 Forbidden错误,错误码:AccessDenied。
  • 目前LocationConstraint有效值:oss-cn-hangzhou,oss-cn-qingdao,oss-cn-beijing,oss-cn-hongkong,oss-cn-shenzhen,oss-cn-shanghai,oss-us-west-1,oss-us-east-1,oss-ap-southeast-1。分别对应杭州数据中心,青岛数据中心,北京数据中心、香港数据中心、深圳数据中心、上海数据中心、美国硅谷数据中心、美国弗吉尼亚数据中心和亚太(新加坡)数据中心。

示例

请求示例:

Get /?location HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 04 May 2012 05:31:04 GMT  
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3naA=

已设置LOG规则的返回示例:

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906008B
Date: Fri, 15 Mar 2013 05:31:04 GMT
Connection: keep-alive
Content-Length: 90 
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<LocationConstraint xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>oss-cn-hangzhou</LocationConstraint >