云服务器
云服务器
文档指南
请输入
- 文档首页
云服务器云服务器ECSAPI参考补丁管理ListPatchBaselines - 查询补丁基线列表
复制全文
下载 pdfListPatchBaselines - 查询补丁基线列表
文档反馈
问问助手调用ListPatchBaselines接口，查询补丁基线列表。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：ListPatchBaselines
要执行的操作，取值：ListPatchBaselines。
Version string 必选 示例值：2020-04-01
API的版本，取值：2020-04-01。
BaselineIds string[] 可选 示例值：["id-abc123"]
- 多个补丁基线之间使用“,”（英文逗号）分割。
- 单次最多支持传入20个补丁基线ID。
Name string 可选 示例值：UbuntuBaseline
补丁基线名称。取值：
- 必须以字母、汉字开头。
- 只能包含中文、字母、数字、下划线“_”、中划线“-”、英文句号“.”。
- 长度限制为1～128个字符。
说明
建议采用能够清晰反映其用途的名称。
OperationSystem string 可选 示例值：Ubuntu
操作系统类型。取值：
- Ubuntu
- Debian
NextToken string 可选 示例值：token-abc123
分页查询凭证，用于标记分页的位置，下次查询时，取值为上一次API调用返回的NextToken参数值。
- 若调用时传入Token值，则取自当前页返回结果。
- 若调用时未传入Token值：
- 当查询结果存在后续分页，返回结果中将包含有效的分页Token。
- 当当前页为最后一页（无后续数据），返回的Token值为空字符串。
MaxResults integer 可选 示例值：10
分页查询时设置的每页行数，取值：
- 默认值：10
- 取值范围：1~100
返回参数
NextToken string 示例值：token-abc123
本次调用返回的查询凭证值。取值：
- 若调用时传入Token值，则取自当前页返回结果。
- 若调用时未传入Token值：
- 当查询结果存在后续分页，返回结果中将包含有效的分页Token。
- 当当前页为最后一页（无后续数据），返回的Token值为空字符串。
Baselines object[] 示例值：--
补丁基线列表。
Description string 示例值：The description of baseline.
补丁基线描述。
Name string 示例值：UbuntuBaseline
补丁基线名称。
BaselineId string 示例值：bl-xffsafgewgdf****
补丁基线ID。
UpdatedAt string 示例值：2026-01-13T11:56:55Z
补丁基线更新时间。
CreatedAt string 示例值：2026-01-13T11:56:55Z
补丁基线创建时间。
OperationSystem string 示例值：Ubuntu
操作系统类型。取值：
- Ubuntu
- Debian
IsDefault boolean 示例值：true
是否为默认基线。取值：
- true：默认基线。
- false：非默认基线。
请求示例
POST /?Version=2020-04-01&Action=ListPatchBaselines 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
{
"OperationSystem": "Ubuntu",
"MaxResults": 10
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20260122100505050****",
"Action": "ListPatchBaselines",
"Version": "2020-04-01",
"Service": "ecs",
"Region": "cn-beijing"
},
"Result": {
"Baselines": [
{
"BaselineId": "bl-12345678abc****",
"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"
},
{
"BaselineId": "bl-default****",
"Name": "Volcengine-DefaultPatchBaseline",
"OperationSystem": "Ubuntu",
"IsDefault": true,
"Description": "Default Baseline",
"CreatedAt": "2025-01-01T00:00:00Z",
"UpdatedAt": "2025-01-01T00:00:00Z"
}
],
"NextToken": "next_page_token_xxx"
}
}
错误码
状态码 | 错误码 | 错误信息 | 说明 |
400 | InvalidArgument | The specified argument is invalid. | 指定的参数不合法。 |
500 | InternalError | An internal error has occurred. | 内部错误，请重试。如果多次尝试失败，请提交工单。 |
最近更新时间：2026.03.03 16:14:48
这个页面对您有帮助吗？
有用
有用
无用
无用