利用可能なインスタンス起動テンプレートを照会します。

リクエストパラメータ

名前 型 必須  説明 
Action  String  はい  本インターフェイスの名前。値: DescribeLaunchTemplates
RegionId String  はい インスタンス起動テンプレートのリージョン ID。最新のリージョン情報を確認するには、DescribeRegions を呼び出します。
LaunchTemplateId List いいえ インスタンス起動テンプレート ID を 1 つ以上指定します。最大 100 の起動テンプレート ID を指定できます。LaunchTemplateIdまたはLaunchTemplateNameでテンプレートを指定します。
LaunchTemplateName List  いいえ  インスタンス起動テンプレート名を 1 つ以上指定します。最大 100 の起動テンプレート名を指定できます。
Tag.n.Key String  いいえ  タグのキー。本タグは、インスタンス、ディスク、セキュリティグループ、または、イメージに適用されます。n に指定可能な値： 1 ～ 20。一旦本パラメータを使用すると、後で空の文字列を指定することはできません。64 字以内の文字列を指定します。「aliyun」、「acs:」、「http://」 および 「https://」 で始めることはできません。
Tag.n.Value String  いいえ  タグの値。本タグは、インスタンス、ディスク、セキュリティグループ、または、イメージに適用されます。n に指定可能な値： 1 ～ 20。一旦本パラメータを使用すれば、後で空の文字列を指定することができます。128 字以内の文字列を指定します。「aliyun」、「acs:」、「http://」 および 「https://」 で始めることはできません。
TemplateTag.n.Key String  いいえ  タグのキー。本タグは、起動テンプレートに適用されます。n に指定可能な値： 1 ～ 20。一旦本パラメータを使用すると、後で空の文字列を指定することはできません。64 字以内の文字列にします。「aliyun」、「acs:」、「http://」 および 「https://」 で始めることはできません。
TemplateTag.n.Value String  いいえ  タグの値。本タグは、起動テンプレートに適用されます。n に指定可能な値： 1 ～ 20。一旦本パラメータを使用すれば、後で空の文字列を指定することができます。128 字以内の文字列を指定します。「aliyun」、「acs:」、「http://」 および 「https://」 で始めることはできません。
PageNumber  Integer  いいえ  インスタンス起動テンプレートリストのページ番号。開始値: 1

初期値: 1
PageSize Integer いいえ  ページ単位でクエリを実行するときの、1 ページ当たりの行数。最大値: 50

初期値: 10

レスポンスパラメータ

名前  型  説明 
TotalCount Integer  インスタンス起動テンプレートの総数
PageNumber Integer  現在のページ番号 
PageSize  Integer   ページ単位でクエリを実行するときの、1 ページ当たりの行数
LaunchTemplateSet LaunchTemplateSet インスダンス起動テンプレートの情報セット
LaunchTemplateSet
名前  型  説明 
CreateTime  String  インスタンス起動テンプレートの作成時刻
ModifiedTime String  最終更新時刻
LaunchTemplateId String  インスタンス起動テンプレート ID
LaunchTemplateName String  インスタンス起動テンプレート名
DefaultVersionNumber Long  インスタンス起動テンプレートのデフォルトバージョン 
LatestVersionNumber Long インスタンス起動テンプレートの最新バージョン
CreatedBy String  インスタンス起動テンプレートの作成者

例

リクエスト例 
  1. https://ecs.aliyuncs.com/?Action=DescribeLaunchTemplates&RegionId=cn-hangzhou&<Common Request Parameters>
レスポンス例

XML 形式

  1. <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 形式  
  1.     “RequestId”: “04F0F334-1335-436C-A1D7-6C044FExxxxx”,    “TotalCount”:1,    “PageNumber”:1,    “PageSize”:10,    “LaunchTemplateSets”:{        “LaunchTemplateSet”:[{            “LaunchTemplateName”:”wd-1526307480xxx”,            “CreatedBy”:”1942111349714xxx”,            “ModifiedTime”:”2018-05-14T14:18:00Z”,            “LatestVersionNumber”:1,            “CreateTime”:”2018-05-14T14:18:00Z”,            “LaunchTemplateId”:”lt-m5e3ofjr1zn1aw7qdxxx”,            “DefaultVersionNumber”:1    }

エラーコード

本インターフェイスに固有のエラーコードは以下のとおりです。その他のエラーコードについては、API Error Center をご参照ください (英語のみ)。

エラーコード  エラーメッセージ HTTP ステータスコード  説明 
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  内部サーバーエラー