ALIYUN::ECS::InstanceGroup - Resource Types| Alibaba Cloud Documentation Center

ALIYUN::ECS::InstanceGroup is used to create a group of ECS instances that have the same configurations.

Syntax

{
  "Type": "ALIYUN::ECS::InstanceGroup",
  "Properties": {
    "DedicatedHostId": String,
    "ResourceGroupId": String,
    "SystemDiskDescription": String,
    "InstanceChargeType": String,
    "RamRoleName": String,
    "SystemDiskPerformanceLevel": String,
    "ImageId": String,
    "SystemDiskDiskName": String,
    "Tags": List,
    "HostName": String,
    "LaunchTemplateName": String,
    "VSwitchId": String,
    "Period": Number,
    "LaunchTemplateId": String,
    "DeletionProtection": "Boolean",
    "SecurityGroupIds": List,
    "SecurityEnhancementStrategy": String,
    "InternetChargeType": String,
    "InstanceName": String,
    "DeploymentSetId": String,
    "InternetMaxBandwidthOut": Integer,
    "VpcId": String,
    "LaunchTemplateVersion": String,
    "PeriodUnit": String,
    "AutoReleaseTime": String,
    "PrivateIpAddress": String,
    "Description": String,
    "DiskMappings": List,
    "SystemDiskSize": Number,
    "UserData": String,
    "AutoRenew": String,
    "Ipv6Addresses": List,
    "MaxAmount": Integer,
    "SystemDiskAutoSnapshotPolicyId": String,
    "Ipv6AddressCount": Integer,
    "NetworkType": String,
    "SpotPriceLimit": String,
    "InstanceType": String,
    "AllocatePublicIP": "Boolean",
    "SpotStrategy": String,
    "Password": String,
    "PasswordInherit": Boolean,
    "AutoRenewPeriod": Number,
    "KeyPairName": String,
    "IoOptimized": String,
    "ZoneId": String,
    "HpcClusterId": String,
    "SecurityGroupId": String,
    "SystemDiskCategory": String,
    "EniMappings": List,
    "InternetMaxBandwidthIn": Integer
  }
}

Properties


