すべてのプロダクト
Search
ドキュメントセンター

ApsaraMQ for RocketMQ:ListDisasterRecoveryPlans

最終更新日:Dec 21, 2025

グローバルレプリケータータスクを照会します。

今すぐお試しください

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

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

rocketmq:ListDisasterRecoveryPlans

get

*All Resource

*

なし なし

リクエスト構文

GET /disaster_recovery HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

instanceId

string

任意

インスタンス ID。

rmq-cn-778xxx

filter

string

任意

フィルター条件。グローバルレプリケータータスクは、タスク名または説明によってフィルターされます。

xxx

pageNumber

integer

任意

ページ番号。

1

pageSize

integer

任意

ページあたりのエントリ数。

10

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

requestId

string

リクエスト ID。

855EF8E6-9C1D-5DE2-9E84-924E13Exxxx

success

boolean

サービスに関する情報が照会されたかどうかを示します。

True

data

object

返されたデータ。

scrollId

string

リクエストのスクロール ID。この ID はシステムによって自動的に生成されます。ページングリクエストにこのパラメーターが含まれている場合にのみ、結果をページングできます。

B13D0B07-F24B-4790-88D8-D47A38063D00

pageNumber

integer

ページ番号。

1

pageSize

integer

ページあたりのエントリ数。

10

totalCount

integer

返されたエントリの総数。

28

list

array<object>

グローバルレプリケータータスク。

array<object>

グローバルレプリケータータスク。

planId

integer

グローバルレプリケータータスクの ID。

1300000016

planName

string

グローバルレプリケータータスクの名前。

xxx

planDesc

string

グローバルレプリケータータスクの説明。

xxx

planType

string

グローバルレプリケータータスクのタイプ。有効な値:

  • ACTIVE_PASSIVE:一方向バックアップ

  • ACTIVE_ACTIVE:双方向バックアップ

ACTIVE_PASSIVE

planStatus

string

グローバルレプリケータータスクのステータス。有効な値:

  • CREATED

  • RUNNING

  • DELETED

RUNNING

extInfo

object

拡張情報。

string

拡張情報。

xxx

instances

array<object>

グローバルレプリケータータスクに含まれるインスタンス。

array<object>

グローバルレプリケータータスクに含まれるインスタンス。

instanceType

string

インスタンスタイプ。

ALIYUN_ROCKETMQ

regionId

string

インスタンスが存在するリージョンの ID。

cn-hangzhou

instanceId

string

インスタンス ID。

rmq-cn-ot93rbxxx

instanceRole

string

インスタンスロール。

ACTIVE

authType

string

認証タイプ。

NO_AUTH

username

string

認証に使用されるユーザー名。

xxx

password

string

認証に使用されるパスワード。

xxx

endpointUrl

string

エンドポイント。

xxx

networkType

string

ネットワークタイプ。

TCP_INTERNET

vpcId

string

VPC ID。

vpc-bp13docqysrgxtbxxxx

vSwitchId

string

vSwitch ID。

vsw-uf6gwtbn6etadpv******

messageProperty

object

メッセージ属性。

propertyKey

string

属性キー。

aaa

propertyValue

string

属性値。

bbb

securityGroupId

string

セキュリティグループ ID。

sg-bp17hpmgz9******

consumerGroupId

string

コンシューマーグループの ID。

GID_ui_xxx

syncCheckpointEnabled

boolean

コンシューマーの進捗同期が有効かどうかを示します。

true

autoSyncCheckpoint

boolean

コンシューマーの進捗の自動同期が有効かどうかを示します。

true

createTime

string

クエリタスクが作成された時間。

2022-08-01 20:05:50

updateTime

string

クエリタスクが最後に変更された時間。

2022-08-01 20:05:50

code

string

エラーコード。

200

message

string

エラーメッセージ。

xxx

httpStatusCode

integer

レスポンスコード。

200

dynamicCode

string

動的エラーコード。

InstanceId

dynamicMessage

string

返された動的エラーメッセージ。

InstanceId

accessDeniedDetail

string

アクセス拒否の詳細。このパラメーターは、Resource Access Management (RAM) ユーザーに必要な権限がないためにアクセスが拒否された場合にのみ返されます。

xxx

成功レスポンス

JSONJSON

{
  "requestId": "855EF8E6-9C1D-5DE2-9E84-924E13Exxxx",
  "success": true,
  "data": {
    "scrollId": "B13D0B07-F24B-4790-88D8-D47A38063D00\n",
    "pageNumber": 1,
    "pageSize": 10,
    "totalCount": 28,
    "list": [
      {
        "planId": 1300000016,
        "planName": "xxx",
        "planDesc": "xxx",
        "planType": "ACTIVE_PASSIVE",
        "planStatus": "RUNNING",
        "extInfo": {
          "key": "xxx"
        },
        "instances": [
          {
            "instanceType": "ALIYUN_ROCKETMQ",
            "regionId": "cn-hangzhou",
            "instanceId": "rmq-cn-ot93rbxxx",
            "instanceRole": "ACTIVE",
            "authType": "NO_AUTH",
            "username": "xxx",
            "password": "xxx",
            "endpointUrl": "xxx",
            "networkType": "TCP_INTERNET",
            "vpcId": "vpc-bp13docqysrgxtbxxxx",
            "vSwitchId": "vsw-uf6gwtbn6etadpv******\n",
            "messageProperty": {
              "propertyKey": "aaa",
              "propertyValue": "bbb"
            },
            "securityGroupId": "sg-bp17hpmgz9******\n",
            "consumerGroupId": "GID_ui_xxx"
          }
        ],
        "syncCheckpointEnabled": true,
        "autoSyncCheckpoint": true,
        "createTime": "2022-08-01 20:05:50",
        "updateTime": "2022-08-01 20:05:50"
      }
    ]
  },
  "code": "200",
  "message": "xxx",
  "httpStatusCode": 200,
  "dynamicCode": "InstanceId",
  "dynamicMessage": "InstanceId",
  "accessDeniedDetail": "xxx"
}

エラーコード

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

変更履歴

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