调用DescribeGroupedVul接口分组查询漏洞信息。

调试

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

请求参数

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

要执行的操作。取值:DescribeGroupedVul

Lang String zh

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

  • zh:中文
  • en:英文
Type String cve

要查询的漏洞类型。取值:

  • cve:Linux漏洞
  • sys:Windows漏洞
  • cms:WebCMS漏洞
  • app:应用漏洞
  • emg:应急漏洞
  • sca:软件成分分析
Uuids String d42f938c-d962-48a0-90f9-05e4ea****

要查询的服务器的UUID。多个UUID使用半角逗号(,)分隔。

AliasName String RHSA-2019:0230-Important: polkit security update

要查询的漏洞的别名。

Necessity String asap,later,nntf

要查询的漏洞修复的优先级。多个优先级使用半角逗号(,)分隔。取值:

  • asap:高
  • later:中
  • nntf:低
Dealed String n

漏洞是否处理。取值:

y:已处理

n:未处理

CurrentPage Integer 1

设置从返回结果的第几页开始显示查询结果。默认值为1,表示从第1页开始显示。

PageSize Integer 20

设置分页查询时,每页显示的漏洞信息的数量。默认值为10,表示每页显示10条漏洞信息。

GroupId String 235454

资产分组的ID。

SearchTags String 需要重启

按照标签过滤。取值:

  • 需要重启
  • 远程利用
  • 存在EXP
  • 可被利用
  • 本地提权
  • 代码执行

返回数据

名称 类型 示例值 描述
CurrentPage Integer 1

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

RequestId String 9BFA6D78-07EA-5C0A-9358-E4434573507B

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

PageSize Integer 20

分页查询时,每页显示的漏洞信息的数量。默认值为10,表示每页显示10条漏洞信息。

TotalCount Integer 1

查询结果的总数量。

GroupedVulItems Array of GroupedVulItem

查询到的漏洞信息。

Type String cve

漏洞类型。取值:

  • cve:Linux漏洞
  • sys:Windows漏洞
  • cms:WebCMS漏洞
  • app:应用漏洞
  • emg:应急漏洞
NntfCount Integer 59

修复优先级为的漏洞的数量。

HandledCount Integer 0

已处理的漏洞数量。

GmtLast Long 1639371446000

漏洞最后发现的时间戳,单位为毫秒。

Tags String 需要重启

漏洞标签。取值:

  • 需要重启
  • 远程利用
  • 存在EXP
  • 可被利用
  • 本地提权
  • 代码执行
LaterCount Integer 0

修复优先级为的漏洞的数量。

AliasName String RHSA-2017:0184-Important: mysql security update

漏洞别名。

Name String oval:com.redhat.rhsa:def:20170184

漏洞名称。

TotalFixCount Long 0

已修复漏洞的总数量。

AsapCount Integer 0

修复优先级为的漏洞的数量。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeGroupedVul
&Lang=zh
&Type=cve
&AliasName=RHSA-2019:0230-Important: polkit security update
&Necessity=asap,later,nntf
&Dealed=n
&CurrentPage=1
&PageSize=20
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<TotalCount>2</TotalCount>
<PageSize>20</PageSize>
<RequestId>0DFCADBA-7065-42DA-AF17-6868B9C2A8CF</RequestId>
<CurrentPage>1</CurrentPage>
<GroupedVulItems>
    <Type>cve</Type>
    <LaterCount>0</LaterCount>
    <GmtLast>1554185744000</GmtLast>
    <HandledCount>0</HandledCount>
    <AliasName>RHSA-2019:0230-Important: polkit security update</AliasName>
    <AsapCount>0</AsapCount>
    <TotalFixCount>0</TotalFixCount>
    <NntfCount>59</NntfCount>
    <Tags>需要重启</Tags>
    <Name>***glibc 安全和BUG修复更新</Name>
</GroupedVulItems>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : "2",
  "PageSize" : "20",
  "RequestId" : "0DFCADBA-7065-42DA-AF17-6868B9C2A8CF",
  "CurrentPage" : "1",
  "GroupedVulItems" : [ {
    "Type" : "cve",
    "LaterCount" : "0",
    "GmtLast" : "1554185744000",
    "HandledCount" : "0",
    "AliasName" : "RHSA-2019:0230-Important: polkit security update",
    "AsapCount" : "0",
    "TotalFixCount" : "0",
    "NntfCount" : "59",
    "Tags" : "需要重启",
    "Name" : "***glibc 安全和BUG修复更新"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission no permission 限制访问
500 ServerError ServerError 服务故障

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