调用DescribeVulList根据漏洞类型查询对应漏洞信息_云安全中心(Security Center)-阿里云帮助中心

根据漏洞类型查询对应漏洞信息。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作

操作	访问级别	资源类型	条件关键字	关联操作
yundun-sas:DescribeVulList	get	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值

名称	类型	必填	描述	示例值
Lang	string	否	设置请求和接收消息的语言类型，默认为 zh。取值： zh：中文 en：英文	zh
Ids	string	否	漏洞 ID 列表，多个 ID 之间使用半角逗号（,）分隔，最多 50 个。	282,281,283
Remark	string	否	要查询漏洞的资产信息，可以设置为资产名称、公网 IP 或私网 IP。	1.2.XX.XX
GroupId	string	否	要查询的资产分组 ID。说明您可以调用 DescribeAllGroups 接口获取该参数。	9207613
Type	string	是	要查询的漏洞类型。取值： cve：Linux 软件漏洞 sys：Windows 系统漏洞 cms：Web-CMS 漏洞 app：应用漏洞（web 扫描器） emg：应急漏洞 sca：应用漏洞（软件成分分析）	cve
Uuids	string	否	要查询漏洞的服务器的 UUID，多个 UUID 之间使用半角逗号（,）分隔。说明您可以调用 DescribeCloudCenterInstances 接口获取该参数。	1587bedb-fdb4-48c4-9330-****
Name	string	否	漏洞名称。	oval:com.redhat.rhsa:def:20172836
AliasName	string	否	漏洞别名。	RHSA-2019:0230-Important: polkit security update
StatusList	string	否	漏洞状态，多个用英文逗号隔开。取值： 1：未修复 2：修复失败 3：回滚失败 4：修复中 5：回滚中 6：验证中 7：修复成功 8：修复成功待重启 9：回滚成功 10：已忽略 11：回滚成功待重启 12：漏洞不存在 20：已失效	1,2,3
Necessity	string	否	要查询的漏洞修复必要性等级。多个等级之间使用半角逗号（,）分隔。取值： asap：高 later：中 nntf：低	asap,later,nntf
Dealed	string	否	要查询的漏洞是否已修复。取值： y：已修复 n：未修复	n
CurrentPage	integer	否	设置从返回结果的第几页开始显示查询结果。默认值为 1，表示从第 1 页开始显示。	1
PageSize	integer	否	设置分页查询时，每页显示的漏洞信息的数量。默认值为 10，表示每页显示 10 条漏洞信息。	20
AttachTypes	string	否	查询应用漏洞时的附加漏洞类型。该参数固定取值为 sca。查询应用漏洞（即 Type 设置为 app）时需要设置该参数。说明如果该参数设置为 sca，可查询应用漏洞（app 类型）及软件成分分析（sca 类型）漏洞，如果不设置该参数，只查询应用漏洞。	sca
TargetType	string	否	漏洞所在资产类型。取值包括： k8s：K8S 组件 uuid：服务器 containerId：容器	k8s
ClusterId	string	否	集群 ID。	c88fb10da1168494091db6aafc5dd****
VpcInstanceIds	string	否	要查询漏洞的 VPC 实例 ID。多个之间 ID 使用半角逗号（,）分隔。	ins-133**,ins-5414**
ResourceDirectoryAccountId	long	否	资源目录成员账号主账号 ID。说明调用 DescribeMonitorAccounts 接口可以获取该参数。	1232428423234****
UseNextToken	boolean	否	是否使用 NextToken 方式拉取漏洞列表数据。如果使用此参数 TotalCount 不再返回。取值： true：使用 NextToken 方式 false：不使用 NextToken 方式	false
NextToken	string	否	使用 NextToken 方式下返回的 NextToken 值。第一次拉取传空。	E17B501887A2D3AA5E8360A6EFA3B***

返回参数

名称	类型	描述	示例值

名称	类型	描述	示例值
	object
