ALIYUN::ECS::LaunchTemplate類型用于創(chuàng)建ECS實(shí)例啟動(dòng)模板。

語法

{
  "Type": "ALIYUN::ECS::LaunchTemplate",
  "Properties": {
    "LaunchTemplateName": String,
    "VersionDescription": String,
    "ImageId": String,
    "InstanceType": String,
    "SecurityGroupId": String,
    "NetworkType": String,
    "VSwitchId": String,
    "InstanceName": String,
    "Description": String,
    "InternetMaxBandwidthOut": Integer,
    "HostName": String,
    "ZoneId": String,
    "SystemDiskCategory": String,
    "SystemDiskSize": Number,
    "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,
    "TemplateResourceGroupId": String,
    "SecurityGroupIds": List,
    "ResourceGroupId": String,
    "SpotDuration": Integer,
    "ImageOwnerAlias": String,
    "Period": Integer,
    "Ipv6AddressCount": Integer,
    "PrivateIpAddress": String,
    "PasswordInherit": Boolean,
    "SystemDiskDeleteWithInstance": Boolean,
    "DeploymentSetId": String,
    "InstanceChargeType": String,
    "SystemDiskPerformanceLevel": String
  }
}

屬性

屬性名稱類型必須允許更新描述約束
LaunchTemplateNameString實(shí)例啟動(dòng)模板名稱。長度為2~128個(gè)字符。必須以英文字母或漢字開頭,不能以http://https://開頭。可包含英文字母、漢字、數(shù)字、半角冒號(hào)(:)、下劃線(_)和短劃線(-)。
VersionDescriptionString實(shí)例啟動(dòng)模板版本描述。長度為2~128個(gè)字符。必須以英文字母或漢字開頭,不能以http://https://開頭。
ImageIdString鏡像ID。
InstanceTypeString實(shí)例類型。
SecurityGroupIdString安全組ID。
NetworkTypeString實(shí)例網(wǎng)絡(luò)類型。取值:
  • classic:經(jīng)典網(wǎng)絡(luò)。
  • vpc:專有網(wǎng)絡(luò)。
VSwitchIdString交換機(jī)ID。當(dāng)NetworkType取值為vpc時(shí)該參數(shù)有效。
InstanceNameString實(shí)例名稱。長度為2~128個(gè)字符。必須以英文字母或漢字開頭,不能以http://https://開頭。
DescriptionString實(shí)例描述。長度為2~128個(gè)字符。必須以英文字母或漢字開頭,不能以http://https://開頭。
InternetMaxBandwidthOutInteger公網(wǎng)出網(wǎng)帶寬最大值。取值范圍:0~100。

單位:Mbps。

HostNameString實(shí)例主機(jī)名。

英文句點(diǎn)(.)和短劃線(-)不能作為首尾字符,也不能連續(xù)使用。

取值要求:
  • Windows實(shí)例:長度為2~15個(gè)字符。 不能全是數(shù)字。可包含英文字母、數(shù)字和短劃線(-)。
  • 其他類型實(shí)例(Linux等):長度為2~64個(gè)字符。 可包含英文字母、數(shù)字和短劃線(-)。
ZoneIdString實(shí)例所屬的可用區(qū)ID。
SystemDiskCategoryString系統(tǒng)盤類型。取值:
  • cloud:普通云盤。
  • cloud_efficiency:高效云盤。
  • cloud_ssd:SSD云盤。
  • ephemeral_ssd:本地SSD盤。
SystemDiskSizeNumber系統(tǒng)盤大小。取值范圍:20~500。

單位:GB。

SystemDiskDiskNameString系統(tǒng)盤名稱。長度為2~128個(gè)字符。必須以英文字母或漢字開頭,不能以http://https://開頭。可包含英文字母、漢字、數(shù)字、半角冒號(hào)(:)、下劃線(_)和短劃線(-)。
SystemDiskDescriptionString系統(tǒng)盤描述。長度為2~256個(gè)字符,不能以http://https://開頭。
IoOptimizedString是否為I/O優(yōu)化實(shí)例。取值:
  • none:非I/O優(yōu)化實(shí)例。
  • optimized:I/O優(yōu)化實(shí)例。
InternetChargeTypeString網(wǎng)絡(luò)付費(fèi)類型。取值:
  • PayByBandwidth:按帶寬計(jì)費(fèi)。
  • PayByTraffic:按流量計(jì)費(fèi)。
UserDataString實(shí)例自定義數(shù)據(jù)。需要以Base64方式編碼,原始數(shù)據(jù)不超過16KB。
KeyPairNameString密鑰對(duì)名稱。僅Linux實(shí)例需要指定該參數(shù),此時(shí)密碼登錄方式會(huì)被初始化為禁止。
RamRoleNameString實(shí)例RAM角色名稱。
AutoReleaseTimeString實(shí)例自動(dòng)釋放時(shí)間。按照ISO8601標(biāo)準(zhǔn)表示。需要使用UTC時(shí)間,格式為yyyy-MM-ddTHH:mm:ssZ
SpotStrategyString后付費(fèi)實(shí)例的搶占策略。

