DescribeLaunchTemplates - 云服务器 ECS

调试

您可以在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。
PageNumber	Integer	否	1	实例启动模板列表的页码。起始值：1。默认值：1。
PageSize	Integer	否	10	分页查询时设置的每页行数。默认值：10。
TemplateResourceGroupId	String	否	rg-acfmxazb4p****	启动模板所在的企业资源组ID。使用该参数过滤资源时，资源数量不能超过1000个。说明不支持默认资源组过滤。
LaunchTemplateId.N	String	否	lt-m5e3ofjr1zn1aw7q****	一个或多个实例启动模板ID，最多支持查询100个启动模板。您必须指定LaunchTemplateId或LaunchTemplateName以确定模板。
LaunchTemplateName.N	String	否	wd-152630748****	一个或多个实例启动模板名称，最多支持查询100个启动模板。

返回数据


名称	类型	示例值	描述
PageSize	Integer	10	分页查询时设置的每页行数。
RequestId	String	04F0F334-1335-436C-A1D7-6C044FE12CBA	请求ID。
PageNumber	Integer	1	当前页码。
TotalCount	Integer	1	实例启动模板总个数。
LaunchTemplateSets	Array of LaunchTemplateSet		实例启动模板的信息集合。
LaunchTemplateSet
LaunchTemplateName	String	wd-152630748****	模板名称。
DefaultVersionNumber	Long	1	模板默认版本号。
ModifiedTime	String	2018-05-14T14:18:00Z	修改时间。
LaunchTemplateId	String	lt-m5e3ofjr1zn1aw7q****	模板ID。
CreateTime	String	2018-05-14T14:18:00Z	实例启动模板创建时间。
ResourceGroupId	String	rg-acfmxazb4p****	启动模板所在的企业资源组ID。
CreatedBy	String	1234567890	模板的创建者。
LatestVersionNumber	Long	1	模板最新版本号。
Tags	Array of Tag		启动模板的标签对属性。
Tag
TagValue	String	TestValue	启动模板的标签值。
TagKey	String	TestKey	启动模板的标签键。

示例

请求示例

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格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/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	内部服务调用失败。

访问错误中心查看更多错误码。