インスタンス起動テンプレートのバージョンを照会します。
リクエストパラメーター
パラメーター | 型 | 必須かどうか | 説明 |
---|---|---|---|
Action | String | はい | インターフェイスの名前。値: DescribeLaunchTemplateVersions |
RegionId | String | はい | インスタンス起動テンプレートのリージョン ID。DescribeRegions を呼び出して、Alibaba Cloud リージョンの最新リストを表示できます。 |
LaunchTemplateId | String | いいえ | インスタンス起動テンプレート ID。テンプレートを決定するには、 LaunchTemplateId または LaunchTemplateName のいずれかを指定する必要があります。 |
LaunchTemplateName | String | いいえ | インスタンス起動テンプレート名 |
LaunchTemplateVersion.N | Long | いいえ | 1 つまたは複数のインスタンス起動テンプレートバージョン |
MinVersion | Long | いいえ | 範囲を使用してテンプレートを指定する場合の最小バージョン番号 |
MaxVersion | Long | いいえ | 範囲を使用してテンプレートを指定する場合の最大バージョン番号 |
DefaultVersion | Boolean | いいえ | デフォルトバージョンを照会するかどうか |
PageNumber | Integer | いいえ | インスタンス起動テンプレートリストのページ番号。開始値:1 デフォルト値:1 |
PageSize | Integer | いいえ | ページ単位で照会するときの 1 ページあたりの行数。最大値:50 デフォルト値:10 |
レスポンスパラメーター
パラメーター | 型 | 説明 |
---|---|---|
TotalCount | Integer | インスタンス起動テンプレートの総数 |
Pagenumber | Integer | 現在のページ番号 |
Pagesize | Integer | ページ単位で照会するときの 1 ページあたりの行数 |
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 | VSwitch ID |
InstanceName | String | インスタンス名 |
Description | String | インスタンスの説明 |
InternetMaxBandwidthIn | String | 最大インバウンドパブリック帯域幅 |
InternetMaxBandwidthOut | String | 最大アウトバウンドパブリック帯域幅 |
HostName | String | インスタンスホスト名 |
ZoneId | String | インスタンスのゾーン ID |
Systemdisk.Category | String | システムディスクタイプ |
SystemDisk.Size | Integer | システムディスクサイズ (単位 GiB) |
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 | ENI のプライマリプライベート IP アドレス |
NetworkInterface.n.VSwitchId | String | ENI の VSwitch の ID |
NetworkInterface.n.SecurityGroupId | String | セキュリティグループ ID。ENI と同じ VPC 内にある必要があります。 |
NetworkInterface.n.NetworkInterfaceName | String | ENI 名 |
NetworkInterface.n.Description | String | ENI の説明 |
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 形式
JSON 形式
<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>
{ “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 | 内部サーバーエラーです。 |