CurrentPage	integer	分页查询时，当前页的页码。	1
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	2F26AB2A-1075-488F-8472-40E5DB486ACC
PageSize	integer	分页查询时，每页最多显示的数据条数。	20
TotalCount	integer	查询到的漏洞总数量。	2
VulRecords	array<object>	查询到的漏洞信息。
VulRecord	object
Status	integer	漏洞状态。取值： 1：未修复 2：修复失败 3：回滚失败 4：修复中 5：回滚中 6：验证中 7：修复成功 8：修复成功待重启 9：回滚成功 10：已忽略 11：回滚成功待重启 12：漏洞不存在 20：已失效	1
RaspDefend	integer	支持 RASP 实时防护，取值： 0：不支持 1：支持说明无该属性也表示不支持。	1
RaspStatus	integer	RASP 实时防护模式。取值： 0：未防护 1：监控模式 2：拦截模式 3：禁用	1
Type	string	漏洞类型。取值： cve：Linux 漏洞 sys：Windows 漏洞 cms：WebCMS 漏洞 emg：应急漏洞 app：应用漏洞 sca：应用漏洞（软件成分分析）	cve
ModifyTs	long	修改漏洞状态时间戳，单位为毫秒。	1620404763000
InternetIp	string	资产公网 IP。	1.2.XX.XX
PrimaryId	long	漏洞 ID。	101162078
Tag	string	漏洞标签。	oval
K8sClusterId	string	容器关联的集群 ID。说明非旗舰版用户没有容器资产信息，无法获取该字段。	c863dc93bed3843de9934d4346dc4****
K8sNodeId	string	容器关联的节点 ID。说明非旗舰版用户没有容器资产信息，无法获取该字段。	i-bp1ifm6suw9mnbsr****
InstanceName	string	资产实例名称。	testInstance
Online	boolean	资产实例的 Agent 客户端是否在线。取值： true：在线 false：离线	true
OsVersion	string	资产的操作系统名称。	linux
Name	string	漏洞名称。	oval:com.redhat.rhsa:def:20170574
Progress	integer	漏洞修复进度。	100
ResultCode	string	修复返回码。	0
InstanceId	string	资产实例 ID。	i-bp18t***
Related	string	漏洞关联的 CVE 列表，有多个取值时用半角逗号（,）分隔。	CVE-2017-7518,CVE-2017-12188
IntranetIp	string	资产私网 IP。	1.2.XX.XX
LastTs	long	最后发现漏洞的时间戳，单位为毫秒。	1620404763000
FirstTs	long	首次发现漏洞的时间戳，单位为毫秒。	1554189334000
RegionId	string	实例所在的地域的 ID。	cn-hangzhou
Necessity	string	漏洞修复必要性等级。取值： asap：高 later：中 nntf：低说明建议您尽快修复必要性等级为高的漏洞。	asap
RepairTs	long	漏洞修复时间戳，单位为毫秒。该参数仅在控制台发起修复时存在。	1541207563000
Uuid	string	资产实例的 UUID。	04c56617-23fc-43a5-ab9b-****
K8sPodName	string	容器关联的 Pod 名称。说明非旗舰版用户没有容器资产信息，无法获取该字段。	deployment-riskai-7b67d68975-m****
GroupId	integer	资产分组 ID。	281801
ResultMessage	string	修复返回消息。	timeout
K8sNamespace	string	容器关联的命名空间。说明旗舰版用户优先从容器资产关联查询，非旗舰版用户通过客户端采集获取。	default
AliasName	string	漏洞名称。	RHSA-2019:0230-Important: polkit security update
K8sNodeName	string	容器关联的节点名称。说明非旗舰版用户没有容器资产信息，无法获取该字段。	deployment-riskai-7b67d68975-m****
ExtendContentJson	object	漏洞扩展信息。
Status	string	漏洞状态。取值： 1：未修复 2：修复失败 3：回滚失败 4：修复中 5：回滚中 6：验证中 7：修复成功 8：修复成功待重启 9：回滚成功 10：已忽略 11：回滚成功待重启 12：漏洞不存在 20：已失效	1
EmgProof	string	应急漏洞返回特征。	com.xxl.rpc.util.XxlRpcException: xxl-rpc request data is empty.\n\tat com.xxl.rpc.remoting.net.impl.servlet.serve"
Ip	string	漏洞关联资产的公网 IP 地址。	1.2.XX.XX
PrimaryId	long	漏洞 ID。	111
Os	string	操作系统名称。	centos
Tag	string	漏洞标签。	oval
LastTs	long	最后发现漏洞的时间戳，单位为毫秒。	1620404763000
Description	string	漏洞描述。	kernel version:5.10.84-10.2.al8.x86_64
OsRelease	string	操作系统版本描述。	7
AliasName	string	漏洞名称。	RHSA-2019:0230-Important: polkit security update
Target	string	漏洞地址。	http://39.99.XX.XX:30005/toLogin
AbsolutePath	string	漏洞相关软件包的路径。	/roo/www/web
RpmEntityList	array<object>	RPM 包列表。
RpmEntity	object
FullVersion	string	完整版本号。	3.10.0-693.2.2.el7
Version	string	存在漏洞的软件包版本号。	3.10.0
MatchDetail	string	漏洞命中详细信息。	python-perf version less than 0:3.10.0-693.21.1.el7
ImageName	string	镜像名称。	registry_387ytb_xxx
Path	string	存在漏洞的软件所在路径。	/usr/lib64/python2.7/site-packages
ContainerName	string	容器名称。	k8s_67895c4_xxx
Name	string	RPM 名称。	python-perf
UpdateCmd	string	修复命令。	*** update python-perf
MatchList	array	命中规则。
Match	string	命中规则。	fastjson(jar) extendField.safemode equals false
Pid	string	进程 ID。	8664
ExtendField	string	漏洞包扩展信息。	{"msg_no_lookups_configured_CVE_2021_44228": "false", "jndi_class_not_exist": "false"}
cveList	array	漏洞公告列表。
Cve	string	漏洞公告列表。	CVE-2016-8610
Necessity	object	漏洞修复的必要性因子。
Status	string	漏洞修复紧急度得分状态。取值： none：未生成分数 pending：等待计算中 normal：正常	normal
Time_factor	string	时间因子。	1.0
Enviroment_factor	string	环境因子。	1.0
Is_calc	string	是否已计算出漏洞修复建议得分。取值： 0：未计算 1：已计算	1
Total_score	string	漏洞修复紧急度得分。根据漏洞得分提供以下修复建议： 13.5~15 分（含 13.5 分和 15 分）：通常代表高危漏洞，需尽快修复。 7~13.5 分（含 7 分）：通常代表中危漏洞，可延后修复。 7 分以下：通常代表低危漏洞，暂可不修复。	7.8
Cvss_factor	string	CVSS 因子。	7.8
Assets_factor	string	资产重要性因子。以下是资产重要性因子和资产类型的对应关系： 2：重要资产 1：一般资产 0：测试资产	1
Bind	boolean	资产是否已绑定授权。取值： true：已绑定授权 false：未绑定授权	true
OsName	string	资产的操作系统名称。	CentOS 7.2 64位
AuthVersion	string	资产的授权版本。取值： 1：免费版 6：防病毒版 5：高级版 3：企业版 7：旗舰版 10：增值服务版	3
RealRisk	boolean	是否是真实风险漏洞。取值： true：属于真实风险漏洞。 false：不属于真实风险漏洞。	true
NextToken	string	使用 NextToken 方式下返回的 NextToken 值。	E17B501887A2D3AA5E8360A6EFA3B***

