查詢執行個體啟動模板版本。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:DescribeLaunchTemplateVersions |
RegionId | String | 是 | 執行個體啟動模板所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
LaunchTemplateId | String | 否 | 執行個體啟動模板 ID。您必須指定 LaunchTemplateId 或 LaunchTemplateName 以確定模板。 |
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 | 指定的 LaunchTemplateId 和 LaunchTemplateName 不存在。 |
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 | 伺服器內部錯誤。 |