# 查询资源恢复能力
#### 功能介绍
查询目标资源是否可恢复。
#### URI
- URI POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/action
  
- 参数说明
  表1参数说明 
  | 参数          | 是否必选 | 参数类型   | 描述                                                                                                                               |
  |:---|:---|:---|:---|
  | project_id  | 是    | String | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0136033750.html)。 |
  | provider_id | 是    | String | 备份提供商ID，当前取值固定值：fc4d5750-22e7-4798-8a46-f48f62c4c1da。用于区分备份对象是服务器或磁盘。                                                            |
     
  
 
#### 请求
- 要素说明
  表2要素说明 
  | 参数               | 是否必选 | 参数类型                     | 描述                                                                                             |
  |:---|:---|:---|:---|
  | check_restorable | 是    | List\<restorable_param\> | 查询参数列表。 详情请参见[表3]。 |
     
  
- restorable_param 字段数据结构说明
   表3restorable_param 字段数据结构说明 
  | 参数                 | 是否必选 | 参数类型              | 描述                                                                                           |
  |:---|:---|:---|:---|
  | checkpoint_item_id | 是    | String            | 待恢复的备份ID                                                                                     |
  | target             | 是    | restorable_target | 恢复目标。 详情请参见[表4]。 |
     
  
- restorable_target 字段数据结构说明
   表4restorable_target 字段数据结构说明 
  | 参数            | 是否必选 | 参数类型                           | 描述                                                                                                                                              |
  |:---|:---|:---|:---|
  | resource_id   | 是    | String                         | 待恢复到的目标ID                                                                                                                                       |
  | resource_type | 是    | String                         | 待恢复到的目标资源类型。 当前支持的取值包含两个：OS::Nova::Server，该值代表保护的资源为云服务器，OS::Ironic::BareMetalServer，该值代表保护的资源为裸金属服务器。 |
  | volumes       | 是    | List\<restore_volume_mapping\> | 云服务器恢复时的卷对应关系列表，请根据实际情况传入卷和备份对应关系 详情请参见[表5]。                        |
     
  
- restore_volume_mapping 字段数据结构说明
   表5restore_volume_mapping 字段数据结构说明 
  | 参数        | 是否必选 | 参数类型   | 描述                                                                                              |
  |:---|:---|:---|:---|
  | backup_id | 是    | String | 卷备份ID，请使用[查询单个备份](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0059304234.html)获取卷备份ID。 |
  | volume_id | 是    | String | 恢复目标卷ID。                                                                                        |
     
  
- 请求样例
  ```
  POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/action
  {
    "check_restorable" : [ {
      "checkpoint_item_id" : "8986ce68-3da7-4d29-9cc2-1921e9504975",
      "target" : {
        "resource_type" : "OS::Nova::Server",
        "resource_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635",
        "volumes" : [ {
          "backup_id" : "7ea119a8-d25b-43a7-8d1b-88e12788513a",
          "volume_id" : "45baf976-c20a-4894-a7c3-c94b7376bf55"
        } ]
      }
    } ]
  }
  ```
  
 
#### 响应
- 要素说明
  表6要素说明 
  | 参数         | 参数类型               | 描述                                                                                             |
  |:---|:---|:---|
  | restorable | List\<check_resp\> | 响应参数列表。 详情请参见[表7]。 |
     
  
- check_resp 字段数据结构说明
   表7check_resp 字段数据结构说明 
  | 参数            | 参数类型    | 描述    |
  |:---|:---|:---|
  | result        | Boolean | 是否可恢复 |
  | resource_type | String  | 资源类型  |
  | error_code    | String  | 错误码   |
  | error_msg     | String  | 错误原因  |
  | resource_id   | String  | 资源ID  |
     
  
- 响应样例
  ```
  {
    "restorable" : [ {
      "resource_id" : "6507cb66-90dc-4a12-a573-c9f3398f899d",
      "resource_type" : "OS::Nova::Server",
      "result" : true,
      "error_msg" : "",
      "error_code" : ""
    } ]
  }
  ```
  
 
#### 状态码
- 正常
  
  | 状态码 | 说明 |
  |:---|:---|
  | 200 | OK |
     
  
- 异常
  
  | 状态码 | 说明      |
  |:---|:---|
  | 400 | 请求参数不合法 |
  | 401 | 鉴权失败    |
  | 403 | 没有操作权限  |
  | 404 | 请求对象不存在 |
  | 500 | 服务内部错误  |
  | 503 | 服务不可用   |
     
  
 
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0071888297.html)。