Property	Type	Required	Editable	Description	Constraint
ResourceGroupId	String	No	Yes	The ID of the resource group to which the instance belongs.	None
HpcClusterId	String	No	Yes	The ID of the HPC cluster to which the instance belongs.	Updates of this parameter take effect only for added ECS instances.
MaxAmount	Integer	Yes	Yes	The maximum number of instances that can be created at a time.	Valid values: 1 to 1000. Note If you increase or decrease the MaxAmount value when you update the stack that references this resource type, the number of ECS instances is increased or decreased based on the new value. For example, if you increase the MaxAmount value from 2 to 5, three ECS instances are added.
Description	String	No	Yes	The description of the instance.	The description can be up to 256 characters in length. Note Updates of this parameter take effect only for added ECS instances.
InstanceType	String	Yes	Yes	The instance type.	For more information, see Instance family.
ImageId	String	Yes	Yes	The ID of the image that is used to start the instance. You can use a public image, a custom image, or an Alibaba Cloud Marketplace image.	You can specify a partial public image ID instead of providing the complete ID. Examples: If you enter ubuntu, the system matches it with the following ID: ubuntu_16_0402_64_20G_alibase_20170818.vhd If you enter ubuntu1432, the system matches it with the following ID: ubuntu_14_0405_32_40G_alibase_20170711.vhd For more information, see Request parameters.
SecurityGroupId	String	No	No	The ID of the security group to which the instance belongs. Instances in the same security group can communicate with each other.	You cannot specify both the SecurityGroupId and SecurityGroupIds parameters.
SecurityGroupIds	List	No	No	The IDs of multiple security groups to which the instance belongs.	You cannot specify both the SecurityGroupId and SecurityGroupIds parameters. For more information, see Security group limits.
SecurityEnhancementStrategy	String	No	No	Specifies whether to enable security hardening.	Valid values: Active: enables security hardening. This value is applicable only to public images. Deactive: disables security hardening. This value is applicable to all image types.
InstanceName	String	No	No	The name of the instance.	The name can be up to 128 characters in length. It can contain letters, digits, underscores (_), periods (.), and hyphens (-). The instance name must be in the `name_prefix[begin_number,bits]name_suffix` format. For more information, see Request parameters .
Password	String	No	Yes	The password that is used to log on to the instance.	The password must be 8 to 30 characters in length. The password must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Special characters include : ( ) ` ~ ! @ # $ % ^ & * - + = \| { } [ ] : ; ' < > , . ? /. If you specify this parameter in the API request, use HTTPS to secure the API and protect your password.
PasswordInherit	Boolean	No	No	Specifies whether to use the preset password of the image.	Valid values: true: uses the preset password. false: does not use the preset password. Note If you set the PasswordInherit parameter to true, leave the Password parameter empty and make sure that the selected image has a preset password.
HostName	String	No	No	The hostname of the instance.	The hostname must be at least 2 characters in length. It cannot contain consecutive periods (.) or hyphens (-). It cannot start or end with a period (.) or a hyphen (-). For more information, see Request parameters.
AllocatePublicIP	Boolean	No	No	Specifies whether to assign a public IP address to the instance.	If the InternetMaxBandwidthOut parameter is set to 0, no public IP address is assigned. Default value: true. Valid values: true false
AutoReleaseTime	String	No	No	The time scheduled for the instance to be automatically released.	Specify the time in the ISO 8601 standard in the `"yyyy-MM-ddTHH:mm:ssZ"` format. The time must be in UTC. The release time of the instance cannot be more than three years.
PrivateIpAddress	String	No	No	The private IP address of the instance.	To assign a private IP address to an instance of the Virtual Private Cloud (VPC) type, make sure that the IP address is an idle IP address within the CIDR block of the vSwitch. Note If you specify the PrivateIpAddress parameter, the MaxAmount parameter must be set to 1.
DiskMappings	List	No	Yes	The list of one or more data disks to be attached to the instance.	A maximum of 16 data disks can be specified. If you modify the value of this parameter, existing instances are not affected. The modified value takes effect for new instances. For more information, see DiskMappings properties. Note Updates of this parameter take effect only for added ECS instances.
InternetChargeType	String	No	No	The billing method for Internet usage.	Default value: PayByTraffic: Valid values: PayByBandwidth PayByTraffic
InternetMaxBandwidthIn	Integer	No	No	The maximum inbound public bandwidth.	Valid values: 1 to 100. Unit: Mbit/s. Default value: 100
InternetMaxBandwidthOut	Integer	No	No	The maximum outbound public bandwidth.	Valid values: 0 to 100. Unit: Mbit/s. Default value: 0.
IoOptimized	String	No	No	Specifies whether the instance is I/O optimized.	Default value: optimized. Valid values: none: The instance is not I/O optimized. optimized: The instance is I/O optimized.
SystemDiskCategory	String	No	Yes	The category of the system disk.	Valid values: cloud: basic disk cloud_efficiency: ultra disk cloud_ssd: standard SSD cloud_essd: enhanced SSD (ESSD) ephemeral_ssd: local SSD Note Updates of this parameter take effect only for added ECS instances.
SystemDiskDescription	String	No	Yes	The description of the system disk.	Updates of this parameter take effect only for added ECS instances.
SystemDiskDiskName	String	No	Yes	The name of the system disk.	Updates of this parameter take effect only for added ECS instances.
SystemDiskSize	Number	No	Yes	The size of the system disk.	Valid values: 40 to 500. Unit: GB If a custom image is used to create a system disk, make sure that the size of the system disk is larger than that of the custom image.
Tags	List	No	Yes	The custom tags of the instance.	A maximum of 20 tags can be specified in the `[{"Key":"tagKey","Value":"tagValue"},{"Key":"tagKey2","Value":"tagValue2"}]` format. For more information, see Tags properties.
UserData	String	No	Yes	The user data that you provide when you create the instance.	The user data can be up to 16 KB in size. You do not need to convert the data into Base64-encoded strings. If the data contains special characters, add a backslash (\) immediately before each special character.
ZoneId	String	No	No	The zone ID of the instance.	None
VpcId	String	No	No	The VPC ID of the instance.	None
VSwitchId	String	No	No	The vSwitch ID of the instance.	None
KeyPairName	String	No	Yes	The name of the key pair that is used to connect to the instance.	For a Windows instance, this parameter is ignored and is empty by default. For a Linux instance, the Password parameter still takes effect if this parameter is specified. However, logon by password is disabled and the KeyPairName value is used. Note Updates of this parameter take effect only for added ECS instances.
RamRoleName	String	No	Yes	The name of the Resource Access Management (RAM) role of the instance.	You can call the ListRoles operation to query the RAM role name. For more information, see CreateRole and ListRoles.
SpotPriceLimit	String	No	No	The maximum hourly price of the instance.	This parameter supports up to 3 decimal places. This parameter takes effect only when the SpotStrategy parameter is set to SpotWithPriceLimit.
SpotStrategy	String	No	No	The bidding policy for pay-as-you-go instances.	This parameter takes effect only when the InstanceChargeType parameter is set to PostPaid. Default value: NoSpot. Valid values: NoSpot: applies to regular pay-as-you-go instances. SpotWithPriceLimit: applies to preemptible instances with a maximum hourly price. SpotAsPriceGo: applies to preemptible instances that are billed at the market price at the time of purchase.
DedicatedHostId	String	No	No	The ID of the dedicated host.	None
LaunchTemplateName	String	No	Yes	The name of the launch template.	None
PeriodUnit	String	No	Yes	The unit of the subscription period.	Default value: Month. Valid values: Week Month Note Updates of this parameter take effect only for added ECS instances.
AutoRenewPeriod	Number	No	Yes	The auto-renewal period for the instance.	This parameter is required when the AutoRenew parameter is set to True. Default value: 1. Valid values: 1 2 3 6 12 Note Updates of this parameter take effect only for added ECS instances.
AutoRenew	String	No	Yes	Specifies whether to enable auto-renewal for the instance.	This parameter takes effect only when the InstanceChargeType parameter is set to PrePaid. Default value: False. Valid values: True: enables auto-renewal. False: disables auto-renewal. Note Updates of this parameter take effect only for added ECS instances.
InstanceChargeType	String	No	Yes	The billing method of the instance.	Default value: PostPaid. Valid values: PrePaid: subscription Note If this parameter is set to PrePaid, you must make sure that your payment account has sufficient balance or credit. Otherwise, an InvalidPayMethod error is returned. PostPaid: pay-as-you-go Note Updates of this parameter take effect only for added ECS instances.
EniMappings	List	No	Yes	The elastic network interface (ENI) to be bound to the instance.	Only one ENI can be bound to each instance. For more information, see EniMappings properties.
LaunchTemplateId	String	No	Yes	The ID of the launch template.	None
LaunchTemplateVersion	String	No	Yes	The version of the launch template.	If you do not specify a version, the default version is used.
Period	Number	No	Yes	The subscription period of the instance.	This parameter takes effect and is required when the InstanceChargeType parameter is set to PrePaid. If the DedicatedHostId parameter is specified, the value of this parameter must be within the subscription period of the dedicated host. Valid values when PeriodUnit is set to Week: 1, 2, 3, and 4. Valid values when PeriodUnit is set to Month: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, and 60. Note Updates of this parameter take effect only for added ECS instances.
NetworkType	String	No	No	The network type of the instance.	Default value: classic. Valid values: vpc classic
DeletionProtection	Boolean	No	No	The deletion protection property of the instance. It specifies whether to release the instance by using the ECS console or by calling the DeleteInstance operation.	Valid values: true false
DeploymentSetId	String	No	Yes	The ID of the deployment set.	Updates of this parameter take effect only for added ECS instances.
Ipv6AddressCount	Integer	No	Yes	The number of randomly generated IPv6 addresses that are assigned to the ENI.	You cannot specify both the Ipv6Addresses and Ipv6AddressCount parameters. Note Updates of this parameter take effect only for added ECS instances.
Ipv6Addresses	List	No	Yes	The IPv6 address assigned to the ENI.	Only one IPv6 address can be specified. Modification of this parameter does not affect existing instances. You cannot specify both the Ipv6Addresses and Ipv6AddressCount parameters. Note Updates of this parameter take effect only for added ECS instances.
SystemDiskAutoSnapshotPolicyId	String	No	Yes	The ID of the automatic snapshot policy for the system disk.	None
SystemDiskPerformanceLevel	String	No	No	The performance level of the ESSD that is used as the system disk.	Default value: PL1. Valid values: PL1: A single ESSD delivers up to 50,000 random read/write IOPS. PL2: A single ESSD delivers up to 100,000 random read/write IOPS. PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS. For more information about the performance levels of ESSDs, see ESSDs.

DiskMappings syntax

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

DiskMappings properties


Property	Type	Required	Editable	Description	Constraint
Size	String	Yes	No	The size of the data disk.	Unit: GB.
Category	String	No	No	The category of the data disk.	Valid values: cloud: basic disk cloud_efficiency: ultra disk cloud_ssd: SSD cloud_essd: ESSD ephemeral_ssd: local SSD For I/O optimized instances, the default value is cloud_efficiency. For non-I/O optimized instances, the default value is cloud.
DiskName	String	No	No	The name of the data disk.	The name must be 2 to 128 characters in length. It must start with a letter and cannot start with `http://` or `https://`. The description can contain letters, digits, underscores (_), colons (:), and hyphens (-).
Description	String	No	No	The description of the data disk.	The description must be 2 to 256 characters in length. It cannot start with `http://` or `https://`.
Device	String	No	No	The name of the device on which the data disk is mounted.	Note This parameter will be removed in the future. We recommend that you use other parameters to ensure future compatibility.
SnapshotId	String	No	No	The ID of the snapshot.	None
Encrypted	String	No	No	Specifies whether to encrypt the data disk.	Default value: false. Valid values: true false
KMSKeyId	String	No	No	The ID of the Key Management Service (KMS) key corresponding to the data disk.	None
AutoSnapshotPolicyId	String	No	No	The ID of the automatic snapshot policy.	None
PerformanceLevel	String	No	No	The performance level of the ESSD that is used as the data disk.	Default value: PL1. Valid values: PL1: A single ESSD delivers up to 50,000 random read/write IOPS. PL2: A single ESSD delivers up to 100,000 random read/write IOPS. PL3: A single ESSD delivers up to 1,000,000 random read/write IOPS. For more information about the performance levels of ESSDs, see ESSDs.

