ALIYUN::ECS::LaunchTemplate は ECS インスタンス起動テンプレートを作成するために使用されます。
構文
{
"Type": "ALIYUN::ECS::LaunchTemplate",
"Properties": {
"LaunchTemplateName": String,
"VersionDescription": String,
"ImageId": String,
"InstanceType": String,
"SecurityGroupId": String,
"NetworkType": String,
"VSwitchId": String,
"InstanceName": String,
"Description": String,
"InternetMaxBandwidthIn": Integer,
"InternetMaxBandwidthOut": Integer,
"HostName": String,
"ZoneId": String,
"SystemDiskCategory": String,
"SystemDiskSize": Integer,
"SystemDiskDiskName": String,
"SystemDiskDescription": String,
"IoOptimized": String,
"InternetChargeType": String,
"UserData": String,
"KeyPairName": String,
"RamRoleName": String,
"AutoReleaseTime": String,
"SpotStrategy": String,
"SpotPriceLimit": String,
"SecurityEnhancementStrategy": String,
"DiskMappings": List,
"NetworkInterfaces": List,
"Tags": List,
"TemplateTags": List
}
}
プロパティ
プロパティ | データ型 | 必須/省略可能 | 更新可/不可 | 説明 | 制約 |
---|---|---|---|---|---|
LaunchTemplateName | String | 必須 | 不可 | インスタンス起動テンプレートの名前 | 名前は、英字、数字、コロン (:)、アンダースコア (_)、およびハイフン (-) を含め 2 - 128 文字指定できます。 先頭文字列は http:// とhttps:// 以外の英字にします。 |
VersionDescription | String | 省略可能 | 不可 | インスタンス起動テンプレートの最初のバージョンの説明 | 説明は 2 - 256 文字指定できます。 先頭文字列を http:// または https:// にすることはできません。 |
ImageId | String | 省略可能 | 不可 | イメージ ID | なし |
InstanceType | String | 省略可能 | 不可 | インスタンスタイプ | なし |
SecurityGroupId | String | 省略可能 | 不可 | セキュリティグループ ID | なし |
NetworkType | String | 省略可能 | 不可 | インスタンスのネットワークタイプ |
値の範囲 : classic: クラシックネットワーク vpc: VPC |
VSwitchId | String | 省略可能 | 不可 | VPC を使用してインスタンスを作成するときに指定される VSwitch のID | なし |
InstanceName | String | 省略可能 | 不可 | インスタンス名 | 名前は、英字、数字、コロン (:)、アンダースコア (_)、およびハイフン (-) を含め 2 - 128 文字指定できます。 先頭文字は http:// とhttps:// 以外の文字にします。 |
Description | String | 省略可能 | 不可 | インスタンスの説明 | 説明は 2 - 256 文字指定できます。 先頭文字列を http:// または https:// にすることはできません。 |
InternetMaxBandwidthIn | integer | 省略可能 | 不可 | Mbit/s 単位の最大インバウンドインターネット帯域幅 | 値の範囲 : [1,200]。 |
InternetMaxBandwidthOut | integer | 省略可能 | 不可 | Mbit/s 単位の最大アウトバウンドインターネット帯域幅 | 値の範囲 : 0 - 100。 |
HostName | String | 省略可能 | 不可 | インスタンスのホスト名 |
名前の先頭または末尾の文字はピリオド (.) またはハイフン (-) にすることはできず、連続するピリオド (.) またはハイフン (-) は指定できません。 Windows インスタンスの場合 : ホスト名の長さは、英字、数字、ハイフン (-)、およびピリオド (.) 以外の 2 - 15 文字です。 数字だけで構成されたホスト名は許可されません。 他のインスタンス (Linux インスタンスなど): ホスト名の長さは、英字、数字、ハイフン (-)、およびピリオド (.) を含め 2 - 64 文字です。 ピリオド (.) は、名前を複数のセグメントに分割する場合に使用します。 |
ZoneId | String | 省略可能 | 不可 | インスタンスが設置されているゾーンの ID | なし |
SystemDiskCategory | String | 省略可能 | 不可 | システムディスクタイプ | 値の範囲 :
cloud: クラウドディスク cloud_efficiency: 効率の良いクラウドディスクcloud_ssd:クラウド SSD ephemeral_ssd: ローカル SSD |
SystemDiskSize | integer | 省略可能 | 不可 | GiB 単位のシステムディスクサイズ | 値の範囲 : [20, 500] |
SystemDiskDiskName | String | 省略可能 | 不可 | システムディスク名 | 名前は、英字、数字、コロン (:)、アンダースコア (_)、およびハイフン (-) を含め 2 - 128 文字指定できます。 先頭文字列は http:// とhttps:// 以外の英字にします。 |
SystemDiskDescription | String | 省略可能 | 不可 | システムディスクの説明。 | 説明は 2 - 256 文字指定できます。 先頭文字列を http:// または https:// にすることはできません。 |
IoOptimized | String | 省略可能 | 不可 | I/O 最適化インスタンスかどうかを示します。 |
値の範囲 : none : インスタンスは I/O 最適化インスタンスではありません。 optimize : インスタンスは I/O 最適化インスタンスです。 |
InternetChargeType | String | 省略可能 | 不可 | ネットワーク課金方法 |
値の範囲 : PayByBandwidth : ネットワーク料金は帯域幅で課金されます。 PayByTraffic : ネットワーク料金はトラフィックで課金されます。 |
UserData | String | 省略可能 | 不可 | カスタムインスタンスデータ | データは Base64 でエンコードする必要があり、生データは最大 16 KB 含めることができます。 |
KeyPairName | String | 省略可能 | 不可 | キーペア名 | Windows インスタンスの場合、名前は無視することができ、デフォルトでは空です。 このプロパティを設定していても、インスタンスへのログイン時に有効なのは自分のパスワードを使用したログインだけです。 Linux インスタンスの場合、ユーザー名/パスワードによるログイン方法は初期化され無効になります。 |
RamRoleName | String | 省略可能 | 不可 | インスタンス内のロールの名前 | なし |
AutoReleaseTime | String | 省略可能 | 不可 | インスタンスが自動的にリリースされた時刻 | 時間形式は yyyy-MM-ddTHH:mm:ssZ です。UTC でなければならず、ISO 8601 規格に準拠する必要があります。 |
SpotStrategy | String | 省略可能 | 不可 | 従量課金インスタンスのプリエンプティブポリシー |
このプロパティは、インスタンス作成 API で InstanceChargeType パラメーターが PostPaid に設定されている場合のみ有効です。 値の範囲 : NoSpot : 通常の従量課金インスタンス SpotWithPriceLimit : 事前に設定された料金制限のあるプリエンプティブルインスタンス SpotAsPriceGo : システム生成の従量課金の料金がいちばん高いインスタンス |
SpotPriceLimit | String | 省略可能 | 不可 | 1 時間当たりのインスタンスの最大料金 | 小数点以下 3 桁までサポートされています。 |
SecurityEnhancementStrategy | String | 省略可能 | 不可 | セキュリティ強化を有効にするかどうか |
値の範囲: Active: 有効化 Deactive: 無効化 |
DiskMappings | List | 省略可能 | 不可 | データディスク一覧 | 一覧には最大 16 個のデータディスクを記述できます。 |
NetworkInterfaces | List | 省略可能 | 不可 | ENI 一覧 | 一覧には最大 8 つの ENI を記述できます。 |
Tags | List | 省略可能 | 不可 | インスタンス、セキュリティグループ、ディスク、および ENI のタグの一覧 | 一覧には最大 20 個のタグを記述できます。 |
TemplateTags | List | 省略可能 | 不可 | インスタンス起動テンプレート内のタグの一覧 | 一覧には最大 20 個のタグを記述できます。 |
DiskMappings の構文
"DiskMappings": [
{
"Category": String,
"DiskName": String,
"Description": String,
"SnapshotId": String,
"Size": String,
"Encrypted": String,
"DeleteWithInstance": String,
}
]
DiskMappings のプロパティ
プロパティ | 型 | 必須/省略可能 | 更新可/不可 | 説明 | 制約 |
---|---|---|---|---|---|
Category | String | 省略可能 | 不可 | データディスクタイプ |
値の範囲 : cloud: クラウドディスク cloud_efficiency: 効率の良いクラウドディスク cloud_ssd: クラウド SSD ephemeral_ssd: ローカル SSD |
DiskName | String | 省略可能 | 不可 | データディスク名 | 名前は、英字、数字、コロン (:)、アンダースコア (_)、およびハイフン (-) を含め 2 - 128 文字指定できます。 先頭文字列は http:// とhttps:// 以外の英字にします。 |
Description | String | 省略可能 | 不可 | データディスクの説明 | 説明は 2 - 256 文字指定できます。 先頭文字列を http:// または https:// にすることはできません。 |
SnapshotId | String | 省略可能 | 不可 | データディスクの作成に使用されるスナップショット | なし |
Size | String | 省略可能 | 不可 | GiB 単位のシステムディスクサイズ |
値の範囲 : cloud: [5, 2000] cloud_efficiency: [20, 32768] cloud_ssd: [20, 32768] ephemeral_ssd: [5, 800] |
Encrypted | ブール値 | 省略可能 | 不可 | データディスクを暗号化するかどうか | なし |
DeleteWithInstance | ブール値 | 省略可能 | 不可 | データディスクをインスタンスと共にリリースするかどうか | なし |
NetworkInterfaces の構文
"NetworkInterfaces": [
{
"PrimaryIpAddress": String,
"VSwitchId": String,
"SecurityGroupId": String,
"NetworkInterfaceName": String,
"Description": String }
]
NetworkInterfaces のプロパティ
プロパティ | データ型 | 必須/省略可能 | 更新可/不可 | 説明 | 制約 |
---|---|---|---|---|---|
PrimaryIpAddress | String | 省略可能 | 不可 | ENI のプライマリプライベート IP アドレス。 | なし |
VSwitchId | String | 省略可能 | 不可 | ENI が属する VSwitch の ID | なし |
SecurityGroupId | String | 省略可能 | 不可 | ENI が属するセキュリティグループの ID | なし |
NetworkInterfaceName | String | 省略可能 | 不可 | ENI 名 | なし |
Description | String | 省略可能 | 不可 | ENI の説明 | 説明は 2 - 256 文字指定できます。 先頭文字列を http:// または https:// にすることはできません。 |
Tags の構文
"Tags": [
{
"Value": String,
"Key": String
}
]
Tags のプロパティ
プロパティ | データ型 | 必須/省略可能 | 更新可/不可 | 説明 | 制約 |
---|---|---|---|---|---|
key | String | 必須 | 不可 | なし | なし |
value | String | 省略可能 | 不可 | なし | なし |
Templatetgers の構文
"TemplateTags": [
{
"Value": String,
"Key": String
}
]
Templatetgers のプロパティ
プロパティ | データ型 | 必須/省略可能 | 更新可/不可 | 説明 | 制約 |
---|---|---|---|---|---|
key | String | 必須 | 不可 | なし | なし |
value | String | 省略可能 | 不可 | なし | なし |
戻り値
Fn::GetAtt- LaunchTemplateId : インスタンス起動テンプレートの ID
- LaunchTemplateName : インスタンス起動テンプレートの名前
- DefaultVersionNumber : インスタンス起動テンプレートのデフォルトバージョン
- LatestVersionNumber : インスタンス起動テンプレートの最新バージョン
コーディング例
{
"ROSTemplateFormatVersion": "2015-09-01",
"Resources": {
"Template1": {
"Type": "ALIYUN::ECS::LaunchTemplate",
"Properties": {
"LaunchTemplateName": "MyTemplate",
"VersionDescription": "Launch template with all properties set",
"ImageId": "m-2ze9uqi7wo61hwep5q52",
"InstanceType": "ecs.n4.small",
"SecurityGroupId": "sg-2ze8yxgempcdsq3iucsi",
"NetworkType": "vpc",
"VSwitchId": "vsw-2zei67xd9nhcqxzec7qt7",
"InstanceName": "InstanceName",
"Description": "Description of template",
"InternetMaxBandwidthIn": 100,
"InternetMaxBandwidthOut": 200,
"HostName": "tttinfo",
"ZoneId": "cn-beijing-a",
"SystemDiskCategory": "cloud_ssd",
"SystemDiskSize": "40",
"SystemDiskDiskName": "TheSystemDiskName",
"SystemDiskDescription": "The system disk description",
"IoOptimized": "optimized",
"InternetChargeType": "PayByBandwidth",
"UserData": "dGhpcyBpcyBhIHVzZXIgZGF0YSBleG1hcGxl",
"KeyPairName": "ThisIsKeyPair",
"RamRoleName": "ThisIsRamRole",
"AutoReleaseTime": "2050-10-01T00:00:00Z",
"SpotStrategy": "SpotWithPriceLimit",
"SpotPriceLimit": "100.001",
"SecurityEnhancementStrategy": "Active",
"DiskMappings": [
{
"Category": "cloud_ssd",
"Size": 40,
"SnapshotId": "s-2ze1fr2bipove27bn9mz",
"Encrypted": true,
"DiskName": "dataDisk1",
"Description": "I am data disk 1",
"DeleteWithInstance": true
},
{
"Category": "cloud_efficiency",
"Size": 20,
"SnapshotId": "s-2ze4k0w8b33mlsqu4tl6",
"Encrypted": false,
"DiskName": "dataDisk2",
"Description": "I am data disk 2",
"DeleteWithInstance": true
}
],
"NetworkInterfaces": [
{
"PrimaryIpAddress": "10.10.1.1",
"VSwitchId": "vsw-2zetgeiqlemyok9z5j2em",
"SecurityGroupId": "sg-2ze8yxgempcdsq3iucsi",
"NetworkInterfaceName": "my-eni1",
"Description": "My eni 1"
},
],
"Tags": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
}
],
"TemplateTags": [
{
"Key": "templateKey1",
"Value": "templateValue1"
},
{
"Key": "templateKey2",
"Value": "templateValue2"
}
]
}
}
},
"Outputs": {
"LaunchTemplateId": {
"Value": {"Fn::GetAtt": ["Template1","LaunchTemplateId"]}
},
"LaunchTemplateName": {
"Value": {"Fn::GetAtt": ["Template1","LaunchTemplateName"]}
},
"DefaultVersionNumber": {
"Value": {"Fn::GetAtt": ["Template1","DefaultVersionNumber"]}
},
"LatestVersionNumber": {
"Value": {"Fn::GetAtt": ["Template1","LatestVersionNumber"]}
}
}
}