示例

正常返回示例

JSON格式

        

          
      
        
{
  "CurrentPage": 1,
  "RequestId": "2F26AB2A-1075-488F-8472-40E5DB486ACC",
  "PageSize": 20,
  "TotalCount": 2,
  "VulRecords": [
    {
      "Status": 1,
      "RaspDefend": 1,
      "RaspStatus": 1,
      "Type": "cve",
      "ModifyTs": 1620404763000,
      "InternetIp": "1.2.XX.XX",
      "PrimaryId": 101162078,
      "Tag": "oval",
      "K8sClusterId": "c863dc93bed3843de9934d4346dc4****",
      "K8sNodeId": "i-bp1ifm6suw9mnbsr****",
      "InstanceName": "testInstance",
      "Online": true,
      "OsVersion": "linux",
      "Name": "oval:com.redhat.rhsa:def:20170574",
      "Progress": 100,
      "ResultCode": "0",
      "InstanceId": "i-bp18t***",
      "Related": "CVE-2017-7518,CVE-2017-12188",
      "IntranetIp": "1.2.XX.XX",
      "LastTs": 1620404763000,
      "FirstTs": 1554189334000,
      "RegionId": "cn-hangzhou",
      "Necessity": "asap",
      "RepairTs": 1541207563000,
      "Uuid": "04c56617-23fc-43a5-ab9b-****",
      "K8sPodName": "deployment-riskai-7b67d68975-m****",
      "GroupId": 281801,
      "ResultMessage": "timeout",
      "K8sNamespace": "default",
      "AliasName": "RHSA-2019:0230-Important: polkit security update",
      "K8sNodeName": "deployment-riskai-7b67d68975-m****",
      "ExtendContentJson": {
        "Status": "1",
        "EmgProof": "com.xxl.rpc.util.XxlRpcException: xxl-rpc request data is empty.\\n\\tat com.xxl.rpc.remoting.net.impl.servlet.serve\"",
        "Ip": "1.2.XX.XX",
        "PrimaryId": 111,
        "Os": "centos",
        "Tag": "oval",
        "LastTs": 1620404763000,
        "Description": "kernel version:5.10.84-10.2.al8.x86_64",
        "OsRelease": "7",
        "AliasName": "RHSA-2019:0230-Important: polkit security update",
        "Target": "http://39.99.XX.XX:30005/toLogin",
        "AbsolutePath": "/roo/www/web",
        "RpmEntityList": [
          {
            "FullVersion": "3.10.0-693.2.2.el7",
            "Version": "3.10.0",
            "MatchDetail": "python-perf version less than 0:3.10.0-693.21.1.el7",
            "ImageName": "registry_387ytb_xxx",
            "Path": "/usr/lib64/python2.7/site-packages",
            "ContainerName": "k8s_67895c4_xxx",
            "Name": "python-perf",
            "UpdateCmd": "*** update python-perf",
            "MatchList": [
              "fastjson(jar) extendField.safemode equals false"
            ],
            "Pid": "8664",
            "ExtendField": "{\"msg_no_lookups_configured_CVE_2021_44228\": \"false\", \"jndi_class_not_exist\": \"false\"}"
          }
        ],
        "cveList": [
          "CVE-2016-8610"
        ],
        "Necessity": {
          "Status": "normal",
          "Time_factor": "1.0",
          "Enviroment_factor": "1.0",
          "Is_calc": "1",
          "Total_score": "7.8",
          "Cvss_factor": "7.8",
          "Assets_factor": "1"
        }
      },
      "Bind": true,
      "OsName": "CentOS  7.2 64位",
      "AuthVersion": "3",
      "RealRisk": true
    }
  ],
  "NextToken": "E17B501887A2D3AA5E8360A6EFA3B***"
}

错误码

HTTP status code	错误码	错误信息	描述

HTTP status code	错误码	错误信息	描述
400	NoPermission	no permission	无此服务的访问权限。
400	InnerError	InnerError	内部错误，请稍后重试！
400	IllegalParam	Illegal param	无效参数
400	DataNotExists	%s data not exist	-
400	RdCheckNoPermission	Resource directory account verification has no permission.	资源目录账号校验无权限。
400	MissingType	Type is mandatory for this action.	类型必填。
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	RdCheckInnerError	Resource directory account service internal error.	资源目录账号服务内部错误。
500	ServerError	ServerError	服务故障，请稍后重试！

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

变更历史

变更时间	变更内容概要	操作

变更时间	变更内容概要	操作
2024-09-25	OpenAPI 错误码发生变更	查看变更详情
2024-08-05	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2024-04-12	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2024-03-27	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2023-11-22	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2023-09-26	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2023-09-08	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2023-09-07	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2023-08-23	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2023-07-20	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2023-03-21	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2022-06-20	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情