云数据库 MySQL 版
云数据库 MySQL 版
文档指南
请输入
- 文档首页
云数据库 MySQL 版API 参考V2（2022-01-01）实例管理DescribeDBDisasterRecoveryInstances - 查询实例的灾备实例信息
复制全文
下载 pdfDescribeDBDisasterRecoveryInstances - 查询实例的灾备实例信息
文档反馈
问问助手调用 DescribeDBDisasterRecoveryInstances 接口查询实例的灾备实例信息。
请求类型
同步请求。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
返回参数
返回参数的范围因传入的实例所处的角色而不同：
- 如果传入的 InstanceId 为灾备实例 ID，则返回 DrDtsTaskId、TestTask、DrDtsTaskStatus、DrSecondsBehindMaster、MasterInstanceId、MasterInstanceName 和 MasterRegion。
- 如果传入的 InstanceId 为主实例 ID，则仅返回 DisasterRecoveryInstances。
- 在主实例与灾备实例之间的灾备链路未创建时，无论传入的 InstanceId 为灾备实例 ID 还是主实例 ID，均不返回 DrDtsTaskId、TestTask 和 DrDtsTaskStatus。
- 如果传入的 InstanceId 所对应的实例既不是主实例也不是灾备实例，则返回为空。
参数 | 类型 | 示例值 | 描述 |
DisasterRecoveryInstances | 请参见返回示例。 | 实例的灾备实例的信息。 | |
DrDtsTaskId | String | 9c0c17a0b82f460b87b338d1db8d**** | 主实例与灾备实例之间同步任务的 ID。 |
DrDtsTaskName | String | TestTask | 主实例与灾备实例之间同步任务的名称。 |
DrDtsTaskStatus | String | Running | 主实例与灾备实例之间同步任务的状态。 |
DrSecondsBehindMaster | Integer | 1 | 灾备实例与主实例之间的时延。 |
MasterInstanceId | String | mysql-f83edc2e**** | 主实例的 ID。 |
MasterInstanceName | String | 测试实例 | 主实例的名称。 |
MasterRegion | String | cn-guangzhou | 主实例所在的地域。 |
DisasterRecoveryInstance
参数 | 类型 | 示例值 | 描述 |
DtsTaskId | String | 9c0c17a0b82f460b87b338d1db8d**** | 主实例与灾备实例之间同步任务的 ID。 |
DtsTaskName | String | TestTask | 主实例与灾备实例之间同步任务的名称。 |
DtsTaskStatus | String | Running | 主实例与灾备实例之间同步任务的状态。 |
InstanceId | String | mysql-6c7c35fb**** | 灾备实例的 ID。 |
InstanceName | String | DrInstance-test | 灾备实例的名称。 |
Region | String | cn-shanghai | 灾备实例所处的地域。 |
SecondsBehindMaster | Integer | 0 | 灾备实例与主实例之间的时延。 |
示例
请求示例
返回示例
错误码
最近更新时间：2026.10.23 17:52:45
这个页面对您有帮助吗？
有用
有用
无用
无用