Tags syntax

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

Tags properties


Property	Type	Required	Editable	Description	Constraint
Key	String	Yes	No	The tag key.	The tag key must be 1 to 128 characters in length and cannot contain `http://` or `https://`. It cannot start with `acs:` or `aliyun`.
Value	String	No	No	The tag value.	The tag value can be 0 to 128 characters in length and cannot contain `http://` or `https://`. It cannot start with `acs:` or `aliyun`.

EniMappings syntax

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

EniMappings properties


Property	Type	Required	Editable	Description	Constraint
SecurityGroupId	String	Yes	Yes	The ID of the security group.	The security group and the instance must be in the same VPC.
VSwitchId	String	Yes	No	The ID of the vSwitch	None
Description	String	No	Yes	The description of the ENI.	The description must be 2 to 256 characters in length. It cannot start with `http://` or `https://`.
NetworkInterfaceName	String	No	Yes	The name of the ENI.	The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with `http://` or `https://`. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).
PrimaryIpAddress	String	No	No	The primary private IP address of the ENI.	The IP address must be an idle IP address within the CIDR block of the vSwitch. If this parameter is not specified, an idle IP address within the CIDR block of the vSwitch is assigned at random.

Response parameters

Fn::GetAtt

InstanceIds: the IDs of one or more instances. An instance ID is a system-generated globally unique identifier (GUID) for an instance.
PrivateIps: the private IP addresses of one or more VPC-type instances. This parameter takes effect only when the NetworkType parameter is set to vpc. Example: ["172.16.XX.XX", "172.16.XX.XX", …"172.16.XX.XX"]. In this example, the list is a JSON array that can contain up to 100 IP addresses separated with commas (,).
InnerIps: the private IP addresses of one or more classic network-type instances. This parameter takes effect only when the NetworkType parameter is set to classic. Example: ["10.1.XX.XX", "10.1.XX.XX", … "10.1.XX.XX"]. In this example, the list is a JSON array that can contain up to 100 IP addresses separated with commas (,).
PublicIps: the public IP addresses of one or more classic network-type instances. This parameter takes effect only when the NetworkType parameter is set to classic. Example: ["42.1.XX.XX", "42.1.XX.XX", … "42.1.XX.XX"]. In this example, the list is a JSON array that can contain up to 100 IP addresses separated with commas (,).
HostNames: the list of hostnames of all instances.
OrderId: the order IDs of one or more instances.
ZoneIds: the zone IDs of one or more instances.
Ipv6AddressIds: the IDs of IPv6 addresses of one or more instances. Note that the IPv6 address IDs are displayed in a list with two layers. If an instance does not have any IPv6 address, the element at the corresponding position in the list is empty. If none of the instances have any IP address, null is returned.
Ipv6Addresses: the IPv6 addresses of one or more instances. Note that the IPv6 addresses are displayed in a list with two layers. If an instance does not have any IPv6 address, the element at the corresponding position in the list is empty. If none of the instances have any IP address, null is returned.

Examples

