桶的操作
获取桶的地理分区 - GET Bucket location
描述
获取桶的地理分区信息,地理分区信息在建通时指定,见 PUT Bucket。
语法
GET /?location HTTP/1.1
HOST: ${BucketName}.${endpoint}
Date: ${date}
Authorization: ${signature}
响应元素
Element | 描述 |
---|---|
LocationConstraint | 桶的地理分区 类型:字符串 有效值:HZ / BJ / GZ 父节点:无 |
示例
Request
GET /?location HTTP/1.1
HOST: dream.nos-eastchina1.126.net
Date: Fri, 10 Feb 2012 21:34:55 GMT
Authorization: NOS I_AM_ACCESS_ID:I_AM_SIGNATURE
Response
HTTP/1.1 200 OK
x-nos-request-id: 17b21e42ac11000001390ab891440240
Date: Wed, 01 Mar 2012 21:34:55 GMT
Connection: close
Server: NOS
<?xml version="1.0" encoding="UTF-8"?>
<LocationConstraint>HZ</LocationConstraint>
细节描述
1.如果 Bucket 不存在,返回 404 no content错误。错误码:NoSuchBucket。
2.只有 Bucket 的拥有者才能获取这个 Bucket 的 Location 信息。如果试图获取一个没有对应权限的 Bucket,返回 403 Forbidden 错误。错误码:AccessDenied。