全部產品
Search
文件中心

Object Storage Service:GetBucketReplicationLocation

更新時間:Jun 08, 2024

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

字串

資料複製時使用的資料轉送類型。

取值:

  • internal(預設值):OSS預設傳輸鏈路。

  • oss_acc:傳輸加速鏈路。只有建立跨地區複製規則時才能使用傳輸加速鏈路。

樣本

  • 請求樣本

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不存在。