GetBucketReplicationLocation介面用於擷取可複製到的目標儲存空間(Bucket)所在的地區。您可以根據返回結果決定將源Bucket的資料複製到哪個地區。
請求文法
GET /?replicationLocation HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
響應元素
名稱 | 類型 | 描述 |
ReplicationLocation | 容器 | 可複製地區的容器。 |
Location | 字串 | 可複製到的目標Bucket所在的地區,例如oss-cn-beijing。 父節點:ReplicationLocation 子節點:無 說明 如果有多個可複製到的目標地區,那麼返回的結果中包含多個Location。如果沒有可複製到的目標地區,則返回的Location為空白。 |
LocationTransferTypeConstraint | 容器 | 包含TransferType約束的Location資訊容器。 |
LocationTransferType | 容器 | 包含TransferType的Location資訊容器。 |
TransferTypes | 容器 | 傳輸類型容器。 |
Type | 字串 | 資料複製時使用的資料轉送類型。 取值:
|
樣本
請求樣本
GET /?replicationLocation HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 24 Sep 2015 15:39:15 GMT
Authorization: OSS qn6q**************:77Dv****************
返回樣本
說明僅當傳輸類型為oss_acc時,返回的XML樣本中才會包含<TransferType>元素。
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 24 Sep 2015 15:39:15 GMT
Content-Length: 84
Content-Type: application/xml
Connection: close
Server: AliyunOSS
<?xml version="1.0" ?>
<ReplicationLocation>
<Location>oss-cn-beijing</Location>
<Location>oss-cn-qingdao</Location>
<Location>oss-cn-shenzhen</Location>
<Location>oss-cn-hongkong</Location>
<Location>oss-us-west-1</Location>
<LocationTransferTypeConstraint>
<LocationTransferType>
<Location>oss-cn-hongkong</Location>
<TransferTypes>
<Type>oss_acc</Type>
</TransferTypes>
</LocationTransferType>
<LocationTransferType>
<Location>oss-us-west-1</Location>
<TransferTypes>
<Type>oss_acc</Type>
</TransferTypes>
</LocationTransferType>
</LocationTransferTypeConstraint>
</ReplicationLocation>
錯誤碼
錯誤碼 | 狀態代碼 | 描述 |
NoSuchBucket | 404 NotFound | 請求的Bucket不存在。 |