DescribeVulnerability - 获取漏洞信息-无影云电脑企业版-阿里云帮助中心

获取漏洞信息

接口说明

开启安全防护后，系统将周期性（每天一次）自动扫描云桌面的系统漏洞。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ecd:DescribeVulnerability

list

*全部资源

*

无

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
RegionId	string	否	地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。	cn-shanghai
SearchRegionId	string	否	搜索地域 ID，过滤出指定地域的云资源信息。	cn-hangzhou
PatchId	string	否	补丁 ID	KB5082063
CveId	string	否	漏洞编号。	CVE-2024-38819
IncludeDesktop	boolean	否	不适用	不适用
Language	string	否	返回信息语言类型。枚举值： ch : 中文 en : 英文	en
MaxResults	integer	否	分页查询时每页行数。默认值：100。	10
NextToken	string	否	下一个查询开始的 Token，NextToken 为空表示没有下一个。	AAAAAV3MpHK1AP0pfERHZN5pu6kRxd1mKkNnHlUy14zdjl/I

返回参数

名称	类型	描述	示例值
	object
MaxResults	integer	分页查询时每页行数。最大值：100 默认值：10	10
NextToken	string	下一个查询开始的 Token。	caeba0bbb2be03f84eb48b699f0a4883
RequestId	string	请求 ID。	1CBAFFAB-B697-4049-A9B1-67E1FC5F****
Vulnerability	object	云电脑和漏洞详情信息。
CleanDesktopCount	integer	未发现漏洞的云电脑数。	100
CumulativeProcessedVulCount	integer	累计已处理漏洞数。	600
FixFailedDesktopCountThisMonth	integer	本月修复失败云电脑数。	0
FixedDesktopCountThisMonth	integer	本月已修复云电脑数。	20
Patches	array<object>	补丁详情信息列表。
	array<object>	补丁详情信息。
Cves	array<object>	补丁对应的漏洞详情列表。
	object	漏洞详情。
CveId	string	漏洞编号。	CVE-2026-62690
CveLevel	string	漏洞等级。枚举值： high : 高危 critical : 严重 low : 低危 medium : 中危 none : 无	low
CveTitle	string	漏洞名称。	Windows 推送通知特权提升漏洞
CveUrl	string	CVE 链接。	https://avd.aliyun.com/detail/CVE-2026-62690
ImpactScore	string	影响评分。	7.0
ReferenceUrl	string	参考链接。	https://msrc.microsoft.com/update-guide/vulnerability/CVE-2026-62690
ReleaseTime	string	漏洞披露时间，格式为 yyyy-MM-dd HH:mm:ss。	2026-08-11 07:00:00
FirstDetectedAt	string	补丁纰漏时间。	2026-08-11 00:00:00
PatchId	string	补丁 ID。	KB5120238
PatchLevel	string	补丁级别。枚举值： high : 高危 critical : 严重 low : 低危 medium : 中危	high
PatchTitle	string	补丁标题。	2026-适用于 Windows Server 2019 的 08 累积更新，适合基于 x64 的系统 (KB5120238)
PatchUrl	string	补丁对应的 URL。	https://support.microsoft.com/help/5120238
PendingDesktopCount	integer	可升级到该版本的云电脑数量。	20
PendingVulCount	integer	待修复的漏洞数。	330
RemediationInProgressDesktopCount	integer	正在修复的云电脑数。	160
TotalDesktopCount	integer	总云电脑数，被补丁管理纳管的总云电脑数。	1000
UpdateBlockedDesktopCount	integer	禁止更新的云电脑数。	10
VulnerableDesktopCount	integer	存在漏洞的云电脑数。	200

示例

正常返回示例

JSON格式

{
  "MaxResults": 10,
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "Vulnerability": {
    "CleanDesktopCount": 100,
    "CumulativeProcessedVulCount": 600,
    "FixFailedDesktopCountThisMonth": 0,
    "FixedDesktopCountThisMonth": 20,
    "Patches": [
      {
        "Cves": [
          {
            "CveId": "CVE-2026-62690",
            "CveLevel": "low",
            "CveTitle": "Windows 推送通知特权提升漏洞",
            "CveUrl": "https://avd.aliyun.com/detail/CVE-2026-62690",
            "ImpactScore": "7.0",
            "ReferenceUrl": "https://msrc.microsoft.com/update-guide/vulnerability/CVE-2026-62690",
            "ReleaseTime": "2026-08-11 07:00:00"
          }
        ],
        "FirstDetectedAt": "2026-08-11 00:00:00",
        "PatchId": "KB5120238",
        "PatchLevel": "high",
        "PatchTitle": "2026-适用于 Windows Server 2019 的 08 累积更新，适合基于 x64 的系统 (KB5120238)",
        "PatchUrl": "https://support.microsoft.com/help/5120238",
        "PendingDesktopCount": 20
      }
    ],
    "PendingVulCount": 330,
    "RemediationInProgressDesktopCount": 160,
    "TotalDesktopCount": 1000,
    "UpdateBlockedDesktopCount": 10,
    "VulnerableDesktopCount": 200
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameterError	AliUid cannot be empty.

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

变更历史

更多信息，参考变更详情。