接口说明
约束说明
保护组中必须包含复制对才能故障切换。 保护组status为protected或error-failing-over或error-reversing才能故障切换。 如果调用原生接口删除保护实例的生产站点或者容灾站点服务器,该保护实例以及该保护实例所在的保护组将不能执行任何操作。
URL
POST https://sdrs.cn-north-4.myhuaweicloud.com/v1/{project_id}/server-groups/{server_group_id}/action
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
|
project_id
|
string | path | 是 |
项目ID。 |
|
server_group_id
|
string | path | 是 |
保护组的ID。 |
Body参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
failover-server-group
|
failover-server-group object | 是 |
标识保护组故障切换操作。该参数目前默认值为空。 |
返回参数
返回码: 200
OK
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
job_id
|
string | 是 |
成功返回jobId信息 |
返回码: 400
Bad Request
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
400 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 401
Unauthorized
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
401 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 403
Forbidden
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
403 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 404
Not Found
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
404 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 405
Method Not Allowed
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
405 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 406
Not Acceptable
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
406 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 407
Proxy Authentication Required
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
407 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 408
Request Timeout
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
408 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 409
Conflict
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
409 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 500
Internal Server Error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
500 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 501
Not Implemented
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
501 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 502
Bad Gateway
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
502 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 503
Service Unavailable
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
503 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
返回码: 504
Gateway Timeout
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
error
|
ErrorInfo object | 否 |
失败返回结构 |
504 error
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
message
|
string | 是 |
错误信息 |
|
code
|
string | 是 |
错误码 |
请求示例
示例 1
"POST https://{Endpoint}/v1/{project_id}/server-groups/40df180b-9fe2-471a-8c64-1b758dc84189/action"
{ "failover-server-group": {} }
返回示例
返回码：200
OK
示例 1
{
"job_id": "ff8080826adfae02016ae2d123fc05ed"
}
"job_id": "ff8080826adfae02016ae2d123fc05ed"
}
SDK
点击 存储容灾 服务 (SDRS) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明。
