文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 容器镜像/ 查询租户恶意文件列表 - ListGlobalMalware
更新时间:2025-10-31 GMT+08:00
分享

查询租户恶意文件列表 - ListGlobalMalware

功能介绍

查询租户恶意文件列表

授权信息

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

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

URI

GET /v5/{project_id}/image/malwares

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

主机所属的企业项目ID。

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

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

image_type

String

镜像类型,包含如下:

  • registry : 仓库镜像

  • cicd : cicd镜像

file_name

String

文件名称(支持模糊查询)

limit

Integer

默认10

offset

Integer

默认0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

region

String

Region ID

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total_num

Integer

Global恶意文件总数

data_list

Array of GlobalMalwareInfo objects

漏洞总数

表5 GlobalMalwareInfo

参数

参数类型

描述

file_name

String

文件名称

file_path

String

文件路径

size

Long

文件大小

latest_scan_time

Long

最近扫描时间,时间单位 毫秒(ms)

description

String

文件描述

image_type

String

仓库镜像类型,包含如下:

  • SwrPrivate : swr私有镜像

  • SwrShared : swr共享

  • SwrEnterprise : swr企业

  • Harbor : harbor仓库

  • Jfrog : jfrog仓库

  • Other : 其他仓库

namespace

String

组织名称

image_name

String

镜像名称

image_version

String

镜像版本名称

image_id

String

镜像id

instance_id

String

企业仓库实例ID

请求示例

响应示例

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档