文档中心

专线连接

故障演练任务

DescribeFailoverJobAttributes - 查询故障演练任务

调用 DescribeFailoverJobAttributes 接口，查询指定故障演练任务的详细信息。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action String 必选示例值：DescribeFailoverJobAttributes

接口名称。当前 API 的名称为 DescribeFailoverJobAttributes。

Version String 必选示例值：2020-04-01

接口版本。当前 API 的版本为 2020-04-01。

JobID String 必选示例值：foj-1234***

故障演练任务的ID。

您可以调用DescribeFailoverJobs接口查询故障演练任务的ID。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

AccountId String 示例值：20000***

用户的账号ID。

CreatedAt String 示例值：2025-07-03 10:48:21

故障演练任务创建的时间。

Description String 示例值：This is a FailoverJob

故障演练任务的描述。

JobDuration Integer 示例值：10

故障演练时长，单位：分钟。

JobId String 示例值：foj-1234****

故障演练任务的ID。

JobName String 示例值：FailoverJob-01

故障演练任务的名称。

JobStartAt String 示例值：2025-07-03 10:48:21

故障演练任务开始的时间。如果任务尚未开始，返回-。

JobStatus String 示例值：starting

故障演练任务的状态。

creating：任务创建中。

updating：任务更新中。

prepare：任务未启动。

starting：任务启动中。

running：任务运行中。

stopping：任务结束中。

completed：任务完成。

deleting：任务删除中。

JobStopAt String 示例值：2025-07-03 10:58:21

故障演练任务完成的时间。如果任务尚未完成，返回-。

JobTotalTime Integer 示例值：600

故障演练任务实际运行总时长，单位：秒。如果任务尚未完成，返回0。

JobType String 示例值：dcc

演练任务的类型。

dcc：物理专线。

bgp：BGP邻居。

ObjectCount Integer 示例值：1

故障演练对象资源总数。

Objects Object[] 示例值：-

故障演练对象资源的详细信息。

ObjectId String 示例值：dcc-d012mga***

故障演练对象资源的ID。

DirectConnectConnectionName String 示例值：dcc-01

物理专线的名称。

VirtualInterfaceId String 示例值：dcv-7qth0ll6jmc****

虚拟接口的ID。

VirtualInterfaceName String 示例值：dcv-01

虚拟接口的名称。

PeerIp String 示例值：192.XX.XX.1/24

对端网关互联IP地址。

LocalIp String 示例值：192.XX.XX.2/24

本端网关互联IP地址。

ConnectionType String 示例值：SharedConnection

物理专线的类型。

SharedConnection：共享专线。

DedicatedConnection：独享专线。

请求示例

GET /?Action=DescribeFailoverJobAttributes&Version=2020-04-01&JobID=foj-1234*** HTTP/1.1​
Host: directconnect.cn-beijing.volcengineapi.com​
X-Date: 20251121T094038Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/directconnect/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20211222112033010224****",​
        "Action": "DescribeFailoverJobAttributes",​
        "Version": "2020-04-01",​
        "Service": "directconnect",​
        "Region": "ap-southeast-1"​
    },​
    "Result": {​
        "RequestId": "20211222112033010224****",​
        "AccountId": "20000***",​
        "CreatedAt": "2025-07-03 10:48:21",​
        "Description": "This is a FailoverJob",​
        "JobDuration":10,​
        "JobId":"foj-1234****",​
        "JobName":"FailoverJob-01",​
        "JobStartAt":"2025-07-03 10:48:21",​
        "JobStatus":"starting",​
        "JobStopAt":"2025-07-03 10:58:21",​
        "JobTotalTime":"600",​
        "JobType":"dcc",​
        "ObjectCount":"1",​
            "Object":{​
                [​
                 "ObjectId":"dcc-d012mga***", ​
                 "DirectConnectConnectionName":"dcc-01",​
                 "ConnectConnectionType":"DedicatedConnection"​
                     ]​
              }​
          }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidFailoverJob.IsNull	The failover job does not exist.	故障演练任务不存在。
403	Forbidden	You are not authorized to perform operations on the specified shared connection.	无权限对指定的共享专线进行操作。
403	InvalidDirectConnectVirtualInterface.CrossAccountForbidden	You are not authorized to allocate the specified virtual interface to other account.	无权限将指定的虚拟接口共享给其他账号。
403	InvalidFailoverJob.Forbidden	You are not authorized to perform failover job operations on the specified account.	无权限对指定的账号进行故障演练任务操作。
500	InvalidFailoverJob.Forbidden	You are not authorized to perform failover job operations on the specified account.	无权限对指定的账号进行故障演练任务操作。

最近更新时间：2026.01.23 17:00:43

这个页面对您有帮助吗？

有用

无用