JSON format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "DedicatedHostId": {
      "Type": "String",
      "Description": "which dedicated host will be deployed"
    },
    "ResourceGroupId": {
      "Type": "String",
      "Description": "Resource group id."
    },
    "SystemDiskDescription": {
      "Type": "String",
      "Description": "Description of created system disk. Old instances will not be changed."
    },
    "InstanceChargeType": {
      "Type": "String",
      "Description": "Instance Charge type, allowed value: Prepaid and Postpaid. If specified Prepaid, please ensure you have sufficient balance in your account. Or instance creation will be failure. Default value is Postpaid.Old instances will not be changed.",
      "AllowedValues": [
        "Subscription",
        "PrePaid",
        "PrePay",
        "Prepaid",
        "PayAsYouGo",
        "PostPaid",
        "PayOnDemand",
        "Postpaid"
      ],
      "Default": "PostPaid"
    },
    "RamRoleName": {
      "Type": "String",
      "Description": "Instance RAM role name. The name is provided and maintained by Resource Access Management (RAM) and can be queried using ListRoles. For more information, see RAM API CreateRole and ListRoles."
    },
    "SystemDiskPerformanceLevel": {
      "Type": "String",
      "Description": "The performance level of the enhanced SSD used as the system disk. Default value: PL1. Valid values:PL0: A single enhanced SSD delivers up to 10,000 random read/write IOPS.PL1: A single enhanced SSD delivers up to 50,000 random read/write IOPS.PL2: A single enhanced SSD delivers up to 100,000 random read/write IOPS.PL3: A single enhanced SSD delivers up to 1,000,000 random read/write IOPS."
    },
    "ImageId": {
      "Type": "String",
      "Description": "Image ID to create ecs instance."
    },
    "SystemDiskDiskName": {
      "Type": "String",
      "Description": "Name of created system disk. Old instances will not be changed."
    },
    "Tags": {
      "Type": "Json",
      "Description": "Tags to attach to instance. Max support 20 tags to add during create instance. Each tag with two properties Key and Value, and Key is required.",
      "MaxLength": 20
    },
    "HostName": {
      "Type": "String",
      "Description": "Host name of created ecs instance. at least 2 characters, and '.' '-' Is not the first and last characters as hostname, not continuous use. Windows platform can be up to 15 characters, allowing letters (without limiting case), numbers and '-', and does not support the number of points, not all is digital ('.').Other (Linux, etc.) platform up to 30 characters, allowing support number multiple points for the period between the points, each permit letters (without limiting case), numbers and '-' components. \nSupport to use the regular expression to set the different instance name for each ECS instance. HostName could be specified as 'name_prefix[begin_number,bits]name_suffix', such as 'host[123,4]tail'. If you creates 3 instances with hostname 'host[123,4]tail', all the host names of instances are host0123tail, host0124tail, host0125tail. The 'name_prefix[begin_number,bits]name_suffix' should follow those rules: \n1. 'name_prefix' is required. \n2. 'name_suffix' is optional. \n3. The name regular expression can't include any spaces. \n4. The 'bits' must be in range [1, 6]. \n5. The 'begin_number' must be in range [0, 999999]. \n6. You could only specify 'begin_number'. The 'bits' will be set as 6 by default. \n7. You also could only specify the [] or [,]. The 'begin_number' will be set as 0 by default, the 'bits' will be set as 6 by default. \n8. If the bits of 'begin_number' is less than the 'bits' you specified, like [1234,1], the 'bits' will be set as 6 by default. \nThe host name is specified by regular expression works after restart instance manually."
    },
    "LaunchTemplateName": {
      "Type": "String",
      "Description": "Name of launch template. Launch template id or name must be specified to use launch template"
    },
    "VSwitchId": {
      "Type": "String",
      "Description": "The vSwitch Id to create ecs instance."
    },
    "Period": {
      "Type": "Number",
      "Description": "Prepaid time period. Unit is month, it could be from 1 to 9 or 12, 24, 36, 48, 60. Default value is 1. Old instances will not be changed.",
      "AllowedValues": [
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        12,
        24,
        36,
        48,
        60
      ],
      "Default": 1
    },
    "LaunchTemplateId": {
      "Type": "String",
      "Description": "ID of launch template. Launch template id or name must be specified to use launch template"
    },
    "DeletionProtection": {
      "Type": "Boolean",
      "Description": "Whether an instance can be released manually through the console or API, deletion protection only support postPaid instance",
      "AllowedValues": [
        "True",
        "true",
        "False",
        "false"
      ]
    },
    "SecurityGroupIds": {
      "Type": "CommaDelimitedList",
      "Description": "The IDs of security groups N to which the instance belongs. The valid values of N are based on the maximum number of security groups to which an instance can belong. For more information, see Security group limits.Note: You cannot specify both SecurityGroupId and SecurityGroupIds at the same time."
    },
    "InternetChargeType": {
      "Type": "String",
      "Description": "Instance internet access charge type.Support 'PayByBandwidth' and 'PayByTraffic' only. Default is PayByTraffic",
      "AllowedValues": [
        "paybytraffic",
        "PayByTraffic",
        "paybybandwidth",
        "PayByBandwidth"
      ],
      "Default": "PayByTraffic"
    },
    "InstanceName": {
      "Type": "String",
      "Description": "Display name of the instance, [2, 128] English or Chinese characters, must start with a letter or Chinese in size, can contain numbers, '_' or '.', '-'. \nSupport to use the regular expression to set the different instance name for each ECS instance. InstanceName could be specified as 'name_prefix[begin_number,bits]name_suffix', such as 'testinstance[123,4]tail'. If you creates 3 instances with the instance name 'testinstance[123,4]tail', all the instances' names are testinstance0123tail, testinstance0124tail, testinstance0125tail. \nThe 'name_prefix[begin_number,bits]name_suffix' should follow those rules: \n1. 'name_prefix' is required. \n2. 'name_suffix' is optional. \n3. The name regular expression can't include any spaces. \n4. The 'bits' must be in range [1, 6]. \n5. The 'begin_number' must be in range [0, 999999]. \n6. You could only specify 'begin_number'. The 'bits' will be set as 6 by default. \n7. You also could only specify the [] or [,]. The 'begin_number' will be set as 0 by default, the 'bits' will be set as 6 by default. \n8. If the bits of 'begin_number' is less than the 'bits' you specified, like [1234,1], the 'bits' will be set as 6 by default."
    },
    "DeploymentSetId": {
      "Type": "String",
      "Description": "Deployment set ID. The change of the property does not affect existing instances."
    },
    "InternetMaxBandwidthOut": {
      "Type": "Number",
      "Description": "Set internet output bandwidth of instance. Unit is Mbps(Mega bit per second). Range is [0,200]. Default is 1.While the property is not 0, public ip will be assigned for instance.",
      "MinValue": 0,
      "MaxValue": 200,
      "Default": 1
    },
    "VpcId": {
      "Type": "String",
      "Description": "The VPC id to create ecs instance."
    },
    "LaunchTemplateVersion": {
      "Type": "String",
      "Description": "Version of launch template. Default version is used if version is not specified.",
      "AllowedPattern": "^[1-9]\\d*$"
    },
    "SecurityEnhancementStrategy": {
      "Type": "String",
      "Description": "",
      "AllowedValues": [
        "Active",
        "Deactive"
      ]
    },
    "AutoReleaseTime": {
      "Type": "String",
      "Description": "Auto release time for created instance, Follow ISO8601 standard using UTC time. format is 'yyyy-MM-ddTHH:mm:ssZ'. Not bigger than 3 years from this day onwards"
    },
    "PeriodUnit": {
      "Type": "String",
      "Description": "Unit of prepaid time period, it could be Week/Month. Default value is Month. Old instances will not be changed.",
      "AllowedValues": [
        "Week",
        "Month"
      ],
      "Default": "Month"
    },
    "PrivateIpAddress": {
      "Type": "String",
      "Description": "Private IP for the instance created. Only works for VPC instance and cannot duplicated with existing instance."
    },
    "Description": {
      "Type": "String",
      "Description": "Description of the instance, [2, 256] characters. Do not fill or empty, the default is empty. Old instances will not be changed."
    },
    "DiskMappings": {
      "Type": "Json",
      "Description": "Disk mappings to attach to instance. Max support 16 disks.\nIf the image contains a data disk, you can specify other parameters of the data disk via the same value of parameter \"Device\". If parameter \"Category\" is not specified, it will be cloud_efficiency instead of \"Category\" of data disk in the image. Old instances will not be changed.",
      "MaxLength": 16
    },
    "UserData": {
      "Type": "String",
      "Description": "User data to pass to instance. [1, 16KB] characters. User data should not be base64 encoded. If you want to pass base64 encoded string to the property, use function Fn::Base64Decode to decode the base64 string first."
    },
    "SystemDiskSize": {
      "Type": "Number",
      "Description": "Disk size of the system disk, range from 20 to 500 GB. If you specify with your own image, make sure the system disk size bigger than image size. ",
      "MinValue": 20
    },
    "AutoRenew": {
      "Type": "String",
      "Description": "Whether renew the fee automatically? When the parameter InstanceChargeType is PrePaid, it will take effect. Range of value:True: automatic renewal.False: no automatic renewal. Default value is False.Old instances will not be changed.",
      "AllowedValues": [
        "True",
        "False"
      ],
      "Default": "False"
    },
    "Ipv6Addresses": {
      "Type": "CommaDelimitedList",
      "Description": "Specify one or more IPv6 addresses for the elastic NIC. Currently, the maximum list size is 1. Example value: 2001:db8:1234:1a00::*** .\nNote You cannot specify the parameters Ipv6Addresses and Ipv6AddressCount at the same time.\nThe change of the property does not affect existing instances.",
      "MaxLength": 1
    },
    "MaxAmount": {
      "Type": "Number",
      "Description": "Max number of instances to create, should be bigger than 'MinAmount' and smaller than 1000.",
      "MinValue": 0,
      "MaxValue": 1000
    },
    "SystemDiskAutoSnapshotPolicyId": {
      "Type": "String",
      "Description": "Auto snapshot policy ID."
    },
    "NetworkType": {
      "Type": "String",
      "Description": "Instance network type. Support 'vpc' and 'classic', for compatible reason, default is 'classic'. If vswitch id and vpc id is specified, the property will be forced to be set to 'vpc'  ",
      "AllowedValues": [
        "vpc",
        "classic"
      ],
      "Default": "classic"
    },
    "Ipv6AddressCount": {
      "Type": "Number",
      "Description": "Specifies the number of randomly generated IPv6 addresses for the elastic NIC.\nNote You cannot specify the parameters Ipv6Addresses and Ipv6AddressCount at the same time.\nThe change of the property does not affect existing instances.",
      "MinValue": 0
    },
    "SpotPriceLimit": {
      "Type": "String",
      "Description": "The hourly price threshold of a instance, and it takes effect only when parameter InstanceChargeType is PostPaid. Three decimals is allowed at most. "
    },
    "InstanceType": {
      "Type": "String",
      "Description": "Ecs instance supported instance type, make sure it should be correct."
    },
    "AllocatePublicIP": {
      "Type": "Boolean",
      "Description": "The public ip for ecs instance, if properties is true, will allocate public ip. If property InternetMaxBandwidthOut set to 0, it will not assign public ip.",
      "AllowedValues": [
        "True",
        "true",
        "False",
        "false"
      ],
      "Default": true
    },
    "SpotStrategy": {
      "Type": "String",
      "Description": "The spot strategy of a Pay-As-You-Go instance, and it takes effect only when parameter InstanceChargeType is PostPaid. Value range: \"NoSpot: A regular Pay-As-You-Go instance\", \"SpotWithPriceLimit: A price threshold for a spot instance, \"\"SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go instance. \"Default value: NoSpot.",
      "AllowedValues": [
        "NoSpot",
        "SpotWithPriceLimit",
        "SpotAsPriceGo"
      ]
    },
    "PasswordInherit": {
      "Type": "Boolean",
      "Description": "Specifies whether to use the password preset in the image. To use the PasswordInherit parameter, the Password parameter must be empty and you must make sure that the selected image has a password configured.",
      "AllowedValues": [
        "True",
        "true",
        "False",
        "false"
      ]
    },
    "Password": {
      "Type": "String",
      "Description": "Password of created ecs instance. Must contain at least 3 types of special character, lower character, upper character, number."
    },
    "AutoRenewPeriod": {
      "Type": "Number",
      "Description": "The time period of auto renew. When the parameter InstanceChargeType is PrePaid, it will take effect. It could be 1, 2, 3, 6, 12. Default value is 1.Old instances will not be changed.",
      "AllowedValues": [
        1,
        2,
        3,
        6,
        12
      ],
      "Default": 1
    },
    "KeyPairName": {
      "Type": "String",
      "Description": "SSH key pair name. Old instances will not be changed."
    },
    "IoOptimized": {
      "Type": "String",
      "Description": "The 'optimized' instance can provide better IO performance. Support 'none' and 'optimized' only, default is 'optimized'.",
      "AllowedValues": [
        "none",
        "optimized"
      ],
      "Default": "optimized"
    },
    "ZoneId": {
      "Type": "String",
      "Description": "The ID of the zone to which the instance belongs. For more information, \ncall the DescribeZones operation to query the most recent zone list. \nDefault value is empty, which means random selection."
    },
    "HpcClusterId": {
      "Type": "String",
      "Description": "The HPC cluster ID to which the instance belongs. The change of the property does not affect existing instances."
    },
    "SecurityGroupId": {
      "Type": "String",
      "Description": "Security group to create ecs instance. For classic instance need the security group not belong to VPC, for VPC instance, please make sure the security group belong to specified VPC."
    },
    "SystemDiskCategory": {
      "Type": "String",
      "Description": "Category of system disk. Default is cloud_efficiency. support cloud|cloud_efficiency|cloud_ssd|cloud_essd|ephemeral_ssd.Old instances will not be changed.",
      "AllowedValues": [
        "cloud",
        "cloud_efficiency",
        "cloud_ssd",
        "cloud_essd",
        "ephemeral_ssd"
      ],
      "Default": "cloud_efficiency"
    },
    "EniMappings": {
      "Type": "Json",
      "Description": "NetworkInterface to attach to instance. Max support 1 ENI.",
      "MaxLength": 1
    },
    "InternetMaxBandwidthIn": {
      "Type": "Number",
      "Description": "Max internet out band width setting, unit in Mbps(Mega bit per second). The range is [1,200], default is 200 Mbps.",
      "MinValue": 1,
      "MaxValue": 200,
      "Default": 200
    }
  },
  "Resources": {
    "InstanceGroup": {
      "Type": "ALIYUN::ECS::InstanceGroup",
      "Properties": {
        "DedicatedHostId": {
          "Ref": "DedicatedHostId"
        },
        "ResourceGroupId": {
          "Ref": "ResourceGroupId"
        },
        "SystemDiskDescription": {
          "Ref": "SystemDiskDescription"
        },
        "InstanceChargeType": {
          "Ref": "InstanceChargeType"
        },
        "RamRoleName": {
          "Ref": "RamRoleName"
        },
        "SystemDiskPerformanceLevel": {
          "Ref": "SystemDiskPerformanceLevel"
        },
        "ImageId": {
          "Ref": "ImageId"
        },
        "SystemDiskDiskName": {
          "Ref": "SystemDiskDiskName"
        },
        "Tags": {
          "Ref": "Tags"
        },
        "HostName": {
          "Ref": "HostName"
        },
        "LaunchTemplateName": {
          "Ref": "LaunchTemplateName"
        },
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "Period": {
          "Ref": "Period"
        },
        "LaunchTemplateId": {
          "Ref": "LaunchTemplateId"
        },
        "DeletionProtection": {
          "Ref": "DeletionProtection"
        },
        "SecurityGroupIds": {
          "Ref": "SecurityGroupIds"
        },
        "InternetChargeType": {
          "Ref": "InternetChargeType"
        },
        "InstanceName": {
          "Ref": "InstanceName"
        },
        "DeploymentSetId": {
          "Ref": "DeploymentSetId"
        },
        "InternetMaxBandwidthOut": {
          "Ref": "InternetMaxBandwidthOut"
        },
        "VpcId": {
          "Ref": "VpcId"
        },
        "LaunchTemplateVersion": {
          "Ref": "LaunchTemplateVersion"
        },
        "SecurityEnhancementStrategy": {
          "Ref": "SecurityEnhancementStrategy"
        },
        "AutoReleaseTime": {
          "Ref": "AutoReleaseTime"
        },
        "PeriodUnit": {
          "Ref": "PeriodUnit"
        },
        "PrivateIpAddress": {
          "Ref": "PrivateIpAddress"
        },
        "Description": {
          "Ref": "Description"
        },
        "DiskMappings": {
          "Ref": "DiskMappings"
        },
        "UserData": {
          "Ref": "UserData"
        },
        "SystemDiskSize": {
          "Ref": "SystemDiskSize"
        },
        "AutoRenew": {
          "Ref": "AutoRenew"
        },
        "Ipv6Addresses": {
          "Ref": "Ipv6Addresses"
        },
        "MaxAmount": {
          "Ref": "MaxAmount"
        },
        "SystemDiskAutoSnapshotPolicyId": {
          "Ref": "SystemDiskAutoSnapshotPolicyId"
        },
        "NetworkType": {
          "Ref": "NetworkType"
        },
        "Ipv6AddressCount": {
          "Ref": "Ipv6AddressCount"
        },
        "SpotPriceLimit": {
          "Ref": "SpotPriceLimit"
        },
        "InstanceType": {
          "Ref": "InstanceType"
        },
        "AllocatePublicIP": {
          "Ref": "AllocatePublicIP"
        },
        "SpotStrategy": {
          "Ref": "SpotStrategy"
        },
        "PasswordInherit": {
          "Ref": "PasswordInherit"
        },
        "Password": {
          "Ref": "Password"
        },
        "AutoRenewPeriod": {
          "Ref": "AutoRenewPeriod"
        },
        "KeyPairName": {
          "Ref": "KeyPairName"
        },
        "IoOptimized": {
          "Ref": "IoOptimized"
        },
        "ZoneId": {
          "Ref": "ZoneId"
        },
        "HpcClusterId": {
          "Ref": "HpcClusterId"
        },
        "SecurityGroupId": {
          "Ref": "SecurityGroupId"
        },
        "SystemDiskCategory": {
          "Ref": "SystemDiskCategory"
        },
        "EniMappings": {
          "Ref": "EniMappings"
        },
        "InternetMaxBandwidthIn": {
          "Ref": "InternetMaxBandwidthIn"
        }
      }
    }
  },
  "Outputs": {
    "PublicIps": {
      "Description": "Public IP address list of created ecs instances.",
      "Value": {
        "Fn::GetAtt": [
          "InstanceGroup",
          "PublicIps"
        ]
      }
    },
    "PrivateIps": {
      "Description": "Private IP address list of created ecs instances. Only for VPC instance.",
      "Value": {
        "Fn::GetAtt": [
          "InstanceGroup",
          "PrivateIps"
        ]
      }
    },
    "HostNames": {
      "Description": "Host names of created instances.",
      "Value": {
        "Fn::GetAtt": [
          "InstanceGroup",
          "HostNames"
        ]
      }
    },
    "InnerIps": {
      "Description": "Inner IP address list of the specified instances. Only for classical instances.",
      "Value": {
        "Fn::GetAtt": [
          "InstanceGroup",
          "InnerIps"
        ]
      }
    },
    "Ipv6AddressIds": {
      "Description": "IPv6 address IDs list of created ecs instances. Note: The return type is a two-tier list.If the instance does not have any IPv6 address, the element at the corresponding position in the list is null. If all instances does not have any IPv address, will return null.",
      "Value": {
        "Fn::GetAtt": [
          "InstanceGroup",
          "Ipv6AddressIds"
        ]
      }
    },
    "ZoneIds": {
      "Description": "Zone id of created instances.",
      "Value": {
        "Fn::GetAtt": [
          "InstanceGroup",
          "ZoneIds"
        ]
      }
    },
    "Ipv6Addresses": {
      "Description": "IPv6 addresses list of created ecs instances. Note: The return type is a two-tier list. If the instance does not have any IPv6 address, the element at the corresponding position in the list is null. If all instances does not have any IPv address, will return null.",
      "Value": {
        "Fn::GetAtt": [
          "InstanceGroup",
          "Ipv6Addresses"
        ]
      }
    },
    "OrderId": {
      "Description": "The order id list of created instance.",
      "Value": {
        "Fn::GetAtt": [
          "InstanceGroup",
          "OrderId"
        ]
      }
    },
    "InstanceIds": {
      "Description": "The instance id list of created ecs instances",
      "Value": {
        "Fn::GetAtt": [
          "InstanceGroup",
          "InstanceIds"
        ]
      }
    }
  }
}

