获取子任务信息

最近更新时间: 2026-09-17 00:00:19

1. 接口描述

接口请求域名： remoteexecutor.api3.fincloud.tencent.cn。

GetSubTaskInfo

默认接口请求频率限制：20次/秒。

接口更新时间：2025-07-09 21:02:50。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：GetSubTaskInfo
Version	是	否	String	公共参数，本接口取值：2023-12-15
Region	是	否	String	公共参数，地域信息本接口不需要传递此参数。
TaskUUID	是	否	String	任务的uuid 示例值： 907b7dd9-6ad1-a04c-b1b5-94ac3c11b286
ShowDetail	否	否	Bool	操作类型示例值： true
SubTaskUUID	否	否	String	子任务UUID 示例值： 907b7dd9-6ad1-a04c-b1b5-94ac3c11b286
Status	否	否	String	任务状态示例值： Running
BatchIndex	否	否	Int64	BatchIndex 示例值： 1
TargetValue	否	否	String	目标主机示例值： 1.1.1.1
Offset	否	否	Int64	分页Offset 示例值： 1
Limit	否	否	Int64	分页Limit 示例值： 1

3. 输出参数

参数名称	类型	描述
TaskUUID	String	任务UUID 示例值： 907b7dd9-6ad1-a04c-b1b5-94ac3c11b286
Total	Int64	子任务数量示例值： 1
SubTaskList	Array of SubTask	子任务列表示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见公共错误码。

5. 示例

示例1 GetSubTaskInfo

输入示例

POST / HTTP/1.1
Host: tapi.fincloud.tencent.cn
Content-Type: application/json
X-TC-Action: GetSubTaskInfo
<公共请求参数>

{
    "Action": "GetSubTaskInfo",
    "AppId": 1255000065,
    "Language": "zh-CN",
    "OperatorUin": "110000000075",
    "RequestId": "0dd14411-2ece-6df9-1825-27e448369b81",
    "SubAccountUin": "110000000075",
    "Uin": "110000000075",
    "UserID": "julianewang",
    "TaskUUID": "907b7dd9-6ad1-a04c-b1b5-94ac3c11b286"
}

输出示例

 {
  "Response": {
    "TaskUUID": "3fec771e-bc98-4e70-a2d8-2317f557321d",
    "Total": 1,
    "SubTaskList": [
      {
        "SubTaskUUID": "a77b6aa1-3860-474d-944a-a4f38eb61706",
        "TaskUUID": "3fec771e-bc98-4e70-a2d8-2317f557321d",
        "Status": "Success",
        "BatchIndex": 1,
        "TargetType": 1,
        "TargetValue": "822559cf-738b-4fea-818a-b5e540c3726e",
        "Timeout": 30,
        "CreateTime": "2024-03-26T17:33:04+08:00",
        "UpdateTime": "2024-03-26T17:33:07+08:00"
      }
    ],
    "RequestId": "1f42e6d2-1f79-f943-72de-d93da8d4647e"
  }
}