首页 >云安全中心 >API参考指南 >API目录 >镜像安全扫描 >DescribeGroupedMaliciousFiles - 查询镜像恶意样本文件列表信息

DescribeGroupedMaliciousFiles - 查询镜像恶意样本文件列表信息

调用DescribeGroupedMaliciousFiles接口查询镜像恶意样本文件列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Langstring

请求和接收消息的语言类型,默认为zh。取值:

  • zh:中文
  • en:英文
zh
Levelsstring

要查询的镜像恶意样本的危险程度。可输入多个值,多个值之间使用英文逗号(,)分隔。取值:

  • serious:紧急
  • suspicious:可疑
  • remind:提醒
serious
FuzzyMaliciousNamestring

要查询的恶意文件名称。

说明支持模糊搜索。
发现后门(Webshell)文件
CurrentPageinteger

从返回结果中的第几页开始显示。起始值为1。默认值为1,表示从第1页开始显示。

1
PageSizestring

分页查询时,每页显示的数据的最大条数。默认值为20

20
RepoRegionIdstring

镜像仓库的地域ID。取值:

  • cn-beijing:华北2(北京)
  • cn-zhangjiakou:华北3(张家口)
  • cn-hangzhou:华东1(杭州)
  • cn-shanghai:华东2(上海)
  • cn-shenzhen:华南1(深圳)
  • cn-hongkong:中国香港
  • ap-southeast-1:新加坡
  • ap-southeast-5:印度尼西亚(雅加达)
  • us-east-1:美国(弗吉尼亚)
  • us-west-1:美国(硅谷)
  • eu-central-1:德国(法兰克福)
  • eu-west-1:英国(伦敦)
  • ap-south-1:印度(孟买)
cn-shanghai
RepoInstanceIdstring

容器镜像的实例ID。

说明调用容器镜像服务的ListRepository接口,通过返回参数InstanceId的值可以获取容器镜像实ID。
cri-datvailb****
RepoIdstring

镜像仓库ID。

说明调用容器镜像服务的ListRepository接口,通过返回参数RepoId的值可以获取镜像仓库ID。
crr-vridcl4****
RepoNamestring

镜像仓库名称。

说明支持模糊搜索。
centos
RepoNamespacestring

镜像仓库命名空间名称。

说明支持模糊查询。
hanghai-namespace
ImageTagstring

镜像标签。

0.2
ImageDigeststring

镜像摘要。

6a5e103187b31a94592a47a5858617f7****
ImageLayerstring

镜像的层。

27213ad375b53628dd152a5ca****
ClusterIdstring

需要查询异常事件的服务器的集群ID。

c556c8133b5ad4378b7fc533ddbda****

返回参数

名称类型描述示例值
object
RequestIdstring

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

8045E03E-6D91-4C53-9F22-5A1B84BB29D9
PageInfoobject

分页信息。

CurrentPageinteger

分页查询时,当前页的页码。

1
PageSizeinteger

分页查询时,每页显示的数据的最大条数。默认值为20

20
TotalCountinteger

恶意样本文件的总数。

2
Countinteger

当前页返回的恶意样本文件的数量。

2
GroupedMaliciousFileResponsearray

恶意样本文件列表。

object
Statusinteger

镜像恶意样本的处理状态。取值:

  • 0:未处理
  • 1:已处理
  • 2:验证中
  • 3:已加白
0
ImageCountLong

被恶意样本影响的镜像数量。

3
LatestScanTimestampLong

最新扫描时间戳,单位:毫秒。

1596533942000
MaliciousNamestring

恶意文件的名称。

自变异木马
MaliciousMd5string

恶意文件的MD5值。

d836968041f7683b5459****
FirstScanTimestampLong

首次扫描时间戳,单位:毫秒。

1594907349000
Levelstring

镜像恶意样本的危险程度。取值:

  • serious:紧急
  • suspicious:可疑
  • remind:提醒
serious

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeGroupedMaliciousFiles
&CurrentPage=1
&PageSize=20
&<公共请求参数>

正常返回示例

JSON格式

{
  "RequestId": "8045E03E-6D91-4C53-9F22-5A1B84BB29D9",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 2,
    "Count": 2
  },
  "GroupedMaliciousFileResponse": [
    {
      "Status": 0,
      "ImageCount": 3,
      "LatestScanTimestamp": 1596533942000,
      "MaliciousName": "自变异木马",
      "MaliciousMd5": "d836968041f7683b5459****",
      "FirstScanTimestamp": 1594907349000,
      "Level": "serious"
    }
  ]
}

错误码

Http code错误码错误信息描述
500ServerErrorServerError服务故障

访问错误中心查看更多错误码。

阿里云首页 云安全中心 相关技术圈