文档首页/ 业务恢复服务 BRS/ API参考/ API/ 容灾演练/ 查询容灾演练列表
更新时间：2025-09-10 GMT+08:00
编辑
查看PDF
分享

查询容灾演练列表

功能介绍

查询指定保护组下的所有容灾演练列表，当未指定保护组时查询当前租户下的所有容灾演练列表。

接口约束

无

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/disaster-recovery-drills

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。
表2 Query参数

参数

是否必选

参数类型

描述

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

列表中包含的容灾演练个数。
表5 ShowDisasterRecoveryDrillParams

参数

参数类型

描述

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

演练云服务器列表。
表6 DrillServerParams

参数

参数类型

描述

protected_instance

String

演练云服务器对应的保护实例ID。

drill_server_id

String

演练云服务器ID。

状态码： 400

表7 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表8 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 401

表9 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表10 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 403

表11 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表12 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 404

表13 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表14 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 405

表15 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表16 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 406

表17 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表18 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 407

表19 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表20 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 408

表21 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表22 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 409

表23 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表24 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 500

表25 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表26 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 501

表27 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表28 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 502

表29 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表30 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 503

表31 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表32 ErrorInfo

参数

参数类型

描述

message

String

错误信息

code

String

错误码

状态码： 504

表33 响应Body参数

参数

参数类型

描述

error

ErrorInfo object

失败返回结构
表34 ErrorInfo

参数

参数类型

描述

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

错误码

请参见错误码。

父主题： 容灾演练

相关文档