YAML format

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  AllocatePublicIP:
    AllowedValues:
    - 'True'
    - 'true'
    - 'False'
    - 'false'
    Default: true
    Description: The public ip for ecs instance, if properties is true, will allocate
      public ip. If property InternetMaxBandwidthOut set to 0, it will not assign
      public ip.
    Type: Boolean
  AutoReleaseTime:
    Description: Auto release time for created instance, Follow ISO8601 standard using
      UTC time. format is 'yyyy-MM-ddTHH:mm:ssZ'. Not bigger than 3 years from this
      day onwards
    Type: String
  AutoRenew:
    AllowedValues:
    - 'True'
    - 'False'
    Default: 'False'
    Description: 'Whether renew the fee automatically? When the parameter InstanceChargeType
      is PrePaid, it will take effect. Range of value:True: automatic renewal.False:
      no automatic renewal. Default value is False. Old instances will not be changed.'
    Type: String
  AutoRenewPeriod:
    AllowedValues:
    - 1
    - 2
    - 3
    - 6
    - 12
    Default: 1
    Description: The time period of auto renew. When the parameter InstanceChargeType
      is PrePaid, it will take effect. It could be 1, 2, 3, 6, 12. Default value is
      1. Old instances will not be changed.
    Type: Number
  DedicatedHostId:
    Description: which dedicated host will be deployed
    Type: String
  DeletionProtection:
    AllowedValues:
    - 'True'
    - 'true'
    - 'False'
    - 'false'
    Description: Whether an instance can be released manually through the console
      or API, deletion protection only support postPaid instance
    Type: Boolean
  DeploymentSetId:
    Description: Deployment set ID. The change of the property does not affect existing
      instances.
    Type: String
  Description:
    Description: Description of the instance, [2, 256] characters. Do not fill or
      empty, the default is empty. Old instances will not be changed.
    Type: String
  DiskMappings:
    Description: 'Disk mappings to attach to instance. Max support 16 disks.

      If the image contains a data disk, you can specify other parameters of the data
      disk via the same value of parameter "Device". If parameter "Category" is not
      specified, it will be cloud_efficiency instead of "Category" of data disk in
      the image. Old instances will not be changed.'
    MaxLength: 16
    Type: Json
  EniMappings:
    Description: NetworkInterface to attach to instance. Max support 1 ENI.
    MaxLength: 1
    Type: Json
  HostName:
    Description: "Host name of created ecs instance. at least 2 characters, and '.'\
      \ '-' Is not the first and last characters as hostname, not continuous use.\
      \ Windows platform can be up to 15 characters, allowing letters (without limiting\
      \ case), numbers and '-', and does not support the number of points, not all\
      \ is digital ('.').Other (Linux, etc.) platform up to 30 characters, allowing\
      \ support number multiple points for the period between the points, each permit\
      \ letters (without limiting case), numbers and '-' components. \nSupport to\
      \ use the regular expression to set the different instance name for each ECS\
      \ instance. HostName could be specified as 'name_prefix[begin_number,bits]name_suffix',\
      \ such as 'host[123,4]tail'. If you creates 3 instances with hostname 'host[123,4]tail',\
      \ all the host names of instances are host0123tail, host0124tail, host0125tail.\
      \ The 'name_prefix[begin_number,bits]name_suffix' should follow those rules:\
      \ \n1. 'name_prefix' is required. \n2. 'name_suffix' is optional. \n3. The name\
      \ regular expression can't include any spaces. \n4. The 'bits' must be in range\
      \ [1, 6]. \n5. The 'begin_number' must be in range [0, 999999]. \n6. You could\
      \ only specify 'begin_number'. The 'bits' will be set as 6 by default. \n7.\
      \ You also could only specify the [] or [,]. The 'begin_number' will be set\
      \ as 0 by default, the 'bits' will be set as 6 by default. \n8. If the bits\
      \ of 'begin_number' is less than the 'bits' you specified, like [1234,1], the\
      \ 'bits' will be set as 6 by default. \nThe host name is specified by regular\
      \ expression works after restart instance manually."
    Type: String
  HpcClusterId:
    Description: The HPC cluster ID to which the instance belongs. The change of the
      property does not affect existing instances.
    Type: String
  ImageId:
    Description: Image ID to create ecs instance.
    Type: String
  InstanceChargeType:
    AllowedValues:
    - Subscription
    - PrePaid
    - PrePay
    - Prepaid
    - PayAsYouGo
    - PostPaid
    - PayOnDemand
    - Postpaid
    Default: PostPaid
    Description: 'Instance Charge type, allowed value: Prepaid and Postpaid. If specified
      Prepaid, please ensure you have sufficient balance in your account. Or instance
      creation will be failure. Default value is Postpaid. Old instances will not be
      changed.'
    Type: String
  InstanceName:
    Description: "Display name of the instance, [2, 128] English or Chinese characters,\
      \ must start with a letter or Chinese in size, can contain numbers, '_' or '.',\
      \ '-'. \nSupport to use the regular expression to set the different instance\
      \ name for each ECS instance. InstanceName could be specified as 'name_prefix[begin_number,bits]name_suffix',\
      \ such as 'testinstance[123,4]tail'. If you creates 3 instances with the instance\
      \ name 'testinstance[123,4]tail', all the instances' names are testinstance0123tail,\
      \ testinstance0124tail, testinstance0125tail. \nThe 'name_prefix[begin_number,bits]name_suffix'\
      \ should follow those rules: \n1. 'name_prefix' is required. \n2. 'name_suffix'\
      \ is optional. \n3. The name regular expression can't include any spaces. \n\
      4. The 'bits' must be in range [1, 6]. \n5. The 'begin_number' must be in range\
      \ [0, 999999]. \n6. You could only specify 'begin_number'. The 'bits' will be\
      \ set as 6 by default. \n7. You also could only specify the [] or [,]. The 'begin_number'\
      \ will be set as 0 by default, the 'bits' will be set as 6 by default. \n8.\
      \ If the bits of 'begin_number' is less than the 'bits' you specified, like\
      \ [1234,1], the 'bits' will be set as 6 by default."
    Type: String
  InstanceType:
    Description: Ecs instance supported instance type, make sure it should be correct.
    Type: String
  InternetChargeType:
    AllowedValues:
    - paybytraffic
    - PayByTraffic
    - paybybandwidth
    - PayByBandwidth
    Default: PayByTraffic
    Description: Instance internet access charge type. Support 'PayByBandwidth' and
      'PayByTraffic' only. Default is PayByTraffic
    Type: String
  InternetMaxBandwidthIn:
    Default: 200
    Description: Max internet out band width setting, unit in Mbps(Mega bit per second).
      The range is [1,200], default is 200 Mbps.
    MaxValue: 200
    MinValue: 1
    Type: Number
  InternetMaxBandwidthOut:
    Default: 1
    Description: Set internet output bandwidth of instance. Unit is Mbps(Mega bit
      per second). Range is [0,200]. Default is 1.While the property is not 0, public
      ip will be assigned for instance.
    MaxValue: 200
    MinValue: 0
    Type: Number
  IoOptimized:
    AllowedValues:
    - none
    - optimized
    Default: optimized
    Description: The 'optimized' instance can provide better IO performance. Support
      'none' and 'optimized' only, default is 'optimized'.
    Type: String
  Ipv6AddressCount:
    Description: 'Specifies the number of randomly generated IPv6 addresses for the
      elastic NIC.

      Note You cannot specify the parameters Ipv6Addresses and Ipv6AddressCount at
      the same time.

      The change of the property does not affect existing instances.'
    MinValue: 0
    Type: Number
  Ipv6Addresses:
    Description: 'Specify one or more IPv6 addresses for the elastic NIC. Currently,
      the maximum list size is 1. Example value: 2001:db8:1234:1a00::*** .

      Note You cannot specify the parameters Ipv6Addresses and Ipv6AddressCount at
      the same time.

      The change of the property does not affect existing instances.'
    MaxLength: 1
    Type: CommaDelimitedList
  KeyPairName:
    Description: SSH key pair name. Old instances will not be changed.
    Type: String
  LaunchTemplateId:
    Description: ID of launch template. Launch template id or name must be specified
      to use launch template
    Type: String
  LaunchTemplateName:
    Description: Name of launch template. Launch template id or name must be specified
      to use launch template
    Type: String
  LaunchTemplateVersion:
    AllowedPattern: ^[1-9]\d*$
    Description: Version of launch template. Default version is used if version is
      not specified.
    Type: String
  MaxAmount:
    Description: Max number of instances to create, should be bigger than 'MinAmount'
      and smaller than 1000.
    MaxValue: 1000
    MinValue: 0
    Type: Number
  NetworkType:
    AllowedValues:
    - vpc
    - classic
    Default: classic
    Description: 'Instance network type. Support ''vpc'' and ''classic'', for compatible
      reason, default is ''classic''. If vswitch id and vpc id is specified, the property
      will be forced to be set to ''vpc''  '
    Type: String
  Password:
    Description: Password of created ecs instance. Must contain at least 3 types of
      special character, lower character, upper character, number.
    Type: String
  PasswordInherit:
    AllowedValues:
    - 'True'
    - 'true'
    - 'False'
    - 'false'
    Description: Specifies whether to use the password preset in the image. To use
      the PasswordInherit parameter, the Password parameter must be empty and you
      must make sure that the selected image has a password configured.
    Type: Boolean
  Period:
    AllowedValues:
    - 1
    - 2
    - 3
    - 4
    - 5
    - 6
    - 7
    - 8
    - 9
    - 12
    - 24
    - 36
    - 48
    - 60
    Default: 1
    Description: Prepaid time period. Unit is month, it could be from 1 to 9 or 12,
      24, 36, 48, 60. Default value is 1.Old instances will not be changed.
    Type: Number
  PeriodUnit:
    AllowedValues:
    - Week
    - Month
    Default: Month
    Description: Unit of prepaid time period, it could be Week/Month. Default value
      is Month. Old instances will not be changed.
    Type: String
  PrivateIpAddress:
    Description: Private IP for the instance created. Only works for VPC instance
      and cannot duplicated with existing instance.
    Type: String
  RamRoleName:
    Description: Instance RAM role name. The name is provided and maintained by Resource
      Access Management (RAM) and can be queried using ListRoles. For more information,
      see RAM API CreateRole and ListRoles.
    Type: String
  ResourceGroupId:
    Description: Resource group id.
    Type: String
  SecurityEnhancementStrategy:
    AllowedValues:
    - Active
    - Deactive
    Description: ''
    Type: String
  SecurityGroupId:
    Description: Security group to create ecs instance. For classic instance need
      the security group not belong to VPC, for VPC instance, please make sure the
      security group belong to specified VPC.
    Type: String
  SecurityGroupIds:
    Description: 'The IDs of security groups N to which the instance belongs. The
      valid values of N are based on the maximum number of security groups to which
      an instance can belong. For more information, see Security group limits.Note:
      You cannot specify both SecurityGroupId and SecurityGroupIds at the same time.'
    Type: CommaDelimitedList
  SpotPriceLimit:
    Description: 'The hourly price threshold of a instance, and it takes effect only
      when parameter InstanceChargeType is PostPaid. Three decimals is allowed at
      most. '
    Type: String
  SpotStrategy:
    AllowedValues:
    - NoSpot
    - SpotWithPriceLimit
    - SpotAsPriceGo
    Description: 'The spot strategy of a Pay-As-You-Go instance, and it takes effect
      only when parameter InstanceChargeType is PostPaid. Value range: "NoSpot: A
      regular Pay-As-You-Go instance", "SpotWithPriceLimit: A price threshold for
      a spot instance, ""SpotAsPriceGo: A price that is based on the highest Pay-As-You-Go
      instance. "Default value: NoSpot.'
    Type: String
  SystemDiskAutoSnapshotPolicyId:
    Description: Auto snapshot policy ID.
    Type: String
  SystemDiskCategory:
    AllowedValues:
    - cloud
    - cloud_efficiency
    - cloud_ssd
    - cloud_essd
    - ephemeral_ssd
    Default: cloud_efficiency
    Description: Category of system disk. Default is cloud_efficiency. support cloud|cloud_efficiency|cloud_ssd|cloud_essd|ephemeral_ssd.Old
      instances will not be changed.
    Type: String
  SystemDiskDescription:
    Description: Description of created system disk. Old instances will not be changed.
    Type: String
  SystemDiskDiskName:
    Description: Name of created system disk. Old instances will not be changed.
    Type: String
  SystemDiskPerformanceLevel:
    Description: 'The performance level of the enhanced SSD used as the system disk.Default
      value: PL1. Valid values:PL0: A single enhanced SSD delivers up to 10,000 random
      read/write IOPS.PL1: A single enhanced SSD delivers up to 50,000 random read/write
      IOPS.PL2: A single enhanced SSD delivers up to 100,000 random read/write IOPS.PL3:
      A single enhanced SSD delivers up to 1,000,000 random read/write IOPS.'
    Type: String
  SystemDiskSize:
    Description: 'Disk size of the system disk, range from 20 to 500 GB. If you specify
      with your own image, make sure the system disk size bigger than image size. '
    MinValue: 20
    Type: Number
  Tags:
    Description: Tags to attach to instance. Max support 20 tags to add during create
      instance. Each tag with two properties Key and Value, and Key is required.
    MaxLength: 20
    Type: Json
  UserData:
    Description: User data to pass to instance. [1, 16KB] characters.User data should
      not be base64 encoded. If you want to pass base64 encoded string to the property,
      use function Fn::Base64Decode to decode the base64 string first.
    Type: String
  VSwitchId:
    Description: The vSwitch Id to create ecs instance.
    Type: String
  VpcId:
    Description: The VPC id to create ecs instance.
    Type: String
  ZoneId:
    Description: "The ID of the zone to which the instance belongs. For more information,\
      \ \ncall the DescribeZones operation to query the most recent zone list. \n\
      Default value is empty, which means random selection."
    Type: String
