文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 容器镜像/ 本地镜像漏洞批量导出(支持全量导出) - BatchExportLocalVulTask
更新时间:2025-10-31 GMT+08:00
分享

本地镜像漏洞批量导出(支持全量导出) - BatchExportLocalVulTask

功能介绍

本地镜像漏洞批量导出(支持全量导出)

授权信息

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

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

URI

POST /v5/{project_id}/image/local-vulnerability/export

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

主机所属的企业项目ID。

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

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

export_size

Integer

导出数据条数

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

region

String

Region ID

表4 请求Body参数

参数

是否必选

参数类型

描述

image_id_list

Array of strings

要导出的镜像信息列表,operate_all参数为false时需要填写批量查询条件,image_id 镜像id,唯一镜像标识(注:对私有镜像和共享镜像来说是镜像列表返回的id)

operate_all

Boolean

若为true全量查询,可筛选条件全部查询

vul_type

String

漏洞类型,包含如下:

-linux_vul : linux漏洞

-app_vul : 应用漏洞

handle_status

String

漏洞处置状态,包含如下:

  • unhandled :未处理

  • handled : 已处理

scan_status

String

参数解释:

扫描状态

约束限制:

不涉及

取值范围:

  • unscan : 未扫描。

  • success : 扫描完成。

  • scanning : 扫描中。

  • failed : 扫描失败。

  • download_failed : 下载失败。

  • image_oversized : 镜像超大。

  • waiting_for_scan : 等待扫描。

  • image_scan_stop : 扫描终止。

默认取值:

不涉及

image_name

String

镜像名称

image_version

String

镜像版本

image_size

Long

镜像大小

start_latest_update_time

Long

创建时间开始日期,时间单位 毫秒(ms)

end_latest_update_time

Long

创建时间结束日期,时间单位 毫秒(ms)

start_latest_scan_time

Long

最近一次扫描完成时间开始日期,时间单位 毫秒(ms)

end_latest_scan_time

Long

最近一次扫描完成时间结束日期,时间单位 毫秒(ms)

has_container

Boolean

参数解释:

是否存在容器

约束限制:

不涉及

取值范围:

  • true:是。

  • false:否。

默认取值:

不涉及

vul_id_list

Array of strings

导出镜像漏洞时的漏洞id列表

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

record_total_num

Long

参数解释:

导出记录总数

取值范围:

最小值0,最大值2147483647

task_id

String

参数解释:

导出任务ID

取值范围:

字符长度1-256位

请求示例

{
  "operate_all" : true
}

响应示例

状态码:200

请求已成功

{
  "record_total_num" : 1,
  "task_id" : "asdwwqdtut01"
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档