文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 事件管理/ 查询导出任务信息 - ListQueryExportTask
更新时间：2025-10-31 GMT+08:00
查看PDF
分享

查询导出任务信息 - ListQueryExportTask

功能介绍

查询导出任务信息

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v5/{project_id}/export-task/{task_id}

表1 路径参数

参数

是否必选

参数类型

描述

task_id

是

String

任务id

project_id

是

String

项目ID
表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

否

String

主机所属的企业项目ID。

开通企业项目功能后才需要配置企业项目。

企业项目ID默认取值为“0”，表示默认企业项目。如果需要查询所有企业项目下的主机，请传参“all_granted_eps”。如果您只有某个企业项目的权限，则需要传递该企业项目ID，查询该企业项目下的主机，否则会因权限不足而报错。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

region

否

String

Region ID

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

task_id

String

参数解释：

任务ID

取值范围：

字符长度1-64位

task_name

String

参数解释：

任务名称

取值范围：

字符长度1-128位

task_status

String

参数解释：

导出任务状态

取值范围：

  • success：成功

  • failure：失败

  • running：运行中

file_id

String

参数解释：

文件ID

取值范围：

字符长度1-64位

file_name

String

参数解释：

文件名

取值范围：

字符长度1-255位

请求示例

根据task_id查询导出任务id,状态和名称

GET https://{endpoint}/v5/{project_id}/export-task/{task_id}?enterprise_project_id=all_granted_eps

响应示例

状态码：200

请求已成功

{
  "task_id" : "94ad7efb-xxxxx-46ed-99bf-dcd8c1c75dc2",
  "task_name" : "vul_vul_xxxxxxx_export_task",
  "task_status" : "success",
  "file_id" : "b3e83d25-d92f-4963-a293-e056e81ec44d",
  "file_name" : "hss-vul-vul-zh-xxxxxxxx.zip"
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码。

父主题： 事件管理

相关文档