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"]}
    }
  }
}