當(dāng)InstanceChargeType參數(shù)取值為PostPaid時(shí)該參數(shù)生效。

取值:

  • NoSpot:正常按量付費(fèi)實(shí)例。
  • SpotWithPriceLimit:設(shè)置上限價(jià)格的搶占式實(shí)例。
  • SpotAsPriceGo:系統(tǒng)自動(dòng)出價(jià),最高按量付費(fèi)價(jià)格。
SpotPriceLimitString設(shè)置實(shí)例的每小時(shí)最高價(jià)格。支持最多3位小數(shù)。
SecurityEnhancementStrategyString是否開啟安全加固。取值:
  • Active:開啟。
  • Deactive:關(guān)閉。
DiskMappingsList數(shù)據(jù)盤列表。最多支持16個(gè)數(shù)據(jù)盤。

更多信息,請(qǐng)參見DiskMappings屬性

NetworkInterfacesList彈性網(wǎng)卡列表。最多支持8個(gè)彈性網(wǎng)卡。

更多信息,請(qǐng)參見NetworkInterfaces屬性

TagsList實(shí)例、安全組、磁盤和網(wǎng)卡的標(biāo)簽列表。最多支持20個(gè)標(biāo)簽。

更多信息,請(qǐng)參見Tags屬性

TemplateTagsList啟動(dòng)模板的標(biāo)簽列表。最多支持20個(gè)標(biāo)簽。

更多信息,請(qǐng)參見TemplateTags屬性

TemplateResourceGroupIdString啟動(dòng)模板所在的資源組ID。
SecurityGroupIdsList實(shí)例加入的一個(gè)或多個(gè)安全組。取值與實(shí)例能夠加入的安全組配額有關(guān)。
說明 不支持同時(shí)指定SecurityGroupId和SecurityGroupIds。
ResourceGroupIdString實(shí)例、塊存儲(chǔ)和彈性網(wǎng)卡所在的資源組ID。
SpotDurationInteger搶占式實(shí)例的保留時(shí)長。取值范圍:0~6。

默認(rèn)值:1。

單位:小時(shí)。

說明 如需設(shè)置取值為2~6,請(qǐng)?zhí)峤还巍?/div>
ImageOwnerAliasString鏡像來源。取值范圍:
  • system:阿里云提供的公共鏡像。
  • self:您創(chuàng)建的自定義鏡像。
  • others:其他阿里云用戶共享給您的鏡像。
  • marketplace:鏡像市場。
PeriodInteger購買資源的時(shí)長。InstanceChargeType取值為PrePaid時(shí)該參數(shù)有效,且必須指定。

取值:1~9、12、24、36、48、60。

單位:月。

Ipv6AddressCountInteger為主網(wǎng)卡指定隨機(jī)生成的IPv6地址數(shù)量。取值范圍:1~10。
PrivateIpAddressString實(shí)例私網(wǎng)IP地址。專有網(wǎng)絡(luò)VPC類型ECS實(shí)例設(shè)置私網(wǎng)IP地址時(shí),必須從交換機(jī)的空閑網(wǎng)段中選擇。
PasswordInheritBoolean是否使用鏡像預(yù)設(shè)的密碼。取值:
  • true:使用。
  • false:不使用。
說明 PasswordInherit和Password必須且只能指定其中一個(gè)參數(shù)。
SystemDiskDeleteWithInstanceBoolean系統(tǒng)盤是否隨實(shí)例釋放。取值:
  • true(默認(rèn)):釋放。
  • false:不釋放。
DeploymentSetIdString部署集ID。
InstanceChargeTypeString實(shí)例的計(jì)費(fèi)方式。取值:
  • PrePaid:預(yù)付費(fèi),包年包月。
  • PostPaid:后付費(fèi),按實(shí)際使用量付費(fèi)。
SystemDiskPerformanceLevelString創(chuàng)建ESSD云盤作為系統(tǒng)盤使用時(shí),云盤的性能等級(jí)。取值:
  • PL0(默認(rèn)):單盤最高隨機(jī)讀寫IOPS 1萬。
  • PL1:單盤最高隨機(jī)讀寫IOPS 5萬。
  • PL2:單盤最高隨機(jī)讀寫IOPS 10萬。
  • PL3:單盤最高隨機(jī)讀寫IOPS 100萬。

DiskMappings語法

"DiskMappings": [
  {
    "Category": String,
    "DiskName": String,
    "Description": String,
    "SnapshotId": String,
    "Size": String,
    "Encrypted": String,
    "DeleteWithInstance": String,
    "PerformanceLevel": String
  }
]

DiskMappings屬性

屬性名稱類型必須允許更新描述約束
CategoryString數(shù)據(jù)盤類型。取值:
  • cloud:普通云盤。
  • cloud_efficiency:高效云盤。
  • cloud_ssd:SSD云盤。
  • ephemeral_ssd:本地SSD盤。
