查询参数模板异步任务结果

最近更新时间:2020-03-04 10:06:06

我的收藏

1. 接口描述

本接口(DescribeNetTaskResult)用于查询(网络)参数模板异步任务的执行结果。 接口请求域名:vpc.api.qcloud.com。
查询时指定异步任务 ID。该 ID 来自(网络)参数模板异步接口的调用。
本接口中所指定任务 ID 区别于(网络)参数模板以外的异步任务 ID,故两者的 ID 值可能相同。
(网络)参数模板异步任务 ID 可重复查询。在任务执行过程中,任务的结果可能发生变化,例如一些异步查询的结果。

2. 请求参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 DescribeNetTaskResult。
参数名称
必选
类型
描述
taskId
Int
请求任务 ID,由具体的异步操作接口提供,例如 15454。

3. 输出参数

参数名称
类型
描述
code
Int
数字错误码, 0 表示查询调用成功,其他值表示失败。详见错误码页面的 公共错误码
message
String
模块错误信息描述,与接口相关。
codeDesc
String
字符串错误码。
data
Object
返回信息。
data.status
Int
任务的当前状态。0:成功,1:失败,2:进行中。
data.output
Object
任务执行中间状况详情。任务的最终成败以 data.status 为准。
data.data
Object/Array
仅用于任务为查询类任务时的结果数据或中间结果数据。具体数据格式由具体的异步接口提供。
data.output 结构
参数名称
类型
描述
code
Int
数字错误码。
message
String
结果描述。

4. 错误码表

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 公共错误码
错误码数值
原因
29257
后台错误,请求失败。
29258
引用资源不存在。
29259
关联对象因规则展开过大拒绝您的关联。
29260
参数模板总数或成员数使用超限。
29254
鉴权失败。
9003
参数错误。
9005
系统忙或有相关资源正在被编辑。

5. 示例

执行一个参数模板的异步调用,然后使用 DescribeNetTaskResult 查询结果。
例如查询一个协议端口模板是否被云资源引用:

步骤1:

输入
https://vpc.api.qcloud.com/v2/index.php?Action=DescribeNetTaskResult
&serviceId=ppm-i0836656
输出
{
"code": 0,
"message": "",
"codeDesc": "Success",
"data": {
"taskId": 297
}
}

步骤2:

输入
https://vpc.api.qcloud.com/v2/index.php?Action=DescribeNetTaskResult
&taskId=297
输出
{
"code": 0,
"message": "",
"codeDesc": "Success",
"data": {
"status": 0,
"output": {
"code": 0,
"message": "OK"
},
"data": {
"total": 4,
"detail": [{
"region": "ca",
"type": "sg",
"id": "sg-b2qce888",
"name": "北美"
},
{
"region": "gz",
"type": "sg",
"id": "sg-5y2ta666",
"name": "createPolicy"
},
{
"region": "sh",
"type": "sg",
"id": "sg-gt6an666",
"name": "上海安全组"
},
{
"region": "gz",
"type": "sg",
"id": "sg-jn3hnxyj",
"name": "广州安全组"
}
]
}
}
}