Resources:
  InstanceGroup:
    Properties:
      AllocatePublicIP:
        Ref: AllocatePublicIP
      AutoReleaseTime:
        Ref: AutoReleaseTime
      AutoRenew:
        Ref: AutoRenew
      AutoRenewPeriod:
        Ref: AutoRenewPeriod
      DedicatedHostId:
        Ref: DedicatedHostId
      DeletionProtection:
        Ref: DeletionProtection
      DeploymentSetId:
        Ref: DeploymentSetId
      Description:
        Ref: Description
      DiskMappings:
        Ref: DiskMappings
      EniMappings:
        Ref: EniMappings
      HostName:
        Ref: HostName
      HpcClusterId:
        Ref: HpcClusterId
      ImageId:
        Ref: ImageId
      InstanceChargeType:
        Ref: InstanceChargeType
      InstanceName:
        Ref: InstanceName
      InstanceType:
        Ref: InstanceType
      InternetChargeType:
        Ref: InternetChargeType
      InternetMaxBandwidthIn:
        Ref: InternetMaxBandwidthIn
      InternetMaxBandwidthOut:
        Ref: InternetMaxBandwidthOut
      IoOptimized:
        Ref: IoOptimized
      Ipv6AddressCount:
        Ref: Ipv6AddressCount
      Ipv6Addresses:
        Ref: Ipv6Addresses
      KeyPairName:
        Ref: KeyPairName
      LaunchTemplateId:
        Ref: LaunchTemplateId
      LaunchTemplateName:
        Ref: LaunchTemplateName
      LaunchTemplateVersion:
        Ref: LaunchTemplateVersion
      MaxAmount:
        Ref: MaxAmount
      NetworkType:
        Ref: NetworkType
      Password:
        Ref: Password
      PasswordInherit:
        Ref: PasswordInherit
      Period:
        Ref: Period
      PeriodUnit:
        Ref: PeriodUnit
      PrivateIpAddress:
        Ref: PrivateIpAddress
      RamRoleName:
        Ref: RamRoleName
      ResourceGroupId:
        Ref: ResourceGroupId
      SecurityEnhancementStrategy:
        Ref: SecurityEnhancementStrategy
      SecurityGroupId:
        Ref: SecurityGroupId
      SecurityGroupIds:
        Ref: SecurityGroupIds
      SpotPriceLimit:
        Ref: SpotPriceLimit
      SpotStrategy:
        Ref: SpotStrategy
      SystemDiskAutoSnapshotPolicyId:
        Ref: SystemDiskAutoSnapshotPolicyId
      SystemDiskCategory:
        Ref: SystemDiskCategory
      SystemDiskDescription:
        Ref: SystemDiskDescription
      SystemDiskDiskName:
        Ref: SystemDiskDiskName
      SystemDiskPerformanceLevel:
        Ref: SystemDiskPerformanceLevel
      SystemDiskSize:
        Ref: SystemDiskSize
      Tags:
        Ref: Tags
      UserData:
        Ref: UserData
      VSwitchId:
        Ref: VSwitchId
      VpcId:
        Ref: VpcId
      ZoneId:
        Ref: ZoneId
    Type: ALIYUN::ECS::InstanceGroup
