桶的操作

获取桶的地理分区 - 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。