云服务器
云服务器
文档指南
请输入
- 文档首页
云服务器云服务器ECSAPI参考补丁管理ListInstancePatches - 查询实例补丁安装情况
复制全文
下载 pdfListInstancePatches - 查询实例补丁安装情况
文档反馈
问问助手调用ListInstancePatches接口，查询实例补丁安装情况。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：ListInstancePatches
要执行的操作，取值：ListInstancePatches。
Version string 必选 示例值：2020-04-01
API的版本，取值：2020-04-01。
Status string 必选 示例值：Pending
补丁计划状态。取值：
- Pending：待处理。
- Running：运行中。
- Completed：已完成。
- Failed：失败。
- Expired：已过期。
- Cancelled：已取消。
Classification string 可选 示例值：Security
补丁分类。取值：
- Security：安全类补丁。
- Other：除安全类外的其他类补丁。
Name string 可选 示例值：UbuntuBaseline
补丁名称。取值：
- 必须以字母、汉字开头。
- 只能包含中文、字母、数字、下划线“_”、中划线“-”、英文句号“.”。
- 长度限制为1～128个字符。
NextToken string 可选 示例值：token-abc123
分页查询凭证，用于标记分页的位置，下次查询时，取值为上一次API调用返回的NextToken参数值。
- 若调用时传入Token值，则取自当前页返回结果。
- 若调用时未传入Token值：
- 当查询结果存在后续分页，返回结果中将包含有效的分页Token。
- 当当前页为最后一页（无后续数据），返回的Token值为空字符串。
MaxResults integer 可选 示例值：10
分页查询时设置的每页行数，取值：
- 默认值：10
- 取值范围：1~100
返回参数
NextToken string 示例值：token-abc123
本次调用返回的查询凭证值。
- 若调用时传入Token值，则取自当前页返回结果。
- 若调用时未传入Token值：
- 当查询结果存在后续分页，返回结果中将包含有效的分页Token。
- 当当前页为最后一页（无后续数据），返回的Token值为空字符串。
Patches object[] 示例值：--
补丁列表。
Title string 示例值：[Security] Ubuntu & Debian Kernel CVE Patch – 2026-01
补丁名称。
Description string 示例值：The description of patch.
补丁描述。
Severity string 示例值：CRITICAL
合规严重性级别。取值：
- CRITICAL：为最高合规风险等级。
- HIGH：为高优先级等级。
- MEDIUM：为常规整改优先级等级。
- LOW：为延后整改优先级等级。
- INFORMATIONAL：为非风险类补充标注等级。
- UNSPECIFIED：为待定级的临时等级。
Classification string 示例值：Security
补丁的分类，取值：
- Security：安全类补丁。
- Other：除安全类外的其他类补丁。
Name string 示例值：nginx
补丁软件包名称。
InstalledTime string 示例值：2025-12-09T20:45Z
补丁安装时间。
CveIds string[] 示例值：CVE-2026-1****
补丁的通用漏洞与暴露（CVE）ID。
Status string 示例值：INSTALLED
补丁安装状态。
- INSTALLED： 已安装补丁，无需重启。
- MISSING：未安装的补丁。
- INSTALLED_PENDING_REBOOT：已安装补丁，需重启生效。
- FAILED：安装失败的补丁。
- INSTALLED_OTHER：该补丁已安装，但不符合基线。仅当“已拒绝的补丁”列表中的软件包是其它软件包的依赖项时，才会安装该软件包，其状态报告为“已安装（不符合基线）”。
- INSTALLED_REJECTED：该补丁已安装，但为拒绝的补丁。如果某个软件包在添加到“已拒绝补丁程序”之前已安装，则其状态为“已安装（拒绝的补丁）。
请求示例
POST /?Version=2020-04-01&Action=ListInstancePatches HTTP/1.1
Host: ecs.cn-beijing.volcengineapi.com
AccessKey: AK*****************
SecretKey: TXpS***************
ServiceName: ecs
Region: cn-beijing
X-Top-Account-Id: 21000*****
Content-Type: application/json
{
"InstanceId": "i-instance001",
"Status": "MISSING",
"MaxResults": 50
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20260122101414141****",
"Action": "ListInstancePatches",
"Version": "2020-04-01",
"Service": "ecs",
"Region": "cn-beijing"
},
"Result": {
"Patches": [
{
"Name": "KB5005565",
"Title": "Update: Upgrade utils/curl to 8.5.0 on Ubuntu 22.04",
"Classification": "SecurityUpdates",
"Severity": "Critical",
"Status": "MISSING",
"InstalledTime": "",
"CveIds": [],
"Description": "Fixes security vulnerabilities."
},
{
"Name": "python3",
"Title": "Interactive high-level object-oriented language",
"Classification": "Security",
"Severity": "Important",
"Status": "MISSING",
"CveIds": [],
"InstalledTime": "",
"Description": "Security update for Python3"
}
],
"NextToken": ""
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | InvalidArgument | The specified argument is invalid. | 指定的参数不合法。 |
500 | InternalError | An internal error has occurred. | 内部错误，请重试。如果多次尝试失败，请提交工单。 |
最近更新时间：2026.03.03 16:14:47
这个页面对您有帮助吗？
有用
有用
无用
无用