查詢執行個體啟動模板版本。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:DescribeLaunchTemplateVersions
RegionId String 執行個體啟動模板所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
LaunchTemplateId String 執行個體啟動模板 ID。您必須指定 LaunchTemplateIdLaunchTemplateName 以確定模板。
LaunchTemplateName String 執行個體啟動模板名稱。
LaunchTemplateVersion.N Long 一個或多個執行個體啟動模板版本。
MinVersion Long 通過範圍指定版本時的最小版本號碼。
MaxVersion Long 通過範圍指定版本時的最大版本號碼。
DefaultVersion Boolean 是否查詢預設版本。
PageNumber Integer 執行個體啟動模板列表的頁碼。起始值:1

預設值:1

PageSize Integer 分頁查詢時設定的每頁行數。最大值:50

預設值:10

返回參數

返回參數

名稱 類型 描述
TotalCount Integer 執行個體啟動模板總數
PageNumber Integer 當前頁碼
PageSize Integer 分頁查詢時設定的每頁行數
LaunchTemplateVersionSet LaunchTemplateVersionSet 關於模板版本的資訊
資料類型 LaunchTemplateVersionSet
名稱 類型 描述
CreateTime String 模板建立時間
ModifiedTime String 模板修改時間
LaunchTemplateId String 模板 ID
LaunchTemplateName String 模板名稱
DefaultVersion Boolean 模板預設版本
VersionNumber Long 模板版本號碼
VersionDescription Long 模板版本描述
createdBy String 模板的建立者
LaunchTemplateData LaunchTemplateData 模板具體配置
資料類型 LaunchTemplateData
名稱 類型 描述
ImageId String 鏡像 ID
InstanceType String 執行個體規格
SecurityGroupId String 安全性群組 ID
VSwitchId String 虛擬交換器 ID
InstanceName String 執行個體名稱
Description String 執行個體描述
InternetMaxBandwidthIn String 公網入頻寬最大值
InternetMaxBandwidthOut String 公網出頻寬最大值
HostName String 執行個體主機名稱
ZoneId String 執行個體所屬的可用性區域 ID
SystemDisk.Category String 系統盤種類
SystemDisk.Size Integer 系統盤大小,單位為 GB
SystemDisk.DiskName String 系統盤名稱
SystemDisk.Description String 系統盤描述
DataDisk.n.Size Integer 資料盤大小
DataDisk.n.SnapshotId String 資料盤使用的快照 ID
DataDisk.n.Category String 資料盤的磁碟種類
DataDisk.n.Encrypted Boolean 資料盤是否加密
DataDisk.n.DiskName String 系統盤名稱
DataDisk.n.Description String 系統盤描述
DataDisk.n.DeleteWithInstance String 資料盤是否隨執行個體釋放而釋放
IoOptimized String 是否為 I/O 優化執行個體
NetworkInterface.n.PrimaryIpAddress String 彈性網卡的主私有 IP 位址
NetworkInterface.n.VSwitchId String 彈性網卡所屬的虛擬交換器 ID
NetworkInterface.n.SecurityGroupId String 所屬的安全性群組 ID 必須是同一個 VPC 下的安全性群組
NetworkInterface.n.NetworkInterfaceName String 彈性網卡名稱
NetworkInterface.n.Description String 彈性網卡描述資訊
Period Integer 購買資源的時長
InternetChargeType String 公網頻寬計費方式
NetworkType String 網路類型
UserData String 執行個體自訂資料,需要以 Base64 方式編碼
KeyPairName String 金鑰組名稱
RamRoleName String 執行個體 RAM 角色名稱稱
AutoReleaseTime String 自動釋放時間
SpotStrategy String 後付費執行個體的競價策略
SpotPriceLimit Float 設定執行個體的每小時最高價格
SecurityEnhancementStrategy String 是否開啟安全加固
Tag.n.Key String 執行個體的標籤鍵
Tag.n.Value Float 執行個體的標籤值

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=DescribeLaunchTemplateVersions
&RegionId=cn-hangzhou
&LaunchTemplateName=lt-name1
&<公共請求參數>
返回樣本

XML 格式

