# 查询可用于时间点恢复的数据节点列表V3
#### 功能介绍
查询可用于时间点恢复的数据节点列表
#### URI
GET /v3/{project_id}/instances/{instance_id}/backups/restorable-data-node
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                        |
|:---|:---|:---|:---|
| project_id  | 是    | String | 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ddm/ddm_api_01_0063.html)。 |
| instance_id | 是    | String | DDM实例ID。                                                                                                                                                  |
   
表2Query参数 
| 参数                    | 是否必选 | 参数类型    | 描述                                                                                                                                                                                  |
|:---|:---|:---|:---|
| target_instance_id    | 是    | String  | 目标实例 ID。                                                                                                                                                                            |
| source_dn_instance_id | 是    | String  | 源DN实例 ID。                                                                                                                                                                           |
| restore_time          | 是    | String  | 恢复时间。                                                                                                                                                                               |
| offset                | 否    | Integer | 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0。 取值必须为数字，且不能为负数。 |
| limit                 | 否    | Integer | 查询个数上限值。 取值范围：1\~128。 不传该参数时，默认值为10。                     |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                        |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数                | 参数类型                                                                             | 描述                                                                                                                                                 |
|:---|:---|:---|
| target_data_nodes | Array of [TargetDn4Restore] objects | 可用目标DN。                                                                                                                                            |
| offset            | Integer                                                                          | **参数解释**： 分页参数: 起始值。 **参数范围**： 大于等于0。           |
| limit             | Integer                                                                          | **参数解释**： 分页参数: 每页记录数。 **参数范围**： 大于0且小于等于128。 |
| total             | Integer                                                                          | **参数解释**： 总记录数。 **参数范围**： 不涉及。                  |
   
 表5TargetDn4Restore 
| 参数                 | 参数类型    | 描述       |
|:---|:---|:---|
| instance_name      | String  | 实例名称。    |
| instance_id        | String  | 实例ID。    |
| engine_name        | String  | 引擎名称。    |
| status             | String  | 状态。      |
| available          | Boolean | 是否可用。    |
| unavailable_reason | String  | 无法使用原因。  |
| vpc_name           | String  | 虚拟私有云名称。 |
| private_ip         | String  | 私有ip。    |
   
**状态码：400**
表6响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误消息。 |
   
**状态码：500**
表7响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误消息。 |
   
#### 请求示例
查询可用于恢复的数据节点列表。
```
GET https://{endpoint}/v3/74f57817ca8f42e19318eb0e0ad41d18/instances/733c7e8d73a54c27b8308ec784a8be8cin09/backups/restorable-data-node?source_dn_instance_id=41c239a1e9bd4cd2aabd678bab45a886in01&target_instance_id=2f0324a93859487eb5566d75951fcd2din09&restore_time=1747730765390
```
#### 响应示例
**状态码：200**
```
{
"target_data_nodes": [{
"instance_name": "rds-f0e2",
"instance_id": "55c26c79139446868919c5b8b2cbb542in01",
"engine_name": "mysql",
"status": "normal",
"available": true,
"unavailable_reason": "",
"vpc_name": "vpc-ddm-172",
"private_ip": "172.16.248.115"
}, {
"instance_name": "mysql_80_4u8g_single_2",
"instance_id": "c5ee103325294f37a8a42e88ba51947ain01",
"engine_name": "mysql",
"status": "normal",
"available": true,
"unavailable_reason": "",
"vpc_name": "vpc-ddm-172",
"private_ip": "172.16.192.156"
}],
"offset": 0,
"limit": 2,
"total": 192
}
```
**状态码：400**
bad request
```
{
  "error_msg" : "Parameter error.",
  "error_code" : "DBS.280001"
}
```
**状态码：500**
server error
```
{
  "error_msg" : "Parameter error.",
  "error_code" : "DBS.280001"
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | ok           |
| 400 | bad request  |
| 500 | server error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。