ALIYUN::ECS::LaunchTemplate - Resource Orchestration Service

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

屬性

屬性名稱	類型	必須	允許更新	描述	約束
LaunchTemplateName	String	是	否	執行個體啟動模板名稱。	長度為2~128個字元。必須以英文字母或漢字開頭，不能以`http://`和`https://`開頭。可包含英文字母、漢字、數字、半形冒號（:）、底線（_）和短劃線（-）。
VersionDescription	String	否	否	執行個體啟動模板版本描述。	長度為2~128個字元。必須以英文字母或漢字開頭，不能以`http://`和`https://`開頭。
ImageId	String	否	否	鏡像ID。	無
InstanceType	String	否	否	執行個體類型。	無
SecurityGroupId	String	否	否	安全性群組ID。	無
NetworkType	String	否	否	執行個體網路類型。	取值： classic：傳統網路。 vpc：專用網路。
VSwitchId	String	否	否	交換器ID。	當NetworkType取值為`vpc`時該參數有效。
InstanceName	String	否	否	執行個體名稱。	長度為2~128個字元。必須以英文字母或漢字開頭，不能以`http://`和`https://`開頭。
Description	String	否	否	執行個體描述。	長度為2~128個字元。必須以英文字母或漢字開頭，不能以`http://`和`https://`開頭。
InternetMaxBandwidthOut	Integer	否	否	公網出網頻寬最大值。	取值範圍：0~100。單位：Mbps。
HostName	String	否	否	執行個體主機名稱。	英文句點（.）和短劃線（-）不能作為首尾字元，也不能連續使用。取值要求： Windows執行個體：長度為2~15個字元。不能全是數字。可包含英文字母、數字和短劃線（-）。其他類型執行個體（Linux等）：長度為2~64個字元。可包含英文字母、數字和短劃線（-）。
ZoneId	String	否	否	執行個體所屬的可用性區域ID。	無
SystemDiskCategory	String	否	否	系統硬碟類型。	取值： cloud：普通雲端硬碟。 cloud_efficiency：高效雲端硬碟。 cloud_ssd：SSD雲端硬碟。 ephemeral_ssd：本地SSD盤。
SystemDiskSize	Number	否	否	系統硬碟大小。	取值範圍：20~500。單位：GB。
SystemDiskDiskName	String	否	否	系統硬碟名稱。	長度為2~128個字元。必須以英文字母或漢字開頭，不能以`http://`和`https://`開頭。可包含英文字母、漢字、數字、半形冒號（:）、底線（_）和短劃線（-）。
SystemDiskDescription	String	否	否	系統硬碟描述。	長度為2~256個字元，不能以`http://`和`https://`開頭。
IoOptimized	String	否	否	是否為I/O最佳化執行個體。	取值： none：非I/O最佳化執行個體。 optimized：I/O最佳化執行個體。
InternetChargeType	String	否	否	網路付費類型。	取值： PayByBandwidth：按頻寬計費。 PayByTraffic：按流量計費。
UserData	String	否	否	執行個體自訂資料。	需要以Base64方式編碼，未經處理資料不超過16KB。
KeyPairName	String	否	否	金鑰組名稱。	僅Linux執行個體需要指定該參數，此時密碼登入方式會被初始化為禁止。
RamRoleName	String	否	否	執行個體RAM角色名稱。	無
AutoReleaseTime	String	否	否	執行個體自動釋放時間。	按照ISO8601標準表示。需要使用UTC時間，格式為`yyyy-MM-ddTHH:mm:ssZ`。
SpotStrategy	String	否	否	後付費執行個體的搶佔策略。	當InstanceChargeType參數取值為PostPaid時該參數生效。取值： NoSpot：正常隨用隨付執行個體。 SpotWithPriceLimit：設定上限價格的搶佔式執行個體。 SpotAsPriceGo：系統自動出價，最高隨用隨付價格。
SpotPriceLimit	String	否	否	設定執行個體的每小時最高價格。	支援最多3位小數。
SecurityEnhancementStrategy	String	否	否	是否開啟安全強化。	取值： Active：開啟。 Deactive：關閉。
DiskMappings	List	否	否	資料盤列表。	最多支援16個資料盤。更多資訊，請參見DiskMappings屬性。
NetworkInterfaces	List	否	否	彈性網卡列表。	最多支援8個彈性網卡。更多資訊，請參見NetworkInterfaces屬性。
Tags	List	否	否	執行個體、安全性群組、磁碟和網卡的標籤列表。	最多支援20個標籤。更多資訊，請參見Tags屬性。
TemplateTags	List	否	否	啟動模板的標籤列表。	最多支援20個標籤。更多資訊，請參見TemplateTags屬性。
TemplateResourceGroupId	String	否	否	啟動模板所在的資源群組ID。	無
SecurityGroupIds	List	否	否	執行個體加入的一個或多個安全性群組。	取值與執行個體能夠加入的安全性群組配額有關。說明不支援同時指定SecurityGroupId和SecurityGroupIds。
ResourceGroupId	String	否	否	執行個體、Block Storage和彈性網卡所在的資源群組ID。	無
SpotDuration	Integer	否	否	搶佔式執行個體的保留時間長度。	取值範圍：0~6。預設值：1。單位：小時。說明如需設定取值為2~6，請提交工單。
ImageOwnerAlias	String	否	否	鏡像來源。	取值範圍： system：阿里雲提供的公用鏡像。 self：您建立的自訂鏡像。 others：其他阿里雲使用者共用給您的鏡像。 marketplace：鏡像市場。
Period	Integer	否	否	購買資源的時間長度。	InstanceChargeType取值為PrePaid時該參數有效，且必須指定。取值：1~9、12、24、36、48、60。單位：月。
Ipv6AddressCount	Integer	否	否	為主網卡指定隨機產生的IPv6地址數量。	取值範圍：1~10。
PrivateIpAddress	String	否	否	執行個體私網IP地址。	Virtual Private Cloud類型ECS執行個體設定私網IP地址時，必須從交換器的空閑網段中選擇。
PasswordInherit	Boolean	否	否	是否使用鏡像預設的密碼。	取值： true：使用。 false：不使用。說明 PasswordInherit和Password必須且只能指定其中一個參數。
SystemDiskDeleteWithInstance	Boolean	否	否	系統硬碟是否隨執行個體釋放。	取值： true（預設）：釋放。 false：不釋放。
DeploymentSetId	String	否	否	部署集ID。	無
InstanceChargeType	String	否	否	執行個體的計費方式。	取值： PrePaid：預付費，訂用帳戶。 PostPaid：後付費，按實際使用量付費。
SystemDiskPerformanceLevel	String	否	否	建立ESSD雲端硬碟作為系統硬碟使用時，雲端硬碟的效能等級。	取值： PL0（預設）：單盤最高隨機讀寫IOPS 1萬。 PL1：單盤最高隨機讀寫IOPS 5萬。 PL2：單盤最高隨機讀寫IOPS 10萬。 PL3：單盤最高隨機讀寫IOPS 100萬。

