文档中心

云服务器

请输入

启动模版

DescribeLaunchTemplates - 查询实例启动模板

调用 DescribeLaunchTemplates 接口查询实例启动模板。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DescribeLaunchTemplates

要执行的操作，取值：DescribeLaunchTemplates。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

NextToken string 可选示例值：--

分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。

MaxResults integer 可选示例值：10

分页查询时设置的每页行数：

最大值：100

默认值：10

TagFilters.N.Key string[] 可选示例值：TagFilters.1.Key=k1&TagFilters.2.Key=k2

实例启动模板的标签键。

LaunchTemplateNames.N string[] 可选示例值：LaunchTemplateNames.1=testLaunchTemplateName

实例启动模板的名称，最多支持10个。

参数 - N：表示实例启动模板的序号。

多个名称之间用&分隔。

TagFilters.N.Values.N string[] 可选示例值：TagFilters.1.Values.1=v1&TagFilters.2.Values.1=v2

实例启动模板的标签值。

LaunchTemplateProjectName string 可选示例值：default

实例启动模版所属项目。

LaunchTemplateIds.N string[] 可选示例值：LaunchTemplateIds.1=lt-3ti78x9h8t4bw****&LaunchTemplateIds.2=lt-ysxc16auaugh9zfy****

实例启动模板ID，最多支持10个ID。

参数 - N：表示实例启动模板的序号。

多个ID之间用&分隔。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

NextToken string 示例值：

本次调用返回的查询凭证值，返回为空表示该页为末页。

LaunchTemplates object[] 示例值：

符合条件的实例启动模板信息。

LaunchTemplateId string 示例值：lt-ysxc16auaugh9zfy****

实例启动模板 ID。

LaunchTemplateName string 示例值：testLaunchTemplateName

实例启动模板名称。

DefaultVersionNumber integer 示例值：1

实例启动模板的默认版本号。

LatestVersionNumber integer 示例值：1

实例启动模的最新版本号。

CreatedAt string 示例值：2022-04-10T18:29:38+08:00

实例启动模板的创建时间。

UpdatedAt string 示例值：2022-04-14T18:29:38+08:00

实例启动模板的更新时间。

LaunchTemplateProjectName string 示例值：default

实例启动模版所属项目。

LaunchTemplateTags object[]

实例启动模版的标签信息。

Key string 示例值：k1

实例启动模板的标签键。

Value string 示例值：v1

实例启动模板的标签值。

请求示例

GET /?Action=DescribeLaunchTemplates&Version=2020-04-01&LaunchTemplateIds.1=lt-ysxc16auaugh9zfy**** HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
ServiceName: ecs​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20220419160338010225133143077B****",​
        "Action": "DescribeLaunchTemplates",​
        "Version": "2020-04-01",​
        "Service": "ecs",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "NextToken": "",​
        "LaunchTemplates": [​
            {​
                "LaunchTemplateId": "lt-ysxc16auaugh9zfy****",​
                "LaunchTemplateName": "test",​
                "DefaultVersionNumber": 1,​
                "LatestVersionNumber": 1,​
                "CreatedAt": "2022-06-09T10:38:20+08:00",​
                "UpdatedAt": "2022-06-09T10:38:20+08:00"​
            }​
        ]​
    }​
}​

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2026.08.18 14:47:36

这个页面对您有帮助吗？

有用

无用