Outputs:
  HostNames:
    Description: Host names of created instances.
    Value:
      Fn::GetAtt:
      - InstanceGroup
      - HostNames
  InnerIps:
    Description: Inner IP address list of the specified instances. Only for classical
      instances.
    Value:
      Fn::GetAtt:
      - InstanceGroup
      - InnerIps
  InstanceIds:
    Description: The instance id list of created ecs instances
    Value:
      Fn::GetAtt:
      - InstanceGroup
      - InstanceIds
  Ipv6AddressIds:
    Description: 'IPv6 address IDs list of created ecs instances. Note: The return
      type is a two-tier list. If the instance does not have any IPv6 address, the
      element at the corresponding position in the list is null. If all instances
      does not have any IPv address, will return null.'
    Value:
      Fn::GetAtt:
      - InstanceGroup
      - Ipv6AddressIds
  Ipv6Addresses:
    Description: 'IPv6 addresses list of created ecs instances. Note: The return type
      is a two-tier list. If the instance does not have any IPv6 address, the element
      at the corresponding position in the list is null. If all instances does not
      have any IPv address, will return null.'
    Value:
      Fn::GetAtt:
      - InstanceGroup
      - Ipv6Addresses
  OrderId:
    Description: The order id list of created instance.
    Value:
      Fn::GetAtt:
      - InstanceGroup
      - OrderId
  PrivateIps:
    Description: Private IP address list of created ecs instances. Only for VPC instance.
    Value:
      Fn::GetAtt:
      - InstanceGroup
      - PrivateIps
  PublicIps:
    Description: Public IP address list of created ecs instances.
    Value:
      Fn::GetAtt:
      - InstanceGroup
      - PublicIps
  ZoneIds:
    Description: Zone id of created instances.
    Value:
      Fn::GetAtt:
      - InstanceGroup
      - ZoneIds

For more examples, see InstanceGroup.json and InstanceGroup.yml. In the examples, the following resource types are involved: ALIYUN::ECS::InstanceGroup, ALIYUN::ECS::InstanceClone, ALIYUN::ECS::Command, and ALIYUN::ECS::Invocation.