DescribeDiskReplicaPairs - - Alibaba Cloud ドキュメントセンター

指定されたリージョンにある 1 つ以上のレプリケーションペアに関する情報をクエリします。

操作説明

説明

非同期レプリケーションをサポートするリージョンについては、「ディスクの非同期レプリケーションの概要」をご参照ください。
レプリケーションペアのプライマリディスクまたはセカンダリディスクが指定されたリージョンにある場合、クエリはそのレプリケーションペアに関する情報を返します。
ページングクエリを実行するには、MaxResults パラメーターと NextToken パラメーターを使用します。最初のページでは、MaxResults を設定して返されるエントリ数を制限します。レスポンスの NextToken 値は、次のページのトークンです。後続のページでは、NextToken を前のレスポンスの値に設定し、MaxResults を設定してエントリ数を制限します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	タイプ	必須 / 任意	説明	例
RegionId	string	必須	レプリケーションペアのプライマリディスクまたはセカンダリディスクが存在するリージョンの ID です。DescribeRegions 操作を呼び出して、非同期レプリケーションをサポートするリージョンをクエリできます。	cn-beijing
MaxResults	integer	任意	各ページで返す最大エントリ数です。このパラメーターは NextToken と一緒に使用できます。有効な値：1 ～ 500 デフォルト値：10	1
NextToken	string	任意	クエリトークンです。このパラメーターを、この操作への前回の呼び出しから返された NextToken 値に設定します。最初の呼び出しでは、このパラメーターを設定する必要はありません。NextToken を設定すると、PageSize パラメーターと PageNumber パラメーターは無視され、レスポンスの TotalCount 値は無効になります。	AAAAAdDWBF2****
PairIds	string	任意	レプリケーションペアの ID です。1 つ以上のレプリケーションペア ID を指定できます。ID は `pair-cn-dsa**,pair-cn-asd**` 形式である必要があります。このパラメーターを空のままにすると、現在のリージョンにあるすべてのレプリケーションペアがクエリされます。最大 100 個のレプリケーションペア ID を指定できます。	pair-cn-dsa****
Site	string	任意	データをクエリするサイトです。本番サイトまたはディザスタリカバリサイトからデータをクエリできます。有効な値： production：本番サイト backup：ディザスタリカバリサイトデフォルト値：production	production
ReplicaGroupId	string	任意	レプリケーション整合性グループの ID です。グループ内のレプリケーションペアをクエリするために、レプリケーション整合性グループの ID を指定できます。ID は `pg-****` 形式である必要があります。このパラメーターを空のままにすると、現在のリージョンにあるすべてのレプリケーションペアがクエリされます。説明このパラメーターを `-` に設定すると、レプリケーション整合性グループに属していないレプリケーションペアが返されます。	pg-****
PageNumber	integer	任意	ページ番号です。	5
PageSize	integer	任意	1 ページあたりのエントリ数です。有効な値：1 ～ 100	10
ResourceGroupId	string	任意	レプリケーションペアが属するリソースグループの ID です。	rg-acfmvs******
Name	string	任意	レプリケーションペアの名前です。あいまい一致がサポートされています。	name***
Tag	array<object>	任意	タグです。最大 20 個のタグを指定できます。
	object	任意	タグです。
Value	string	任意	タグの値です。	TestValue
Key	string	任意	タグのキーです。	TestKey

レスポンスパラメーター

パラメーター	タイプ	説明	例
	object	レスポンススキーマです。
RequestId	string	リクエスト ID です。	AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****
NextToken	string	この呼び出しから返されたクエリトークンです。	AAAAAdDWBF2****
ReplicaPairs	array<object>	レプリケーションペアです。
	object
Site	string	レプリケーションペアまたはレプリケーション整合性グループのサイトタイプです。有効な値： production：本番サイト backup：ディザスタリカバリサイト	production
DestinationDiskId	string	セカンダリディスクの ID です。	d-asdfjl2342kj2l3k4****
Description	string	レプリケーションペアの説明です。	This is description.
StandbyZone	string	レプリケーションペアの初期ターゲットゾーンです。	cn-shanghai-b
ResourceGroupId	string	レプリケーションペアが属するリソースグループの ID です。	rg-acfmvs*****
DestinationRegion	string	セカンダリディスクのリージョンです。	cn-shanghai
ReplicaPairId	string	レプリケーションペアの ID です。	pair-cn-dsa****
LastRecoverPoint	integer	最後の非同期レプリケーションが完了した時刻です。この値は UNIX タイムスタンプです。単位：秒。	1649751977
ReplicaGroupId	string	レプリケーションペアが属するレプリケーション整合性グループの ID です。	pg-xxxx****
SourceDiskId	string	プライマリディスクの ID です。	d-bp131n0q38u3a4zi****
RPO	integer	レプリケーションペアの目標復旧時点（ RPO ）です。単位：秒。	900
PairName	string	レプリケーションペアの名前です。	TestReplicaPair
Bandwidth	integer	非同期レプリケーションに使用される帯域幅です。単位：Kbit/s。	10240
ExpiredTime	integer	レプリケーションペアの有効期限です。この値は UNIX タイムスタンプです。単位：秒。	1649750977
PrimaryZone	string	レプリケーションペアの初期ソースゾーンです。	cn-beijing-a
SourceZoneId	string	プライマリディスクのゾーンです。	cn-beijing-a
Tags	array<object>	レプリケーションペアのタグです。
	object	タグです。