DiskMappings文法

"DiskMappings": [
  {
    "Category": String,
    "DiskName": String,
    "Description": String,
    "SnapshotId": String,
    "Size": String,
    "Encrypted": String,
    "DeleteWithInstance": String,
    "PerformanceLevel": 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	否	否	系統硬碟大小。	取值範圍： cloud：5~2000。 cloud_efficiency：20~32768。 cloud_ssd：20~32768。 ephemeral_ssd：5~800。單位：GB。
Encrypted	Boolean	否	否	是否加密資料盤。	取值： true：加密。 false：不加密。
DeleteWithInstance	Boolean	否	否	資料盤是否隨執行個體釋放而釋放。	取值： true：釋放。 false：不釋放。
PerformanceLevel	String	否	否	建立ESSD雲端硬碟作為資料盤使用時，雲端硬碟的效能等級。	取值： PL0（預設）：單盤最高隨機讀寫IOPS 1萬。 PL1：單盤最高隨機讀寫IOPS 5萬。 PL2：單盤最高隨機讀寫IOPS 10萬。 PL3：單盤最高隨機讀寫IOPS 100萬。

NetworkInterfaces文法

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

NetworkInterfaces屬性

屬性名稱	類型	必須	允許更新	描述	約束
PrimaryIpAddress	String	否	否	彈性網卡的主私人IP地址。	無
VSwitchId	String	否	否	彈性網卡所屬的交換器ID。	無
SecurityGroupId	String	否	否	彈性網卡所屬的安全性群組ID。	無
NetworkInterfaceName	String	否	否	彈性網卡名稱。	無
Description	String	否	否	彈性網卡描述資訊。	長度為2~256個字元，不能以`http://`和`https://`開頭。

Tags文法

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

Tags屬性

屬性名稱	類型	必須	允許更新	描述	約束
Key	String	否	否	標籤鍵。	長度為1~128個字元，不能以`aliyun`和`acs:`開頭，不能包含`http://`或者`https://` 。
Value	String	否	否	標籤值。	長度為0~128個字元，不能以`aliyun`和`acs:`開頭，不能包含`http://`或者`https://` 。

TemplateTags文法

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

TemplateTags屬性

屬性名稱	類型	必須	允許更新	描述	約束
Key	String	否	否	標籤鍵。	長度為1~128個字元，不能以`aliyun`和`acs:`開頭，不能包含`http://`或者`https://` 。
Value	String	否	否	標籤值。	長度為0~128個字元，不能以`aliyun`和`acs:`開頭，不能包含`http://`或者`https://` 。

傳回值

Fn::GetAtt

LaunchTemplateId：執行個體啟動模板ID。
LaunchTemplateName：執行個體啟動模板名稱。
DefaultVersionNumber：執行個體啟動模板預設版本號碼。
LatestVersionNumber：執行個體啟動模板最新版本號碼。

樣本

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": {
  }
}

更多樣本，請參見建立ECS執行個體啟動模板和建立彈性供應組的組合樣本：JSON樣本和YAML樣本。