特定のリージョンの1つ以上のレプリケーションペアの詳細を照会します。

説明

  • 非同期レプリケーション機能は、中国 (上海) 、中国 (北京) 、中国 (河源) 、中国 (成都) の各リージョンでサポートされています。
  • 特定のリージョンに対してこの操作を呼び出すと、レプリケーションペアのプライマリまたはセカンダリディスクがそのリージョン内にある場合、レプリケーションペアの情報が応答に含まれます。
  • ページ化されたクエリには、NextTokenパラメーターとMaxResultsパラメーターを使用することを推奨します。 ページ化されたクエリ中に、DescribeDiskReplicaPairs操作を呼び出して最初のページの結果を取得するときは、MaxResultsを設定して、呼び出しで返すエントリの最大数を指定します。 NextTokenの戻り値はページネーショントークンで、次の呼び出しで使用して新しい結果ページを取得できます。 DescribeDiskReplicaPairs操作を呼び出して新しいページの結果を取得するときは、NextTokenを前の呼び出しで返されたNextToken値に設定し、MaxResultsを設定してこの呼び出しで返すエントリの最大数を指定します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 DescribeDiskReplicaPairs

実行する操作です。 値をDescribeDiskReplicaPairsに設定します。

RegionId String 必須 cn-beijing

レプリケーションペアのプライマリディスク (ソースディスク) またはセカンダリディスク (宛先ディスク) のリージョンID。 DescribeRegions操作を呼び出して、非同期レプリケーションがサポートされているリージョンの最新リストを照会できます。

MaxResults Long 任意 1

返されるページ毎のエントリ数を設定します。 有効な値: 1 ~ 500

Default value: 10.
NextToken String 任意 AAAAAdDWBF2 ****

クエリトークン。 Set the value to the NextToken value returned in the previous call to the DescribeDiskReplicaPairs operation. この操作を初めて呼び出すときは、このパラメーターを空のままにします。

ペアリング String 任意 pair-cn-dsa****

レプリケーションペアのID。 1つ以上のレプリケーションペアのIDを指定し、コンマ (,) で区切ることができます。 例: pair-cn-dsa ****,pair-cn-asd ****

このパラメーターは既定では空です。これは、指定されたリージョンのすべてのレプリケーションペアが照会されることを示します。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String AAA478A0-BEE6-1D42-BEB6-A9CFEAD64B29

リクエストの ID です。

NextToken String AAAAAdDWBF2 ****

この呼び出しで返されたクエリトークン。

ReplicaPairs ReplicaPairの配列

Details about the replication pairs.

ReplicaPairId String ペア-cn-dsa ****

レプリケーションペアのID。

SourceRegion String cn-beijing

プライマリディスクのリージョンID。

SourceDiskId String d-bp131n0q38u3a4zi ****

プライマリディスクのID。

DestinationRegion String cn-shanghai

セカンダリディスクのリージョンID。

DestinationDiskId String d-asdfjl2342kj2l3k4 ****

The ID of the secondary disk.

ペア名 String TestReplicaPair

レプリケーションペアの名前。

説明 String これは説明です。

レプリケーションペアの説明。

ステータス String created

The state of the replication pair. 設定可能な値は以下のとおりです。

  • invalid: レプリケーションペアが有効です。 レプリケーションペアが異常になると、無効状態になります。
  • creating: レプリケーションペアが作成中です。
  • created: レプリケーションペアが作成されました。
  • create_failed: レプリケーションペアを作成できません。
  • initial_syncing: データはディスク間で初めて同期されます。 レプリケーションペアが作成され、アクティブ化された後、最初にデータがプライマリディスクからセカンダリディスクに同期されるとき、レプリケーションペアはこの状態になります。
  • syncing: データはディスク間で同期されています。 While data is being synchronized from the primary disk to the secondary disk not for the first time, the replication pair is in this state.
  • normal: レプリケーションペアは正常に動作しています。 システムが現在の複製サイクル内にプライマリディスクからセカンダリディスクへのデータの複製を完了すると、複製ペアはこの状態に入ります。
  • stopping: レプリケーションペアを停止中です。
  • stopped: レプリケーションペアが停止しています。
  • stop_failed: レプリケーションペアを停止できません。
  • フェールオーバー: フェールオーバーが実行中です。
  • 失敗: フェールオーバーが実行されます。
  • failover_failed: フェールオーバーは実行できません。
  • reprotecting: 逆レプリケーションが実行されています。
  • reprotect_failed: 逆レプリケーションは実行できません。
  • deleting: レプリケーションペアは削除中です。
  • delete_failed: レプリケーションペアは削除できません。
  • deleted: レプリケーションペアが削除されました。
AsyncCycle Long 900

プライマリディスクからセカンダリディスクにデータが非同期にレプリケートされる間隔。 (単位：秒)

帯域幅 Long 10240

プライマリディスクからセカンダリディスクへのデータの非同期レプリケートに使用される帯域幅。 単位：Kbit/s

StatusMessage String PrePayOrderExpired

レプリケーションペアの状態を説明するメッセージ。 This parameter has a value only when the value of Status is invalid. 設定可能な値は以下のとおりです。

  • PrePayOrderExpired: レプリケーションペアの有効期限が切れています。
  • DeviceRemoved: The primary or secondary disk has been deleted.
  • DeviceKeyChanged: プライマリまたはセカンダリディスクのDeviceKeyマッピングが変更されました。
LastRPO Long 1637835114000000

プライマリディスクからセカンダリディスクにデータが最後にレプリケートされた時刻。 このパラメーターの値はタイムスタンプです。

例

リクエストの例

https://ebs.cn-beijing.aliyuncs.com/?Action=DescribeDiskReplicaPairs
&RegionId=cn-beijing
&MaxResults=1
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDiskReplicaPairsResponse>
    <ReplicaPairs>
        <ステータス> 作成 </ステータス>
        <LastRPO>1637835114000000</LastRPO>
        <DestinationDiskId>d-asdfjl2342kj2l3k4 ****</DestinationDiskId>
        <説明> これは説明です。</Description>
        <PairName>TestReplicaPair</PairName>
        <Bandwidth>10240</Bandwidth>
        <DestinationRegion>cn-shanghai</DestinationRegion>
        <ReplicaPairId> ペア-cn-dsa ****</ReplicaPairId>
        <SourceRegion>cn-beijing</SourceRegion>
        <AsyncCycle>900</AsyncCycle>
        <SourceDiskId>d-bp131n0q38u3a4zi ****</SourceDiskId>
        <StatusMessage/>
    </ReplicaPairs>
    <RequestId>AAA478A0-BEE6-1D42-BEB6-A9CFEAD64B29</RequestId>
    <NextToken>AAAAAdDWBF2 ****</NextToken>
</DescribeDiskReplicaPairsResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ReplicaPairs" : [ {
    "ステータス" : "作成" 、
    "LastRPO" : 1637835114000000、
    "DestinationDiskId" : "d-asdfjl2342kj2l3k4****",
    "Description" : "これは説明です。
    "PairName" : "TestReplicaPair" 、
    "帯域幅" : 10240、
    "DestinationRegion" : "cn-shanghai" 、
    "ReplicaPairId" : "pair-cn-dsa ****" 、
    "SourceRegion" : "cn-beijing" 、
    "AsyncCycle" : 900、
    "SourceDiskId" : "d-bp131n0q38u3a4zi ****" 、
    "StatusMessage" : ""
  } ],
  "RequestId" : "AAA478A0-BEE6-1D42-BEB6-A9CFEAD64B29" 、
  "NextToken" : "AAAAAdDWBF2 ****"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。