TagKey	string	タグのキーです。	testKey
TagValue	string	タグの値です。	testValue
Status	string	レプリケーションペアのステータスです。有効な値： invalid：レプリケーションペアが無効です。このステータスは、レプリケーションペアが正しく動作していないことを示します。 creating：レプリケーションペアを作成中です。 created：レプリケーションペアが作成されました。 create_failed：レプリケーションペアの作成に失敗しました。 initial_syncing：レプリケーションペアは同期の初期化状態です。レプリケーションペアが作成されて開始されると、プライマリディスクからセカンダリディスクへの最初のデータの非同期レプリケーション中に、この状態になります。 manual_syncing：レプリケーションペアを手動で同期しています。手動同期が完了すると、レプリケーションペアは停止状態に戻ります。最初のワンタイム同期の場合も、ステータスは manual_syncing です。 syncing：レプリケーションペアはデータを同期しています。2 回目以降のプライマリディスクからセカンダリディスクへのデータの非同期レプリケーション時に、レプリケーションペアはこの状態になります。 normal：レプリケーションペアは正常な状態です。現在のレプリケーションサイクルでデータレプリケーションが完了すると、レプリケーションペアはこの状態になります。 stopping：レプリケーションペアを停止中です。 stopped：レプリケーションペアは停止しています。 stop_failed：レプリケーションペアの停止に失敗しました。 failovering：フェールオーバーが進行中です。 failovered：フェールオーバーが完了しました。 failover_failed：フェールオーバーに失敗しました。 reprotecting：逆レプリケーションが進行中です。 reprotect_failed：逆レプリケーションに失敗しました。 deleting：レプリケーションペアを削除中です。 delete_failed：レプリケーションペアの削除に失敗しました。 deleted：レプリケーションペアは削除されました。	created
PrimaryRegion	string	レプリケーションペアの初期ソースリージョンです。	cn-beijing
CreateTime	integer	作成時刻です。この値は UNIX タイムスタンプです。単位：秒。	1649750977
SourceRegion	string	プライマリディスクのリージョンです。	cn-beijing
StatusMessage	string	レプリケーションペアのステータスメッセージです。このパラメーターは、Status が `invalid` または `create_failed` の場合に返されます。有効な値： PrePayOrderExpired：サブスクリプションレプリケーションペアの期限が切れました。 PostPayOrderCeaseService：従量課金レプリケーションペアのサービスは、通常、支払い遅延のために一時停止されています。 DeviceRemoved：プライマリディスクまたはセカンダリディスクが削除されました。 DeviceKeyChanged：プライマリディスクまたはセカンダリディスクの `DeviceKey` マッピングが変更されました。 DeviceSizeChanged：プライマリディスクまたはセカンダリディスクの `DeviceSize` が変更されました。 OperationDenied.QuotaExceed：作成されたレプリケーションペアの数がクォータを超えています。	PrePayOrderExpired
EnableRtc	boolean	リアルタイムレプリケーションコントロール（ RTC ）が有効かどうかを示します。レプリケーションペアがレプリケーション整合性グループに属している場合、このパラメーターの値はグループの値と同じです。	false
ChargeType	string	レプリケーションペアの課金方法です。有効な値： PREPAY：サブスクリプション POSTPAY：従量課金	PREPAY
DestinationZoneId	string	セカンダリディスクのゾーンです。	cn-shanghai-b
ReplicaGroupName	string	レプリケーションペアが属するレプリケーション整合性グループの名前です。	pg-name****
StandbyRegion	string	レプリケーションペアの初期ターゲットリージョンです。	cn-shanghai
PageNumber	integer	ページ番号です。	1
PageSize	integer	1 ページあたりのエントリ数です。	10
TotalCount	integer	エントリの総数です。	60

例

成功レスポンス

JSONJSON

{
  "RequestId": "AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****",
  "NextToken": "AAAAAdDWBF2****",
  "ReplicaPairs": [
    {
      "Site": "production",
      "DestinationDiskId": "d-asdfjl2342kj2l3k4****",
      "Description": "This is description.",
      "StandbyZone": "cn-shanghai-b",
      "ResourceGroupId": "rg-acfmvs*****",
      "DestinationRegion": "cn-shanghai",
      "ReplicaPairId": "pair-cn-dsa****",
      "LastRecoverPoint": 1649751977,
      "ReplicaGroupId": "pg-xxxx****",
      "SourceDiskId": "d-bp131n0q38u3a4zi****",
      "RPO": 900,
      "PairName": "TestReplicaPair",
      "Bandwidth": 10240,
      "ExpiredTime": 1649750977,
      "PrimaryZone": "cn-beijing-a",
      "SourceZoneId": "cn-beijing-a",
      "Tags": [
        {
          "TagKey": "testKey",
          "TagValue": "testValue"
        }
      ],
      "Status": "created",
      "PrimaryRegion": "cn-beijing",
      "CreateTime": 1649750977,
      "SourceRegion": "cn-beijing",
      "StatusMessage": "PrePayOrderExpired",
      "EnableRtc": false,
      "ChargeType": "PREPAY",
      "DestinationZoneId": "cn-shanghai-b",
      "ReplicaGroupName": "pg-name****",
      "StandbyRegion": "cn-shanghai"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 60
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
403	OperationDenied	The operation is not allowed.
403	OperationDenied.InvalidStatus	The operation is not allowed in current status.
403	Forbidden	User is not authorized to operate.
403	Forbidden.Action	User is not authorized to operate this action.
404	NoSuchResource	The specified resource does not exist.
504	RequestTimeout	The request is timeout, please try again later.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。