利用可能なインスタンス起動テンプレートを照会します。
リクエストパラメータ
名前 | 型 | 必須 | 説明 |
---|---|---|---|
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 | インスタンス起動テンプレートの作成者 |
例
リクエスト例
https://ecs.aliyuncs.com/?Action=DescribeLaunchTemplates&RegionId=cn-hangzhou&<Common Request Parameters>
レスポンス例
XML 形式
JSON 形式
<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>
“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 | 内部サーバーエラー |