DiskNameString數(shù)據(jù)盤名稱。長度為2~128個(gè)字符。必須以英文字母或漢字開頭,不能以http://https://開頭。可包含英文字母、漢字、數(shù)字、半角冒號(hào)(:)、下劃線(_)和短劃線(-)。
DescriptionString數(shù)據(jù)盤描述。長度為2~256個(gè)字符,不能以http://https://開頭。
SnapshotIdString創(chuàng)建數(shù)據(jù)盤使用的快照。
SizeString系統(tǒng)盤大小。

取值范圍:

  • cloud:5~2000。
  • cloud_efficiency:20~32768。
  • cloud_ssd:20~32768。
  • ephemeral_ssd:5~800。

單位:GB。

EncryptedBoolean是否加密數(shù)據(jù)盤。取值:
  • true:加密。
  • false:不加密。
DeleteWithInstanceBoolean數(shù)據(jù)盤是否隨實(shí)例釋放而釋放。取值:
  • true:釋放。
  • false:不釋放。
PerformanceLevelString創(chuàng)建ESSD云盤作為數(shù)據(jù)盤使用時(shí),云盤的性能等級(jí)。取值:
  • PL0(默認(rèn)):單盤最高隨機(jī)讀寫IOPS 1萬。
  • PL1:單盤最高隨機(jī)讀寫IOPS 5萬。
  • PL2:單盤最高隨機(jī)讀寫IOPS 10萬。
  • PL3:單盤最高隨機(jī)讀寫IOPS 100萬。

NetworkInterfaces語法

"NetworkInterfaces": [
  {
    "PrimaryIpAddress": String,
    "VSwitchId": String,
    "SecurityGroupId": String,
    "NetworkInterfaceName": String,
    "Description": String
  }
]

NetworkInterfaces屬性

屬性名稱類型必須允許更新描述約束
PrimaryIpAddressString彈性網(wǎng)卡的主私有IP地址。
VSwitchIdString彈性網(wǎng)卡所屬的交換機(jī)ID。
SecurityGroupIdString彈性網(wǎng)卡所屬的安全組ID。
NetworkInterfaceNameString彈性網(wǎng)卡名稱。
DescriptionString彈性網(wǎng)卡描述信息。長度為2~256個(gè)字符,不能以http://https://開頭。

Tags語法

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Tags屬性

屬性名稱類型必須允許更新描述約束
KeyString標(biāo)簽鍵。長度為1~128個(gè)字符,不能以aliyunacs:開頭,不能包含http://或者https://
ValueString標(biāo)簽值。長度為0~128個(gè)字符,不能以aliyunacs:開頭,不能包含http://或者https://

TemplateTags語法

"TemplateTags": [
  {
    "Value": String,
    "Key": String
  }
]

TemplateTags屬性

屬性名稱類型必須允許更新描述約束
KeyString標(biāo)簽鍵。長度為1~128個(gè)字符,不能以aliyunacs:開頭,不能包含http://或者https://
ValueString標(biāo)簽值。長度為0~128個(gè)字符,不能以aliyunacs:開頭,不能包含http://或者https://

返回值

Fn::GetAtt

  • LaunchTemplateId:實(shí)例啟動(dòng)模板ID。
  • LaunchTemplateName:實(shí)例啟動(dòng)模板名稱。
  • DefaultVersionNumber:實(shí)例啟動(dòng)模板默認(rèn)版本號(hào)。
  • LatestVersionNumber:實(shí)例啟動(dòng)模板最新版本號(hào)。

示例

  • YAML格式

    ROSTemplateFormatVersion: '2015-09-01'
    Description: Test ECS LaunchTemplate
    Parameters:
      VSwitchId:
        Type: String
        AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
      SecurityGroupId:
        AssociationProperty: ALIYUN::ECS::SecurityGroup::SecurityGroupId
        Type: String
    Resources:
      LaunchTemplate:
        Type: ALIYUN::ECS::LaunchTemplate
        Properties:
          LaunchTemplateName: mytest
          VersionDescription: Test create LaunchTemplate
          ImageId: centos_7
          InstanceType: ecs.c5.large
          SystemDiskCategory: cloud_essd
          SecurityGroupId:
            Ref: SecurityGroupId
          VSwitchId:
            Ref: VSwitchId
    Outputs: {}
  • JSON格式

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Description": "Test ECS LaunchTemplate",
      "Parameters": {
        "VSwitchId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId"
        },
        "SecurityGroupId": {
          "AssociationProperty": "ALIYUN::ECS::SecurityGroup::SecurityGroupId",
          "Type": "String"
        }
      },
      "Resources": {
        "LaunchTemplate": {
          "Type": "ALIYUN::ECS::LaunchTemplate",
          "Properties": {
            "LaunchTemplateName": "mytest",
            "VersionDescription": "Test create LaunchTemplate",
            "ImageId": "centos_7",
            "InstanceType": "ecs.c5.large",
            "SystemDiskCategory": "cloud_essd",
            "SecurityGroupId": {
              "Ref": "SecurityGroupId"
            },
            "VSwitchId": {
              "Ref": "VSwitchId"
            }
          }
        }
      },
      "Outputs": {
      }
    }

更多示例,請(qǐng)參見創(chuàng)建ECS實(shí)例啟動(dòng)模板和創(chuàng)建彈性供應(yīng)組的組合示例:JSON示例YAML示例