调用DescribeUuidsByVulNames根据漏洞名称获取机器列表_云安全中心(Security Center)-阿里云帮助中心

根据漏洞名称获取支持修复的机器列表。

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
yundun-sas:DescribeUuidsByVulNames	Read	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	指定请求和接收消息的语言类型，默认值为 zh。取值： zh：中文 en：英文	zh
Type	string	是	要查询的漏洞类型。取值： cve：Linux 软件漏洞 sys：Windows 系统漏洞	cve
StatusList	string	否	漏洞的修复状态。多个修复状态使用半角逗号（,）分隔。取值： 1：未修复 2：修复失败	1,2
Tag	string	否	漏洞标签。	oval
Level	string	否	漏洞等级。多个漏洞等级使用半角逗号（,）分隔。取值： high：高危 medium：中危 low：低危	high,low
Dealed	string	否	漏洞是否处理。取值： y：已处理 n：未处理	n
GroupId	long	否	资产分组 ID。	11286014
VpcInstanceIds	string	否	要查询漏洞的 VPC 实例 ID。多个 ID 使用半角逗号（,）分隔。	vpc-uf6ssrvbrwe37ekw**,vpc-bp1aevy8sofi8mh1q**
Remark	string	否	要查询漏洞的资产信息，可以设置为资产名称、公网 IP 或私网 IP（支持模糊查询）。	10.7.
SearchTags	string	否	查询漏洞的 tag 标签。	oval
FieldName	string	否	容器检索字段名称。	namespace
FieldValue	string	否	容器检索字段值。	cas-adad-qeqwe
TargetType	string	否	查询类型。取值： containerId：容器 ID uuid：资产 ID	uuid
Necessity	string	否	要查询的漏洞修复必要性等级。多个等级用半角逗号（,）分隔。取值： asap：高 later：中 nntf：低	asap,later,nntf
VulNames	array	是	漏洞名称集合。说明您可调用 DescribeGroupedVul 接口获取该参数。
	string	是	漏洞名称信息。	centos:8:rhsa-2020:1665

返回参数

名称	类型	描述	示例值
	object	返回数据。
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	97286A-4A6B-4A4-95FA-EC7E3E2451
MachineInfoStatistics	object []	资产统计信息列表。
Uuid	string	服务器 UUID。	18375c64-eaa2-4702-92b0-4ee7******
MachineIp	string	服务器机器 IP。	192.168.XX.XX
Os	string	服务器的操作系统名称。	windows
MachineName	string	服务器机器名称。	TestMachine
MachineInstanceId	string	服务器实例 ID。	i-wz9gd1os5talju****
RegionId	string	实例所在的地域的 ID。	cn-hangzhou
VulCount	integer	服务器的漏洞的总数量。	2

示例

正常返回示例

JSON格式

{
  "RequestId": "97286A-4A6B-4A4-95FA-EC7E3E2451",
  "MachineInfoStatistics": [
    {
      "Uuid": "18375c64-eaa2-4702-92b0-4ee7******",
      "MachineIp": "192.168.XX.XX",
      "Os": "windows",
      "MachineName": "TestMachine",
      "MachineInstanceId": "i-wz9gd1os5talju****",
      "RegionId": "cn-hangzhou"
    }
  ],
  "VulCount": 2
}

错误码

HTTP status code	错误码	错误信息	描述
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	ServerError	ServerError	服务故障，请稍后重试！

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

变更历史

变更时间

变更内容概要

操作

2023-07-06

OpenAPI 返回结构发生变更

看变更集

变更项	变更内容
出参	OpenAPI 返回结构发生变更。