You need to enable JavaScript to run this app.
文档中心
云服务器

云服务器

复制全文
下载 pdf
补丁管理
GetPatchBaseline - 获取补丁基线详情
复制全文
下载 pdf
GetPatchBaseline - 获取补丁基线详情
调用GetPatchBaseline接口,获取补丁基线详情。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:GetPatchBaseline​
要执行的操作,取值:GetPatchBaseline。​
​
Version string 必选 示例值:2020-04-01​
API的版本,取值:2020-04-01。​
​
BaselineId string 必选 示例值:bl-xffsafgewgdf****​
补丁基线ID,您可以通过调用CreatePatchBaseline接口获取,取值:单次最多支持传入1个补丁补丁基线ID,即查询1个补丁基线详情。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
Sources object[] 示例值:--​
本次调用返回的补丁源详情。​
Products string[] 示例值:Ubuntu24.04​
补丁仓库所适用的操作系统版本,取值:​
  • Ubuntu:​
  • Ubuntu 24​
  • Ubuntu 22​
  • Ubuntu 20​
  • Ubuntu 18​
  • Ubuntu 16​
  • Debian​
  • Debian 12​
  • Debian 11​
  • Debian 10​
  • Debian 9​
  • Debian 8​
​
Name string 示例值:UbunutuSource​
补丁源的指定名称。​
​
Configuration string 示例值:deb http://security.ubuntu.com/ubuntu jammy main​
补丁源存储库配置的值。取值:​
  • 符合对应操作系统的软件源配置格式。​
  • 配置内容需包含合法的源地址、版本标识、组件类型等核心字段,无语法错误。​
  • 长度范围:1~1024个字符。​
​
​
ApprovedPatchesComplianceLevel string 示例值:UNSPECIFIED​
已批准补丁的合规性级别。取值:​
  • UNSPECIFIED:为待定级别的临时等级。​
  • CRITICAL:为最高合规风险等级。​
  • HIGH:为高优先级等级。​
  • MEDIUM:为常规整改优先级等级。​
  • LOW:为延后整改优先级等级。​
  • INFORMATIONAL:为非风险类补充标注等级。​
​
BaselineId string 示例值:bl-xffsafgewgdf****​
补丁基线ID。​
​
OperationSystem string 示例值:Ubuntu​
操作系统类型,取值:​
  • Ubuntu​
  • Debian​
​
IsDefault boolean 示例值:true​
是否为默认补丁基线,取值:​
  • true:为默认补丁基线。​
  • false:为自定义补丁基线。​
​
Description string 示例值:The description of baseline.​
补丁基线描述。​
​
CreatedAt string 示例值:2026-01-13T11:56:55Z​
补丁基线创建时间。​
​
UpdatedAt string 示例值:2026-01-13T11:56:55Z​
补丁基线更新时间。​
​
Name string 示例值:UbuntuBaseline​
补丁基线名称。​
​
ApprovalRules object[] 示例值:--​
补丁基线的安装规则,用于自动批准补丁。取值:​
  • 至少有1个安装规则。​
  • 最多有10个安装规则。​
EnableNonSecurity boolean 示例值:true​
是否启用非安全补丁更新。取值:​
  • true:启用。​
  • false:不启用。​
​
ComplianceLevel string 示例值:CRITICAL​
被批准补丁的合规严重级别。取值:​
  • UNSPECIFIED:为待判定级别的临时等级。​
  • CRITICAL:为最高合规风险等级。​
  • HIGH:为高优先级等级。​
  • MEDIUM:为常规整改优先级等级。​
  • LOW:为延后整改优先级等级。​
  • INFORMATIONAL:为非风险类补充标注等级。​
​
ApproveUntilDate string 示例值:2020-04-01​
自动批准的截止日期,早于该日期发布的补丁将会自动批准。​
  • 格式: YYYY-MM-DD。​
  • 评估时间:截止日期基于UTC时间评估。例如,若设置为 2025-11-16,则所有在 2025-11-16T23:59:59Z 前发布且匹配规则的补丁均会被批准。​
​
ApproveAfterDays integer 示例值:10​
指定补丁发布后多少天自动批准。取值:​
  • 取值范围: 0~360天,例如取值为 7 ,则补丁在发布7天后自动批准。​
  • 评估时间: 补丁的发布日期基于UTC时间评估。​
​
PatchFilterGroup object[] 示例值:--​
补丁基线安装规则适用的补丁筛选条件组。​
Key string 示例值:PRODUCT​
筛选维度(补丁属性键)。​
说明​
不同操作系统支持的Key不同。​
​
Values string[] 示例值:Ubuntu24.04​
对应Key的匹配值。​
​
​
​
RejectedPatches string[] 示例值:["example"]​
补丁基线中明确拒绝的补丁列表,为字符串数组类型,取值范围1~50个补丁。​
​
RejectedPatchesAction string 示例值:BLOCK​
已拒绝补丁的操作,取值:​
  • ALLOW_AS_DEPENDENCY:若被拒绝的补丁包是其他必需包的依赖项,系统将允许安装该被拒绝补丁。​
  • BLOCK:严格禁止安装 RejectedPatches 列表中的任意补丁。​
​
ApprovedPatches string[] 示例值:["example"]​
基线明确批准补丁列表(字符串数组),取值范围:1~50个补丁。​
​
ApprovedPatchesEnableNonSecurity boolean 示例值:true​
指定已批准补丁列表是否包含托管节点的非安全补丁更新。取值:​
  • true:除安全补丁外,ApprovedPatches 列表中的非安全更新也会被评估并安装。​
  • false:仅评估并安装 ApprovedPatches 列表中与安全相关的更新。​
​
​
​
请求示例​
​
POST /?Version=2020-04-01&Action=GetPatchBaseline 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​
​
{​
"BaselineId": "bl-12345678abc****"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20260122100404040****",​
"Action": "GetPatchBaseline",​
"Version": "2020-04-01",​
"Service": "ecs",​
"Region": "cn-beijing"​
},​
"Result": {​
"BaselineId": "bl-12345678ab****",​
"Name": "Ubuntu-Prod-Baseline",​
"OperationSystem": "Ubuntu",​
"IsDefault": false,​
"Description": "Production Environment Ubuntu Base Line",​
"CreatedAt": "2026-01-22T10:00:00Z",​
"UpdatedAt": "2026-01-22T12:00:00Z",​
"ApprovalRules": [​
{​
"PatchFilterGroup": [​
{ "Key": "PRODUCT", "Values": ["Ubuntu24.04"] }​
],​
"ComplianceLevel": "CRITICAL"​
}​
],​
"ApprovedPatches": ["nginx"],​
"RejectedPatches": ["dlv"],​
"RejectedPatchesAction": "BLOCK",​
"Sources": []​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidArgument​
The specified argument is invalid.​
指定的参数不合法。​
500​
InternalError​
An internal error has occurred.​
内部错误,请重试。如果多次尝试失败,请提交工单。​
​
​
最近更新时间:2026.03.03 16:14:48
这个页面对您有帮助吗?
有用
有用
无用
无用