调用DescribeLaunchTemplates查询一个或多个可用的实例启动模板。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeLaunchTemplates | 系统规定参数。取值：DescribeLaunchTemplates |
| RegionId | String | 是 | cn-hangzhou | 地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
| TemplateTag.N.Key | String | 否 | TestKey | 启动模板的标签键。N的取值范围：1~20 使用一个标签过滤资源，查询到该标签下的资源数量不能超过1000个；使用多个标签过滤资源，查询到同时绑定了多个标签的资源数量不能超过1000个。如果资源数量超过1000个，请使用ListTagResources接口进行查询。 |
| TemplateTag.N.Value | String | 否 | TestValue | 启动模板的标签值。N的取值范围：1~20 |
| LaunchTemplateId.N | RepeatList | 否 | lt-m5e3ofjr1zn1aw7q**** | 一个或多个实例启动模板ID，最多支持查询100个启动模板。您必须指定LaunchTemplateId或LaunchTemplateName以确定模板。 |
| LaunchTemplateName.N | RepeatList | 否 | wd-152630748**** | 一个或多个实例启动模板名称，最多支持查询100个启动模板。 |
| PageNumber | Integer | 否 | 1 | 实例启动模板列表的页码。起始值：1 默认值：1 |
| PageSize | Integer | 否 | 10 | 分页查询时设置的每页行数。 默认值：10 |
| TemplateResourceGroupId | String | 否 | rg-acfmxazb4p**** | 启动模板所在的企业资源组ID。使用该参数过滤资源时，资源数量不能超过1000个。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| LaunchTemplateSets | Array of LaunchTemplateSet | 实例启动模板的信息集合。 |
|
| LaunchTemplateSet | |||
| CreateTime | String | 2018-05-14T14:18:00Z | 实例启动模板创建时间。 |
| CreatedBy | String | 1234567890 | 模板的创建者。 |
| DefaultVersionNumber | Long | 1 | 模板默认版本号。 |
| LatestVersionNumber | Long | 1 | 模板最新版本号。 |
| LaunchTemplateId | String | lt-m5e3ofjr1zn1aw7q**** | 模板ID。 |
| LaunchTemplateName | String | wd-152630748**** | 模板名称。 |
| ModifiedTime | String | 2018-05-14T14:18:00Z | 修改时间。 |
| ResourceGroupId | String | rg-acfmxazb4p**** | 启动模板所在的企业资源组ID。 |
| Tags | Array of Tag | 启动模板的标签对属性。 |
|
| Tag | |||
| TagKey | String | TestKey | 启动模板的标签键。 |
| TagValue | String | TestValue | 启动模板的标签值。 |
| PageNumber | Integer | 1 | 当前页码。 |
| PageSize | Integer | 10 | 分页查询时设置的每页行数。 |
| RequestId | String | 04F0F334-1335-436C-A1D7-6C044FE12CBA | 请求ID。 |
| TotalCount | Integer | 1 | 实例启动模板总个数。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeLaunchTemplates &RegionId=cn-hangzhou &TemplateTag.1.Key=TestKey &TemplateTag.1.Value=TestValue &LaunchTemplateId.1=lt-m5e3ofjr1zn1aw7q**** &LaunchTemplateName.1=wd-152630748**** &PageNumber=1 &PageSize=10 &TemplateResourceGroupId=rg-acfmxazb4p**** &<公共请求参数>
正常返回示例
XML 格式
<DescribeLaunchTemplatesResponse> <RequestId>04F0F334-1335-436C-A1D7-6C044FE12CBA</RequestId> <TotalCount>1</TotalCount> <PageNumber>1</PageNumber> <PageSize>10</PageSize> <LaunchTemplateSets> <LaunchTemplateSet> <CreateTime>2018-05-14T14:18:00Z</CreateTime> <ModifiedTime>2018-05-14T14:18:00Z</ModifiedTime> <LaunchTemplateid>lt-m5e3ofjr1zn1aw7****</LaunchTemplateid> <LaunchTemplateName>wd-152630748****</LaunchTemplateName> <DefaultVersionNumber>1</DefaultVersionNumber> <LatestVersionNumber>1</LatestVersionNumber> <CreatedBy>194211134971****</CreatedBy> </LaunchTemplateSet> </LaunchTemplateSets> </DescribeLaunchTemplatesResponse>
JSON 格式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE12CBA",
"TotalCount": 1,
"PageNumber": 1,
"PageSize": 10,
"LaunchTemplateSets": {
"LaunchTemplateSet": [
{
"LaunchTemplateName": "wd-152630748****",
"CreatedBy": "194211134971****",
"ModifiedTime": "2018-05-14T14:18:00Z",
"LatestVersionNumber": 1,
"CreateTime": "2018-05-14T14:18:00Z",
"LaunchTemplateId": "lt-m5e3ofjr1zn1aw7q****",
"DefaultVersionNumber": 1
}
]
}
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidRegion.NotExist | %s | 指定的地域不存在，请确认参数是否正确。 |
| 400 | MissingParameter | %s | 缺失参数，请检查参数是否完整。 |
| 400 | InvalidParameter | %s | 无效的参数。 |
| 403 | InnerServiceFailed | %s | 内部服务调用失败。 |
访问错误中心查看更多错误码。