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-hangzhou、oss-cn-qingdao、oss-cn-beijing、oss-cn-hongkong、oss-cn-shenzhen、oss-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 >