<DescribeLaunchTemplateVersionsResponse>
	<RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
	<TotalCount>1</TotalCount>
	<PageNumber>1</PageNumber>
	<PageSize>10</PageSize>
	<LaunchTemplateVersionSets>
		<LaunchTemplateVersionSet>
			<CreateTime>2018-05-14T14:18:00Z</CreateTime>
			<ModifiedTime>2018-05-14T14:18:00Z</ModifiedTime>
			<LaunchTemplateId>lt-m5e3ofjr1zn1aw7xxxx</LaunchTemplateId>
			<LaunchTemplateName>wd-1526307480xxx</LaunchTemplateName>
			<DefaultVersion>true</DefaultVersion>
			<VersionNumber>1</VersionNumber>
			<CreatedBy>1942111349714xxx</CreatedBy>
			<VersionDescription>wwww</VersionDescription>
			<launchtemplatedata>
					 <imageowneralias>ImageOwnerAlias1</imageowneralias>
					 <description>Description1</description>
					 <resourcegroupid>ResourceGroupId1</resourcegroupid>
					 <datadisks>
						 <datadisk>
							 <snapshotid>SnapshotId1</snapshotid>
							 <description>Description1</description>
							 <category>cloud_efficiency</category>
							 <encrypted>false</encrypted>
							 <size>44</size>
							 <deletewithinstance>true</deletewithinstance>
							 <diskname>DataDiskName1</diskname>
						 </datadisk>
					 </datadisks>
					 <userdata>UserData1</userdata>
					 <systemdisk.diskname>SystemDiskDiskName1</systemdisk.diskname>
					 <systemdisk.size>44</systemdisk.size>
					 <ramrolename>RamRoleName1</ramrolename>
					 <networktype>NetworkType1</networktype>
					 <networkinterfaces>
						 <networkinterface>
							 <description>Description1</description>
							 <securitygroupid>SecurityGroupId1</securitygroupid>
							 <vswitchid>VSwitchId1</vswitchid>
							 <networkinterfacename>NetworkInterfaceName1</networkinterfacename>
							 <primaryipaddress>PrimaryIpAddress1</primaryipaddress>
						 </networkinterface>
					 </networkinterfaces>
					 <imageid>windows2008.vhd</imageid>
					 <spotpricelimit>1</spotpricelimit>
					 <systemdisk.category>cloud_efficiency</systemdisk.category>
					 <instancetype>ecs.xn4.small</instancetype>
					 <spotstrategy>SpotWithPriceLimit</spotstrategy>
					 <hostname>HostName1</hostname>
					 <tags>
						 <instancetag>
							 <value>bb</value>
							 <key>ss</key>
						 </instancetag>
					 </tags>
					 <keypairname>KeyPairName1</keypairname>
					 <systemdisk.iops>22</systemdisk.iops>
					 <iooptimized>true</iooptimized>
					 <zoneid>ZoneId1</zoneid>
					 <systemdisk.description>SystemDiskDescription1</systemdisk.description>
					 <securitygroupid>sg-tiantt1234</securitygroupid>
					 <vswitchid>vsw-xxxxxx</vswitchid>
					 <period>1</period>
					 <internetchargetype>PayByBandwidth</internetchargetype>
					 <instancename>InstanceName1</instancename>
					 <internetmaxbandwidthout>20</internetmaxbandwidthout>
					 <internetmaxbandwidthin>1</internetmaxbandwidthin>
					 <securityenhancementstrategy>Active</securityenhancementstrategy>
					 <autoreleasetime>2019-10-21T00:00:00Z</autoreleasetime>
				 </launchtemplatedata>
		</LaunchTemplateVersionSet>
	</LaunchTemplateVersionSets>
</DescribeLaunchTemplateVersionsResponse>
JSON 格式
{
	"RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx",
	"TotalCount":1,
	"PageNumber":1,
	"PageSize":10,
	"LaunchTemplateVersionSets":{
		"LaunchTemplateVersionSet":[{
			{
					"LaunchTemplateData":{
						"Description":"Description1",
						"ResourceGroupId":"ResourceGroupId1",
						"DataDisks":{
							"DataDisk":[
								{
									"SnapshotId":"SnapshotId1",
									"Description":"Description1",
									"Category":"cloud_efficiency",
									"Encrypted":false,
									"Size":44,
									"DeleteWithInstance":true,
									"DiskName":"DataDiskName1"
								}
							]
						},
						"UserData":"UserData1",
						"SystemDisk.DiskName":"SystemDiskDiskName1",
						"SystemDisk.Size":44,
						"RamRoleName":"RamRoleName1",
						"NetworkType":"NetworkType1",
						"NetworkInterfaces":{
							"NetworkInterface":[
								{
									"Description":"Description1",
									"SecurityGroupId":"SecurityGroupId1",
									"VSwitchId":"VSwitchId1",
									"NetworkInterfaceName":"NetworkInterfaceName1",
									"PrimaryIpAddress":"PrimaryIpAddress1"
								}
							]
						},
						"ImageId":"windows2008.vhd",
						"SpotPriceLimit":1,
						"SystemDisk.Category":"cloud_efficiency",
						"InstanceType":"ecs.xn4.small",
						"SpotStrategy":"SpotWithPriceLimit",
						"HostName":"HostName1",
						"Tags":{
							"InstanceTag":[
								{
									"Value":"bb",
									"Key":"ss"
								}
							]
						},
						"KeyPairName":"KeyPairName1",
						"SystemDisk.Iops":22,
						"IoOptimized":"true",
						"ZoneId":"ZoneId1",
						"SystemDisk.Description":"SystemDiskDescription1",
						"SecurityGroupId":"sg-tiantt1234",
						"VSwitchId":"vsw-xxxxxx",
						"Period":1,
						"InternetChargeType":"PayByBandwidth",
						"InstanceName":"InstanceName1",
						"InternetMaxBandwidthOut":20,
						"InternetMaxBandwidthIn":1,
						"SecurityEnhancementStrategy":"Active",
						"AutoReleaseTime":"2019-10-21T00:00:00Z"
					},
					"LaunchTemplateName":"wd-1526308145065",
					"CreatedBy":"1942111349714263",
					"VersionDescription":"wwwdesc",
					"ModifiedTime":"2018-05-14T14:29:05Z",
					"CreateTime":"2018-05-14T14:29:05Z",
					"DefaultVersion":true,
					"LaunchTemplateId":"lt-m5efs0xpur7pey3y9yt7",
					"VersionNumber":1
				}
		}]
	}
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidLaunchTemplate.NotFound The specified LaunchTemplateId “{0}” LaunchTemplateName “{1}” is not found. 400 指定的 LaunchTemplateIdLaunchTemplateName不存在。
MissingParameter The input parameter “{0}” that is mandatory for processing this request is not supplied. 400 缺失必需參數。
InvalidParameter the parameter(s) “{0}” provided is(are) invalid. 400 指定的參數不合法。
InnerServiceFailed call inner service failed 403 伺服器內部錯誤。