响应参数
5.4 保护组
5.4.8 保护组故障切换
功能介绍
当保护组的生产站点发生故障时，将保护组的生产站点切到当前的容灾站点，即另一 端AZ，启用当前容灾站点的云硬盘以及云服务器等资源。 故障切换完成之后，保护组 的当前生产站点变成故障切换发生之前的容灾站点，且生产站点和容灾站点之间的数 据已停止保护，必须调用5.4.6-保护组开启保护/重保护接口成功后，两端的数据才会 重新被保护。
接口约束
保护组中必须包含复制对才能故障切换。 保护组status为protected或error-failing-over或error-reversing才能故障切换。 如果调用原生接口删除保护实例的生产站点或 者容灾站点服务器，该保护实例以及该保护实例所在的保护组将不能执行任何操作。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/{project_id}/server-groups/{server_group_id}/action
表5-346 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID。
server_group_
id 是 String 保护组的ID。
请求参数
表5-347 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。通过调用IAM服务 获取用户Token接口获取（响应 消息头中X-Subject-Token的 值）
表5-348 请求 Body 参数
参数 是否必选 参数类型 描述
failover-server-group 是 Object 标识保护组故障切换操作。该参 数目前默认值为空。
响应参数
状态码： 200
表5-349 响应 Body 参数
参数 参数类型 描述
job_id String 成功返回jobId信息
状态码： 400
表5-350 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-351 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 401
表5-352 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-353 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 403
表5-354 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-355 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 404
表5-356 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-357 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 405
表5-358 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-359 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 406
表5-360 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-361 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 407
表5-362 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-363 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 408
表5-364 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-365 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 409
表5-366 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-367 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 500
表5-368 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-369 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 501
表5-370 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-371 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 502
表5-372 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-373 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 503
表5-374 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-375 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 504
表5-376 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-377 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
请求示例
POST https://{Endpoint}/v1/{project_id}/server-groups/40df180b-9fe2-471a-8c64-1b758dc84189/action { "failover-server-group" : { }
}
响应示例
状态码： 200 OK
{ "job_id" : "ff8080826adfae02016ae2d123fc05ed"
}
状态码
状态码 描述
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
错误码
请参见错误码。