# 查询容灾演练列表 - ListDisasterRecoveryDrills #### 功能介绍 查询指定保护组下的所有容灾演练列表，当未指定保护组时查询当前租户下的所有容灾演练列表。 #### 接口约束 无 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SDRS/doc?api=ListDisasterRecoveryDrills)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI GET /v1/{project_id}/disaster-recovery-drills 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | drill_vpc_id | 否 | String | 演练虚拟私有云ID。 | | limit | 否 | Integer | 每次请求返回结果个数限制，取值范围为\[0,1000\]的正整数，默认值为1000。 最小值：**0** 最大值：**1000** 缺省值：**1000** | | name | 否 | String | 容灾演练的名称。支持模糊查询。 | | offset | 否 | Integer | 每次请求开始的下标，即偏移量，默认值为0。offset必须为数字，不能为负数。 最小值：**0** 缺省值：**0** | | server_group_id | 否 | String | 保护组的ID。 | | status | 否 | String | 容灾演练的状态。 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） | #### 响应参数 **状态码： 200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | disaster_recovery_drills | Array of [ShowDisasterRecoveryDrillParams] objects | 容灾演练列表。 | | count | Integer | 列表中包含的容灾演练个数。 | 表5ShowDisasterRecoveryDrillParams | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 容灾演练的ID。 | | name | String | 容灾演练的名称。 | | status | String | 容灾演练的状态。 | | drill_vpc_id | String | 演练虚拟私有云id。 | | created_at | String | 创建时间。默认格式为："yyyy-MM-dd HH:mm:ss.SSS"，例："2019-04-01 12:00:00.000"。 | | updated_at | String | 更新时间。默认格式为："yyyy-MM-dd HH:mm:ss.SSS"，例："2019-04-01 12:00:00.000"。 | | server_group_id | String | 保护组的ID。 | | drill_servers | Array of [DrillServerParams] objects | 演练云服务器列表。 | 表6DrillServerParams | 参数 | 参数类型 | 描述 | |:---|:---|:---| | protected_instance | String | 演练云服务器对应的保护实例ID。 | | drill_server_id | String | 演练云服务器ID。 | **状态码： 400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表8ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 401** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表10ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 403** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表12ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 404** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表14ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 405** 表15响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表16ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 406** 表17响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表18ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 407** 表19响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表20ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 408** 表21响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表22ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 409** 表23响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表24ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 500** 表25响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表26ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 501** 表27响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表28ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 502** 表29响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表30ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 503** 表31响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表32ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | **状态码： 504** 表33响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error | [ErrorInfo] object | 失败返回结构 | 表34ErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | message | String | 错误信息 | | code | String | 错误码 | #### 请求示例 ``` GET https://{Endpoint}/v1/{project_id}/disaster-recovery-drills ``` #### 响应示例 **状态码： 200** OK ``` { "count" : 2, "disaster_recovery_drills" : [ { "id" : "e472d26f-9624-42fb-8bfc-717d4714c225", "name" : "dr_drill_test", "status" : "available", "server_group_id" : "c2aee29a-2959-4d01-9755-01cc76a4d17d", "drill_vpc_id" : "7881f1d2-1f41-419c-873a-14ac620bc46e", "created_at" : "2018-07-18 06:41:58.681", "updated_at" : "2018-07-18 09:41:14.677", "drill_servers" : [ { "protected_instance" : "d08ca8d7-a784-41ae-b32a-c592943f5dfc", "drill_server_id" : "9de0439a-4ee4-4199-919a-44afd20952dc" }, { "protected_instance" : "ea308e8b-043c-4fc6-a53c-856eae137b13", "drill_server_id" : "3eaa1c70-9719-4eb5-b577-cb92ddbffd03" } ] }, { "id" : "f96ac55f-35dd-4cc3-ba61-36c168900c99", "name" : "drill_test", "status" : "available", "server_group_id" : "3a60f45d-cf5b-49f1-a05e-ddee78cb6eef", "drill_vpc_id" : "ac784bd6-a79c-4def-9ff8-dc87940d5335", "created_at" : "2018-07-17 22:38:21.111", "updated_at" : "2018-07-17 22:47:54.845", "drill_servers" : [ ] } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | | 405 | Method Not Allowed | | 406 | Not Acceptable | | 407 | Proxy Authentication Required | | 408 | Request Timeout | | 409 | Conflict | | 500 | Internal Server Error | | 501 | Not Implemented | | 502 | Bad Gateway | | 503 | Service Unavailable | | 504 | Gateway Timeout | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-sdrs/ErrorCode.html)。