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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeGroupedMaliciousFiles

需要执行的操作。

取值：DescribeGroupedMaliciousFiles。

CurrentPage Integer 是 1

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

PageSize String 是 20

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

Lang String 否 zh

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

  • zh：中文
  • en：英文
Levels String 否 serious

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

  • serious：紧急
  • suspicious：可疑
  • remind：提醒
FuzzyMaliciousName String 否 发现后门（Webshell）文件

要查询的恶意文件名称。

说明 支持模糊搜索。
RepoRegionId String 否 cn-shanghai

镜像仓库的地域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：印度（孟买）
RepoInstanceId String 否 cri-datvailb****

容器镜像的实例ID。

说明 调用容器镜像服务的ListRepository接口，通过返回参数InstanceId的值可以获取容器镜像实ID。
RepoId String 否 crr-vridcl4****

镜像仓库ID。

说明 调用容器镜像服务的ListRepository接口，通过返回参数RepoId的值可以获取镜像仓库ID。
RepoName String 否 centos

镜像仓库名称。

说明 支持模糊搜索。
RepoNamespace String 否 hanghai-namespace

镜像仓库命名空间名称。

说明 支持模糊查询。
ImageTag String 否 0.2

镜像标签。
ImageDigest String 否 6a5e103187b31a94592a47a5858617f7****

镜像摘要。
ImageLayer String 否 27213ad375b53628dd152a5ca****

镜像的层。

调用API时，除了本文中该API的请求参数，还需加入阿里云API公共请求参数。公共请求参数的详细介绍，请参见公共参数。

调用API的请求格式，请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
GroupedMaliciousFileResponse Array of GroupedMaliciousFile

恶意样本文件列表。
FirstScanTimestamp Long 1594907349000

首次扫描时间戳，单位：毫秒。
ImageCount Long 3

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

最新扫描时间戳，单位：毫秒。
Level String serious

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

  • serious：紧急
  • suspicious：可疑
  • remind：提醒
MaliciousMd5 String d836968041f7683b5459****

恶意文件的MD5值。
MaliciousName String 自变异木马

恶意文件的名称。
Status Integer 0

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

  • 0：未处理
  • 1：已处理
  • 2：验证中
  • 3：已加白
PageInfo Struct

分页信息。
Count Integer 2

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

分页查询时，当前页的页码。
PageSize Integer 20

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

TotalCount Integer 2

恶意样本文件的总数。
RequestId String 8045E03E-6D91-4C53-9F22-5A1B84BB29D9

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

示例

请求示例

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

正常返回示例

XML格式 

<DescribeGroupedMaliciousFilesResponse>
      <GroupedMaliciousFileResponse>
            <Status>0</Status>
            <LatestScanTimestamp>1596533942000</LatestScanTimestamp>
            <ImageCount>3</ImageCount>
            <MaliciousName>自变异木马</MaliciousName>
            <Level>serious</Level>
            <FirstScanTimestamp>1594907349000</FirstScanTimestamp>
            <MaliciousMd5>d836968041f7683b545900****</MaliciousMd5>
      </GroupedMaliciousFileResponse>
      <GroupedMaliciousFileResponse>
            <Status>1</Status>
            <LatestScanTimestamp>1594785387000</LatestScanTimestamp>
            <ImageCount>0</ImageCount>
            <MaliciousName>发现后门（Webshell）文件</MaliciousName>
            <Level>serious</Level>
            <FirstScanTimestamp>1594630261000</FirstScanTimestamp>
            <MaliciousMd5>d8b4074715b232d7d41***</MaliciousMd5>
      </GroupedMaliciousFileResponse>
      <PageInfo>
            <TotalCount>2</TotalCount>
            <PageSize>20</PageSize>
            <CurrentPage>1</CurrentPage>
            <Count>2</Count>
      </PageInfo>
      <RequestId>8045E03E-6D91-4C53-9F22-5A1B84BB29D9</RequestId>
</DescribeGroupedMaliciousFilesResponse>

JSON格式 

{
	"GroupedMaliciousFileResponse": [{
		"Status": 0,
		"LatestScanTimestamp": 1596533942000,
		"ImageCount": 3,
		"MaliciousName": "自变异木马",
		"Level": "serious",
		"FirstScanTimestamp": 1594907349000,
		"MaliciousMd5": "d836968041f7683b545900****"
	}, {
		"Status": 1,
		"LatestScanTimestamp": 1594785387000,
		"ImageCount": 0,
		"MaliciousName": "发现后门（Webshell）文件",
		"Level": "serious",
		"FirstScanTimestamp": 1594630261000,
		"MaliciousMd5": "d8b4074715b232d7d41***"
	}],
	"PageInfo": {
		"TotalCount": 2,
		"PageSize": 20,
		"CurrentPage": 1,
		"Count": 2
	},
	"RequestId": "8045E03E-6D91-4C53-9F22-5A1B84BB29D9"
}

错误码

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