调用CreateFailoverTestJob接口创建高速通道故障演练任务。
接口说明
演练资源状态要求(前置条件)
创建故障演练任务前,请确保演练资源及其关联资源处于以下状态,否则创建失败:
ResourceType 取 PHYSICALCONNECTION:物理专线(含共享物理专线)必须处于 Enabled 状态,且计费状态正常(未欠费),否则返回 IncorrectStatus.ResourceId 或 IncorrectBusinessStatus.ResourceId。
ResourceType 取 VIRTUALBORDERROUTER:VBR 必须处于 active 状态且未欠费,同时该 VBR 所属的物理专线也必须处于 Enabled 状态且未欠费。
ResourceType 取 BGPPEER:BGP 邻居必须处于 Available 状态,且其所属 VBR 处于 active 状态、VBR 所属物理专线处于 Enabled 状态,均未欠费。
如何检查与推进物理专线状态
- 调用 DescribePhysicalConnections 查询物理专线的 Status 字段。若专线不是 Enabled 状态(例如处于 Allocated 或 Confirmed),请按以下状态流转路径推进:
Allocated(端口已预留,待确认)→ 调用 ConfirmPhysicalConnection 确认 → Confirmed → 调用 EnablePhysicalConnection 开通(异步,开通完成后轮询 DescribePhysicalConnections 确认)→ Enabled。
注意:EnablePhysicalConnection 仅支持开通 Confirmed 状态的物理专线;专线处于 Allocated 状态时必须先调用 ConfirmPhysicalConnection。
JobType 取 StartLater 时,任务创建阶段即执行上述状态校验;后续调用 StartFailoverTestJob 启动任务时会再次校验资源状态,若届时资源状态不满足要求(例如专线不再处于 Enabled 状态),启动将失败。
以下场景不支持创建故障演练任务:
-
当前地域您已经有正在演练的故障演练任务,且本次创建故障演练任务的任务类型为立即开始。
-
物理专线实例或者共享物理专线实例没有支付完成或者处于欠费状态。
-
物理专线实例或者共享物理专线实例处于其他正在演练的故障演练任务中。
-
物理专线实例下有超过 1 个共享物理专线。
-
物理专线实例下有超过 1 个跨账号 VBR。
-
共享物理专线实例没有绑定 VBR。
-
共享物理专线实例的 VLAN 配置为 0。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
vpc:CreateFailoverTestJob |
create |
*VirtualBorderRouter
*PhysicalConnection
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
故障演练任务所在的地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-hangzhou |
| ClientToken |
string |
否 |
客户端 Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。 说明
若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。 |
123e4567-e89b-12d3-a456-426655440000 |
| Name |
string |
否 |
故障演练任务的名称。 长度为 0~128 个字符,不能以 |
test |
| Description |
string |
否 |
故障演练任务的描述信息。 长度为 0~256 个字符,不能以 |
test |
| ResourceType |
string |
是 |
演练资源类型。取值:PHYSICALCONNECTION 物理专线。 枚举值:
|
PHYSICALCONNECTION |
| ResourceId |
array |
是 |
演练资源 ID 列表。最多可以添加 16 个演练资源。 |
|
|
string |
否 |
演练资源 ID。 |
pc-uf66k4e8pq3r00jfq**** |
|
| JobType |
string |
是 |
故障演练任务方式。取值:
枚举值:
|
StartNow |
| JobDuration |
integer |
是 |
故障演练任务时长。单位为分钟,取值范围为:1~4320。 |
60 |
| DryRun |
boolean |
否 |
是否只预检此次请求。取值范围:
|
false |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回参数。 |
||
| RequestId |
string |
请求 ID。 |
C44F62BE-9CE7-4277-B117-69243F3988BF |
| JobId |
string |
故障演练任务 ID。 |
ftj-bp1yh6mvi13aq3g8w**** |
示例
正常返回示例
JSON格式
{
"RequestId": "C44F62BE-9CE7-4277-B117-69243F3988BF\n",
"JobId": "ftj-bp1yh6mvi13aq3g8w****"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | IllegalParam.Name | The param of Name [%s] is illegal. | 参数 Name 不合法,请根据请求参数规定重新输入。 |
| 400 | IllegalParam.Description | The param of Description [%s] is illegal. | 参数Description 不合法,请根据请求参数规定重新输入。 |
| 400 | IllegalParam.ResourceType | Invalid Resource Type value. | 指定的ResourceType未支持或不合法 |
| 400 | EcFailoverTestJobExceedMaxResourceNum | The input resource number is exceeded the quota of 16. | 故障演练任务最多可以添加16个资源。 |
| 400 | EcFailoverTestJobResourceInAnotherProcessingJob | There is another processing failover test job. | 当前用户已经存在一个正在进行的故障演练任务,请完成后再重试。 |
| 400 | IllegalParam.ResourceId | The input parameter resource ID is invalid. | 输入的参数资源ID不合法 |
| 400 | IncorrectStatus.ResourceId | The specified resource status is invalid. | 输入的资源ID对应的资源状态不合法。 |
| 400 | IncorrectBusinessStatus.ResourceId | The specified resource business status is invalid. | 输入的资源处于欠费状态。 |
| 400 | VpconnNotAssociatedVbr | The specified vpconn is not associated with vbr. | 输入的共享物理专线没有关联虚拟边界路由器 |
| 400 | VpconnWithVlan0NotSupportShutdown | The specified virtualPhysicalConnection with vlan 0 does not support shutdown. | VLAN 0的共享物理专线不支持进行故障演练。 |
| 400 | PconnContainsMoreThanOneVpconn | The specified physicalConnection contains more than one virtualPhysicalConnection. | 包含了超过1个共享物理专线的物理专线不支持故障演练。 |
| 400 | PconnContailsMoreThanOneAcrossCountVbr | The specified physicalConnection contains more than one virtualBorderRouter which is across count. | 包含了超过1个跨账号VBR的物理专线不支持故障演练。 |
| 400 | IllegalParam.JobType | The specified parameter JobType is illegal. | 输入的任务类型不合法。 |
| 400 | IllegalParam.JobDuration | The specified parameter JobDuration is illegal. | 输入的任务时长不合法。 |
| 400 | AnotherJobTesting | There is another job which is testing. | 同一个用户在同一个地域只能同时进行一个故障演练任务。 |
| 400 | MultiplePconnSingleVbrNotSupportShutdown | Vbr for single vbr and multiple pconn scenarios does not support failover test job. | 单vbr多pconn场景的vbr不支持故障演练。 |
| 400 | EcFailoverTestJobConflict | The current failover test job task is in operation, please try again later. | 当前的故障演练任务正在操作中,请稍后重试。 |
| 400 | OperationDeny.VbrWithVlan0 | The specified VirtualBorderRouter with vlan 0 does not support shutdown. | 输入的VBR的VLAN为0,不支持进行故障演练,请使用物理专线进行故障演练。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。