DescribeLaunchTemplates

查询一个或多个可用的实例启动模板。

调试

前往【API Explorer】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。

请求参数


名称	类型	是否必选	示例值	描述
RegionId	String	是	cn-hangzhou	地域ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。
Action	String	否	DescribeLaunchTemplates	系统规定参数。取值：DescribeLaunchTemplates
LaunchTemplateId.N	RepeatList	否	lt-m5e3ofjr1zn1aw7qdxxx	一个或多个实例启动模板ID，最多支持查询 100 个启动模板。您必须指定LaunchTemplateId或LaunchTemplateName以确定模板。
LaunchTemplateName.N	RepeatList	否	wd-1526307480xxx	一个或多个实例启动模板名称，最多支持查询 100 个启动模板。
OwnerAccount	String	否	ECSforCloud@Alibaba.com	RAM用户的账号登录名称。
PageNumber	Integer	否	1	实例启动模板列表的页码。起始值：1 默认值：1
PageSize	Integer	否	10	分页查询时设置的每页行数。最大值：50 默认值：10
TemplateResourceGroupId	String	否	rg-resourcegroupid1	启动模板所在的企业资源组 ID。
TemplateTag.N.Key	String	否	FinanceDept	启动模板的标签键。n 的取值范围为 1~20。一旦传入该值，则不允许为空字符串。最多支持 64 个字符，不能以 aliyun、acs:、http:// 或者 https:// 开头。
TemplateTag.N.Value	String	否	FinanceDepltJoshua	启动模板的标签值。n的取值范围为 1~20。一旦传入该值，可以为空字符串。最多支持 128 个字符，不能以 aliyun、acs:、http:// 或者 https:// 开头。

返回参数


名称	类型	示例值	描述
LaunchTemplateSets			实例启动模板的信息集合
└CreateTime	String	2018-05-14T14:18:00Z	实例启动模板创建时间
└CreatedBy	String	1942111349714xxx	模板的创建者
└DefaultVersionNumber	Long	1	模板默认版本号
└LatestVersionNumber	Long	1	模板最新版本号
└LaunchTemplateId	String	lt-m5e3ofjr1zn1aw7qdxxx	模板ID
└LaunchTemplateName	String	wd-1526307480xxx	模板名称
└ModifiedTime	String	2018-05-14T14:18:00Z	修改时间
└ResourceGroupId	String	rg-resourcegroupid1	启动模板所在的企业资源组 ID。
└Tags			启动模板的标签对属性。
└TagKey	String	FinanceDept	启动模板的标签键。
└TagValue	String	FinanceDeptJoshua	启动模板的标签值。
PageNumber	Integer	1	当前页码
PageSize	Integer	10	分页查询时设置的每页行数
RequestId	String	04F0F334-1335-436C-A1D7-6C044FExxxxx	请求 ID。无论调用接口成功与否，我们都会返回请求 ID。
TotalCount	Integer	1	实例启动模板总个数

示例

请求示例


https://ecs.aliyuncs.com/?Action=DescribeLaunchTemplates
&RegionId=cn-hangzhou
&TemplateTag.1.Key=FinanceDept
&TemplateTag.1.Value=FinanceDepltJoshua
&LaunchTemplateId.1=lt-m5e3ofjr1zn1aw7qdxxx
&LaunchTemplateName.1=wd-1526307480xxx
&PageNumber=1
&PageSize=10
&TemplateResourceGroupId=rg-resourcegroupid1
&<公共请求参数>

正常返回示例

XML 格式

<DescribeLaunchTemplatesResponse>
  <RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</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-m5e3ofjr1zn1aw7xxxx</LaunchTemplateid>
      <LaunchTemplateName>wd-1526307480xxx</LaunchTemplateName>
      <DefaultVersionNumber>1</DefaultVersionNumber>
      <LatestVersionNumber>1</LatestVersionNumber>
      <CreatedBy>1942111349714xxx</CreatedBy>
    </LaunchTemplateSet>
  </LaunchTemplateSets>
</DescribeLaunchTemplatesResponse>

JSON 格式

{
	"PageNumber":1,
	"TotalCount":1,
	"LaunchTemplateSets":{
		"LaunchTemplateSet":[
			{
				"DefaultVersionNumber":1,
				"LaunchTemplateId":"lt-m5e3ofjr1zn1aw7qdxxx",
				"LatestVersionNumber":1,
				"CreateTime":"2018-05-14T14:18:00Z",
				"CreatedBy":"1942111349714xxx",
				"ModifiedTime":"2018-05-14T14:18:00Z",
				"LaunchTemplateName":"wd-1526307480xxx"
			}
		]
	},
	"PageSize":10,
	"RequestId":"04F0F334-1335-436C-A1D7-6C044FExxxxx"
}

错误码


HttpCode	错误码	错误信息	描述
400	InvalidRegion.NotExist	%s	指定的Region不存在。
400	MissingParameter	%s	缺失必需参数。
400	InvalidParameter	%s	参数格式不正确。
403	InnerServiceFailed	%s	内部服务调用失败。

查看本产品错误码

发布者：佚, 佚名，转转请注明出处：https://www.cms2.cn/aliyun/1954.html

调试

请求参数

返回参数

示例

错误码

相关推荐

使用Packer创建自定义镜像

AddTags

OperationLocksType

ModifySecurityGroupPolicy

ModifyInstanceAutoReleaseTime

阿里云对象存储OSS是怎么收费的？计量项和计费项都有哪些？

发表评论