バケットのレプリケーションロケーションの取得 - Object Storage Service

この操作を呼び出すことで、デスティネーションバケットを配置できるリージョンをクエリできます。操作から返されたレスポンスに基づいて、デスティネーションバケットのリージョンを特定できます。

リクエスト構造

GET /?replicationLocation HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com 
Date: GMT Date
Authorization: SignatureValue

レスポンス要素

要素	タイプ	説明
ReplicationLocation	コンテナー	デスティネーションバケットを配置できるリージョンを格納するコンテナー。
Location	文字列	デスティネーションバケットを配置できるリージョン。例： oss-cn-beijing。親ノード： ReplicationLocation 子ノード：なし説明デスティネーションバケットを複数のリージョンに配置できる場合、レスポンスには複数のリージョンが含まれます。デスティネーションバケットを配置できるリージョンが存在しない場合、Location の値は null です。
LocationTransferTypeConstraint	コンテナー	TransferType が指定されたデスティネーションバケットを配置できるリージョンを格納するコンテナー。
LocationTransferType	コンテナー	TransferType 情報を持つデスティネーションバケットを配置できるリージョンを格納するコンテナー。
TransferTypes	コンテナー	転送タイプを格納するコンテナー。
Type	文字列	データレプリケーションでデータ転送に使用されるリンク。デフォルト値： internal。有効な値： internal：デフォルトリンク。 oss_acc：データ転送が高速化されるリンク。 TransferType は、クロスリージョンレプリケーション（CRR）ルールの場合のみ 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****************

レスポンスの例
説明
TransferType 要素は、リクエストで TransferType の値が oss_acc に設定されている場合にのみ、レスポンスの XML 本文に含まれます。

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>

OSS SDK

以下のプログラミング言語の OSS SDK を使用して、GetBucketReplicationLocation を呼び出すことができます。

ossutil

GetBucketReplicationLocation 操作に対応する ossutil コマンドについては、「get-bucket-replication-location」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
NoSuchBucket	404 NotFound	指定されたバケットが存在しないために返されるエラーメッセージ。