ALIYUN::ECS::InstanceGroupClone - Clone ECS instances | ROS - Resource Orchestration Service

Syntax

 {
  "Type": "ALIYUN::ECS::InstanceGroupClone",
  "Properties": {
    "BackendServerWeight": Integer,
    "SystemDiskAutoSnapshotPolicyId": String,
    "DiskMappings": List,
    "Period": Number,
    "LaunchTemplateName": String,
    "RamRoleName": String,
    "ResourceGroupId": String,
    "KeyPairName": String,
    "SystemDiskDiskName": String,
    "PeriodUnit": String,
    "Description": String,
    "Tags": List,
    "AutoRenewPeriod": Number,
    "ImageId": String,
    "AutoRenew": String,
    "SpotStrategy": String,
    "SourceInstanceId": String,
    "EniMappings": List,
    "Password": String,
    "PasswordInherit": Boolean,
    "MaxAmount": Integer,
    "AutoReleaseTime": String,
    "SystemDiskCategory": String,
    "LoadBalancerIdToAttach": String,
    "LaunchTemplateId": String,
    "LaunchTemplateVersion": String,
    "ZoneId": String,
    "InternetMaxBandwidthOut": Integer,
    "InstanceName": String,
    "DeletionProtection": Boolean,
    "DeploymentSetId": String,
    "Ipv6AddressCount": Integer,
    "SecurityGroupId": String,
    "SecurityGroupIds": List,
    "SpotPriceLimit": String,
    "HpcClusterId": String,
    "SystemDiskDescription": String,
    "Ipv6Addresses": List,
    "SystemDiskProvisionedIops": Integer,
    "SystemDiskBurstingEnabled": Boolean,
    "SystemDiskKMSKeyId": String,
    "SystemDiskStorageClusterId": String,
    "InternetMaxBandwidthIn": Integer,
    "UpdatePolicy": String,
    "SystemDiskEncryptAlgorithm": String,
    "SystemDiskEncrypted": String,
    "SecurityOptions": Map,
    "ImageOptions": Map,
    "NetworkOptions": Map,
    "HostNames": List,
    "NetworkInterfaceQueueNumber": Integer,
    "UniqueSuffix": Boolean,
    "CpuOptions": Map
  }
}

Properties

Property name	Type	Required	Allow updates	Description	Constraints
MaxAmount	Integer	Yes	Yes	The number of ECS instances to create.	Valid values: 1 to 100.
SourceInstanceId	String	Yes	No	The ID of the ECS instance to clone.	Clones the instance type, image, bandwidth billing method, bandwidth limit, network type, and other configurations. If the source instance belongs to multiple security groups, the cloned instance joins only the first one.
AutoReleaseTime	String	No	No	The automatic release time for the instance.	The time must be in the ISO 8601 format. For example: `yyyy-MM-ddTHH:mm:ssZ`. The release time cannot be more than three years in the future.
AutoRenew	String	No	Yes	Whether to enable auto-renewal.	Valid values: True: enables auto-renewal. False (default): disables auto-renewal. This parameter is required when InstanceChargeType is set to PrePaid.
AutoRenewPeriod	Number	No	Yes	The auto-renewal period.	This parameter is required when AutoRenew is set to true. Valid values: 1 (default) 2 3 6 12
BackendServerWeight	Integer	No	No	The backend weight in the SLB instance.	Valid values: 0 to 100. Default value: 100.
CpuOptions	Map	No	No	The CPU properties.	For more information, see CpuOptions properties.
DeletionProtection	Boolean	No	No	Whether the instance can be released from the console or by calling the DeleteInstance API operation.	Valid values: true: Enabled. false: Disabled.
DeploymentSetId	String	No	Yes	The ID of the deployment set.	None
Description	String	No	Yes	The description.	The description can be up to 256 characters in length.
DiskMappings	List	No	Yes	The disks to attach.	A maximum of 16 disks are supported. For more information, see DiskMappings properties.
EniMappings	List	No	Yes	The ENIs to attach to the instance.	A maximum of one ENI can be attached to the instance. For more information, see EniMappings properties.
HostNames	List	No	No	The hostnames for the instances. Specify a different hostname for each instance.	None
HpcClusterId	String	No	Yes	The ID of the E-HPC cluster to which the new instance belongs.	None
ImageId	String	No	Yes	The image ID. Supports public, custom, and Alibaba Cloud Marketplace images.	You can use a fuzzy match to specify a public image ID without specifying a complete public image ID. For example: If you specify `ubuntu`, `ubuntu16_0402_64_20G_alibase_20170818.vhd` is matched. If you specify `ubuntu_14`, `ubuntu_14_0405_64_20G_alibase_20170824.vhd` is matched. If you specify `ubuntu1432`, `ubuntu_14_0405_32_40G_alibase_20170711.vhd` is matched. If you specify `ubuntu_16_0402_32`, `ubuntu_16_0402_32_40G_alibase_20170711.vhd` is matched.
ImageOptions	Map	No	No	The image properties.	For more information, see ImageOptions properties.
InstanceName	String	No	Yes	The name of the new instance.	The name can be up to 128 characters in length. It can contain letters, Chinese characters, digits, underscores (_), periods (.), and hyphens (-).
InternetMaxBandwidthIn	Integer	No	No	Maximum Internet outbound bandwidth.	Unit: Mbit/s. Valid values: 0 to 200. Default value: 200.
InternetMaxBandwidthOut	Integer	No	No	The maximum outbound public bandwidth.	Unit: Mbit/s. Valid values: 0 to 200 for pay-by-bandwidth. 1 to 200 for pay-by-data-transfer.
Ipv6AddressCount	Integer	No	Yes	The number of randomly generated IPv6 addresses to assign to the ENI.	You cannot specify both Ipv6Addresses and Ipv6AddressCount.
Ipv6Addresses	List	No	Yes	One or more IPv6 addresses to assign to the ENI.	The list can contain a maximum of one address. Changes to this property do not affect existing instances. You cannot specify both Ipv6Addresses and Ipv6AddressCount.
KeyPairName	String	No	Yes	The name of the key pair to attach to the new ECS instance.	This parameter is ignored for Windows ECS instances. If you specify KeyPairName, the value of Password is still set for the instance, but password-based logon is disabled for Linux systems.
LaunchTemplateId	String	No	Yes	The ID of the launch template.	None
LaunchTemplateName	String	No	Yes	The name 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.
LoadBalancerIdToAttach	String	No	No	The ID of the SLB instance to which the new ECS instance is added.	None
NetworkInterfaceQueueNumber	Integer	No	No	The number of queues for the primary NIC.	Note: The value cannot exceed the maximum number of queues per NIC that is allowed for the instance type. The total number of queues for all NICs of the instance cannot exceed the total queue quota that is allowed for the instance type. You can query the maximum number of queues per NIC (`MaximumQueueNumberPerEni`) and the total queue quota (`TotalEniQueueQuantity`) for an instance type by calling the DescribeInstanceTypes API operation. If `NetworkInterface.N.InstanceType` is set to `Primary`, you cannot set `NetworkInterfaceQueueNumber`. You can only set `NetworkInterface.N.QueueNumber`.
NetworkOptions	Map	No	No	Network-related properties and parameters.	For more information, see NetworkOptions properties.
Password	String	No	Yes	The logon password for the instance.	The password must be 8 to 30 characters in length. It must contain letters, digits, and special characters. Supported special characters: ()`~!@#$%^&*-_+=\|{}[]:;'<>,.?/. If you specify this parameter, use the HTTPS protocol to call the API operation to prevent password leakage.
PasswordInherit	Boolean	No	No	Whether to use the preset password of the image.	Valid values: true: Use the preset password. false: Do not use the preset password. Note When you use this parameter, the Password parameter must be empty, and you must ensure that a password is set for the image.
Period	Number	No	Yes	The billing cycle.	Valid values: 1 to 9, 12, 24, 36, 48, and 60. Unit: month. This parameter is required when InstanceChargeType is set to PrePaid. This parameter is optional when InstanceChargeType is set to PostPaid.
PeriodUnit	String	No	Yes	The subscription duration unit.	Valid values: Week When PeriodUnit is set to Week, valid values for Period are 1, 2, 3, and 4, and valid values for AutoRenewPeriod are 1, 2, and 3. Month (default) When PeriodUnit is set to Month, valid values for Period are 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, and 60, and valid values for AutoRenewPeriod are 1, 2, 3, 6, and 12.
RamRoleName	String	No	Yes	The RAM role name for the instance.	Query RAM role names by calling ListRoles. Create a role Obtain a list of roles.
ResourceGroupId	String	No	No	The resource group ID for the instance.	None
SecurityGroupId	String	No	No	The security group ID for the instance.	You cannot specify both SecurityGroupId and SecurityGroupIds.
SecurityGroupIds	List	No	No	The security group IDs for the instance.	For more information, see Limits. You cannot specify both SecurityGroupId and SecurityGroupIds.
SecurityOptions	Map	No	No	The trusted system properties.	For more information, see SecurityOptions properties.
SpotPriceLimit	String	No	No	The maximum hourly price for the instance.	The value can have up to three decimal places. SpotPriceLimit takes effect when SpotStrategy is set to SpotWithPriceLimit.
SpotStrategy	String	No	Yes	The bidding policy for pay-as-you-go instances.	This parameter is required when InstanceChargeType is set to PostPaid. Valid values: NoSpot (default): The instance is a regular pay-as-you-go instance. SpotWithPriceLimit: The instance is a spot instance with a user-defined maximum price. SpotAsPriceGo: The system automatically bids at the optimal price, which does not exceed the pay-as-you-go price.
SystemDiskAutoSnapshotPolicyId	String	No	Yes	The ID of the automatic snapshot policy for the system disk.	None
SystemDiskBurstingEnabled	Boolean	No	Yes	Whether to enable bursting for the system disk.	Valid values: true: Enabled. false (default): Disabled.
SystemDiskCategory	String	No	Yes	The type of the system disk.	Valid values: cloud: basic disk. cloud_efficiency (default): ultra disk. cloud_ssd: standard SSD. cloud_essd: enterprise SSD.
SystemDiskDescription	String	No	Yes	The description of the system disk.	None
SystemDiskDiskName	String	No	Yes	The name of the system disk.	The name must be 2 to 128 characters in length. It must start with a letter or a Chinese character and cannot start with `http://` or `https://`. It can contain digits, colons (:), underscores (_), and hyphens (-).
SystemDiskEncryptAlgorithm	String	No	Yes	The encryption algorithm for the system disk.	Valid values: AES-256. SM4-128.
SystemDiskEncrypted	String	No	Yes	Whether to encrypt the system disk.	Valid values: true: Encrypted. false: Not encrypted.
SystemDiskKMSKeyId	String	No	Yes	The ID of the KMS key used for the system disk.	None
SystemDiskProvisionedIops	Integer	No	Yes	The provisioned IOPS of the system disk.	None
SystemDiskStorageClusterId	String	No	Yes	The ID of the dedicated block storage cluster for the system disk.	None
Tags	List	No	Yes	The custom tags.	A maximum of 20 tags are supported. Format: `[{"Key": "tagKey", "Value": "tagValue"},{"Key": "tagKey2", "Value": "tagValue2"}]`. For more information, see Tags properties.
UniqueSuffix	Boolean	No	No	Whether to add a sequential suffix to `HostName` and `InstanceName` when creating multiple instances.	The sequential suffix starts from 001 and increments. The maximum value cannot exceed 999. Valid values: true: Add a suffix. false (default): No suffix added. When `HostName` or `InstanceName` is set in the specified sequential format, and the `name_suffix` is not set (that is, the naming format is `name_prefix[begin_number,bits]`), `UniqueSuffix` does not take effect. The names are sorted only in the specified order. Sequentially set instance names or hostnames.
UpdatePolicy	String	No	Yes	The update policy.	Valid values: ForNewInstance (default): The update policy applies to new instances. ForAllInstances: The update policy applies to all instances.
ZoneId	String	No	No	The ID of the zone.	None

DiskMappings syntax

"DiskMappings": [
  {
    "Category": String,
    "DiskName": String,
    "Description": String,
    "Encrypted": String,
    "KMSKeyId": String,
    "Device": String,
    "SnapshotId": String,
    "Size": String,
    "PerformanceLevel": String,
    "AutoSnapshotPolicyId": String,
    "ProvisionedIops": Integer,
    "BurstingEnabled": Boolean,
    "StorageClusterId": String
  }
]

DiskMappings properties

Property name	Type	Required	Updatable	Description	Constraints
Size	String	Yes	No	The size of the data disk.	Unit: GB.
AutoSnapshotPolicyId	String	No	No	The ID of the automatic snapshot policy.	None
BurstingEnabled	Boolean	No	No	Whether to enable bursting.	Valid values: true: Enabled. false (default): Disabled.
Category	String	No	No	The type of the data disk.	Valid values: cloud (default): basic disk. cloud_ssd: standard SSD. cloud_essd: enterprise SSD. cloud_efficiency: ultra disk.
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 device name of the data disk.	Example: `/dev/xvd[a-z]`.
DiskName	String	No	No	The name of the data disk.	The name can be up to 128 characters in length. It can contain letters, Chinese characters, digits, underscores (_), periods (.), and hyphens (-).
Encrypted	String	No	No	Whether to encrypt the data disk.	Valid values: true: Encrypted. false (default): Not encrypted.
KMSKeyId	String	No	No	The ID of the KMS key for the data disk.	None
PerformanceLevel	String	No	No	The performance level for an enterprise SSD data disk.	Valid values: PL0: A single disk delivers up to 10,000 random read/write IOPS. PL1 (default): A single disk delivers up to 50,000 random read/write IOPS. PL2: A single disk delivers up to 100,000 random read/write IOPS. PL3: A single disk delivers up to 1,000,000 random read/write IOPS. For information about how to select an ESSD performance level, see ESSDs.
ProvisionedIops	Integer	No	No	The provisioned IOPS.	None
SnapshotId	String	No	No	The ID of the snapshot.	None
StorageClusterId	String	No	No	The ID of the dedicated block storage cluster.	None

EniMappings syntax

"EniMappings": [
  {
    "SecurityGroupId": String,
    "VSwitchId": String,
    "Description": String,
    "NetworkInterfaceName": String,
    "PrimaryIpAddress": String,    
    "InstanceType": String,
    "Ipv6AddressCount": Integer,
    "NetworkInterfaceTrafficMode": String,
    "Ipv6Addresses": List,
    "QueueNumber": Integer,
    "SecurityGroupIds": List,
    "QueuePairNumber": Integer,
    "NetworkInterfaceId": String,
    "DeleteOnRelease": Boolean,
    "NetworkCardIndex": Integer
  }
]

EniMappings properties

Property name	Type	Required	Updatable	Description	Constraints
DeleteOnRelease	Boolean	No	No	Whether to retain the NIC when the instance is released.	Valid values: true: Not retained. false: Retain the existing setting.
Description	String	No	Yes	The description of the ENI.	The description must be 2 to 256 characters in length and cannot start with `http://` or `https://`.
InstanceType	String	No	No	The type of the ENI.	You can set a maximum of two NICs. When you set one ENI, you can set it as a primary or secondary ENI. When you set two ENIs, you can only set one as a primary ENI and the other as a secondary ENI. Valid values: Primary: primary ENI. Secondary (default): secondary ENI.
Ipv6AddressCount	Integer	No	No	The number of randomly generated IPv6 addresses to assign to the primary NIC.	Valid values: 1 to 10. Notes: This parameter takes effect only when `NetworkInterface.InstanceType` is set to `Primary`. If `NetworkInterface.InstanceType` is set to `Secondary` or is empty, you cannot set this parameter. After you set this parameter, you cannot set `Ipv6AddressCount`, `Ipv6Address`, or `NetworkInterface.Ipv6Address`.
Ipv6Addresses	List	No	No	One or more IPv6 addresses to assign to the primary NIC.	You can set a maximum of 10 IPv6 addresses. Notes: This parameter takes effect only when `NetworkInterface.InstanceType` is set to `Primary`. If `NetworkInterface.InstanceType` is set to `Secondary` or is empty, you cannot set this parameter. After you set this parameter, the value of `Amount` can only be 1, and you cannot set `Ipv6AddressCount`, `Ipv6Address.N`, or `NetworkInterface.N.Ipv6AddressCount`.
NetworkCardIndex	Integer	No	No	The physical NIC index.	Only specific instance types support specifying a physical NIC index. When NetworkInterface.N.InstanceType is set to Primary, if you set this parameter for a supported instance type, the value can only be 0. When NetworkInterface.N.InstanceType is set to Secondary or is empty, you can set this parameter based on the instance type. Instance families.
NetworkInterfaceId	String	No	No	The ID of the ENI to attach to the instance.	This parameter is effective only for secondary ENIs. After you specify an existing secondary ENI, you cannot configure other NIC creation parameters.
NetworkInterfaceName	String	No	Yes	The name of the ENI.	The name must be 2 to 128 characters in length. It must start with a letter or a Chinese character and cannot start with `http://` or `https://`. It can contain letters, Chinese characters, digits, colons (:), underscores (_), and hyphens (-).
NetworkInterfaceTrafficMode	String	No	No	The communication mode of the NIC.	Valid values: Standard (default): Uses the TCP communication mode. HighPerformance: Enables the Elastic RDMA Interface (ERI) and uses the RDMA communication mode. Note The number of ENIs in RDMA mode cannot exceed the limit for the instance family. Instance families.
PrimaryIpAddress	String	No	No	The primary private IP address of the ENI.	The specified IP address must be an available address within the CIDR block of the vSwitch. If you do not specify an IP address, an available address from the vSwitch's CIDR block is randomly assigned.
QueueNumber	Integer	No	No	The number of queues for the ENI.	Notes: Valid values: 1 to 2. When you set one ENI, you can set it as a primary or secondary ENI. When you set two ENIs, you can only set one as a primary ENI and the other as a secondary ENI. The value cannot exceed the maximum number of queues per NIC that is allowed for the instance type. The total number of queues for all NICs of the instance cannot exceed the total queue quota that is allowed for the instance type. You can query the maximum number of queues per NIC (`MaximumQueueNumberPerEni`) and the total queue quota (`TotalEniQueueQuantity`) for an instance type by calling the DescribeInstanceTypes API operation. If `NetworkInterface.InstanceType` is set to `Primary` and you set this parameter, you cannot set the `NetworkInterfaceQueueNumber` parameter.
QueuePairNumber	Integer	No	No	The number of queues for the RDMA NIC.	This field is of the Long type. Precision may be lost during serialization or deserialization. Ensure that the value does not exceed 9007199254740991.
SecurityGroupId	String	No	Yes	The ID of the security group.	The security group must be in the same VPC.
SecurityGroupIds	List	No	No	The security group IDs for the ENI.	Notes: If `NetworkInterface.N.InstanceType` is set to `Primary`, you must set this parameter or `NetworkInterface.SecurityGroupId`. In this case, this parameter has the same effect as `SecurityGroupIds`, but you cannot set `SecurityGroupId`, `SecurityGroupIds`, or `NetworkInterface.SecurityGroupId`. If `NetworkInterface.N.InstanceType` is set to `Secondary` or is empty, this parameter is optional. The default value is the security group of the ECS instance.
VSwitchId	String	No	No	The ID of the vSwitch.	None

SecurityOptions syntax

"SecurityOptions": {
  "TrustedSystemMode": String
}

SecurityOptions properties

Property name

Type

Required

Updatable

Description

Constraints

TrustedSystemMode

String

No

The trusted system mode.

Valid value: vTPM. Currently, the trusted system mode is supported by the g7, c7, and r7 instance families, and the security-enhanced instance families (g7t, c7t, and r7t). You must set this parameter when you create ECS instances of these instance families. The details are as follows:

If you use the Alibaba Cloud Trusted System, set this parameter to vTPM. This allows the instance to complete a trusted verification through the Alibaba Cloud Trusted System upon startup. If you do not use the Alibaba Cloud Trusted System, you can leave this parameter empty. However, note that if the ECS instance you create uses the Enclave confidential computing mode (SecurityOptions.ConfidentialComputingMode=Enclave), the trusted system is also enabled for the ECS instance. When you use OpenAPI to create an ECS instance with a trusted system, you can only call RunInstances. CreateInstance does not currently support setting the SecurityOptions.TrustedSystemMode parameter.

Note

If you specify an instance as a trusted instance when you create it, you can only use an image that supports the trusted system when you replace the system disk.

ImageOptions syntax

"ImageOptions": {
  "LoginAsNonRoot": Boolean
}

ImageOptions properties

Property name

Type

Required

Updatable

Description

Constraints

LoginAsNonRoot

Boolean

No

Whether the image supports logon as ecs-user.

Valid values:

true: Yes.
false: No.

CpuOptions syntax

"CpuOptions": {
  "ThreadsPerCore": Integer,
  "Core": Integer
}

CpuOptions properties

Property name

Type

Required

Updatable

Description

Constraints

Core

Integer

No

The number of CPU cores.

You cannot customize this parameter. You can only use the default value.

Default value: See Change CPU options.

ThreadsPerCore

Integer

No

The number of threads per CPU core.

The number of vCPUs of an ECS instance = Value of CpuOptions.Core × Value of CpuOptions.ThreadsPerCore.

NetworkOptions syntax

"NetworkOptions": {
  "EnableJumboFrame": Boolean
}

NetworkOptions properties

Property name

Type

Required

Updatable

Description

Constraints

EnableJumboFrame

Boolean

No

Whether to enable the jumbo frame feature for the instance.

Valid values:

false: Do not enable jumbo frames. The MTU of all NICs (including primary and secondary NICs) on the instance is 1500.
true (default): Enable jumbo frames. The MTU of all NICs (including primary and secondary NICs) on the instance is 8500.

Note

Only some generation-VIII or later instance types support jumbo frames. Jumbo frames.

Tags syntax

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

Tags properties

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

Return values

Fn::GetAtt

InstanceIds: The IDs of the new instances. An instance ID is a globally unique identifier that is generated by the system for an instance.
PrivateIps: A list of the private IP addresses of the VPC-type instances. This attribute is returned when the NetworkType parameter is set to vpc. Example: ["172.16.XX.XX", "172.16.XX.XX", ..., "172.16.XX.XX"]. The list can contain up to 100 IP addresses.
InnerIps: A list of the private IP addresses of the Classic Network-type instances. This attribute is returned when the NetworkType parameter is set to classic. Example: ["10.1.XX.XX", "10.1.XX.XX", ..., "10.1.XX.XX"]. The list can contain up to 100 IP addresses.
PublicIps: A list of the public IP addresses of the Classic Network-type instances. This attribute is returned when the NetworkType parameter is set to classic. Example: ["42.1.XX.XX", "42.1.XX.XX", ..., "42.1.XX.XX"]. The list can contain up to 100 IP addresses.
HostNames: A list of the hostnames of the new instances.
OrderId: A list of the order IDs for the new instances.
ZoneIds: A list of the IDs of the zones.
RelatedOrderIds: A list of the related order IDs for the created ECS instances.
Ipv6AddressIds: A list of the IPv6 address IDs for the created ECS instances. Note: This attribute returns a two-dimensional list. If an instance does not have any IPv6 addresses, the corresponding element in the list is an empty list. If none of the instances have an IPv6 address, null is returned.
Ipv6Addresses: A list of the IPv6 addresses for the created ECS instances. Note: This attribute returns a two-dimensional list. If an instance does not have any IPv6 addresses, the corresponding element in the list is null. If none of the instances have an IPv6 address, null is returned.

Examples

YAML

ROSTemplateFormatVersion: '2015-09-01'
Description: According the existing ECS instance, clone a set of ECS instanes with the same configuration(InstanceType, ImageId, InternetChargeType, InternetMaxBandwidthOut, system disk, data disk configurations, VPC properties). The user only needs to specify SourceInstanceId.
Parameters:
  SourceInstanceId:
    Type: String
    Description: The source ECS instance ID to be cloned
    Label: Source Instance ID
  InstanceName:
    Type: String
    Description: The instance name. The name must be 2 to 128 characters in length. It can contain letters, Chinese characters, digits, underscores (_), periods (.), and hyphens (-).
    ConstraintDescription: '[2, 128] characters, consists of uppercase letter, lowercase letter, number or special characters.'
    Label: Instance Name
    Default: ClonedECS
    MaxLength: 128
    MinLength: 2
  MaxAmount:
    Type: Number
    Description: The maximum number of ECS instances to create at a time. This value must be greater than or equal to the minimum number of ECS instances to create at a time.
    ConstraintDescription: An integer within [1, 100]
    Label: The Maximum of ECS Instances
    MaxValue: 100
    MinValue: 1
    Default: 1
  Password:
    Type: String
    Description: 'The password must be 8 to 30 characters in length. It must contain three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Supported special characters: ( ) ` ~ ! @ # $ % ^  * - + = | { } [ ] : ; ‘ , . ? /.'
    ConstraintDescription: 'Length 8-30, must contain three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Supported special characters: ()`~!@#$%^*_-+=|{}[]:;'',.?/'
    Label: ECS Instance Password
    MaxLength: 30
    MinLength: 8
    AllowedPattern: '[a-zA-Z0-9-\(\)\`\~\!@\#\$%\^\*-+=\|\{\}\[\]\:\;\‘\,\.\?\/]*'
    NoEcho: true
Metadata:
  ALIYUN::ROS::Interface:
    ParameterGroups:
      - Parameters:
          - InstanceName
          - SourceInstanceId
          - MaxAmount
          - Password
        Label:
          default: ECS
    TemplateTags:
      - acs:example:elastic-computing:Specify SourceInstanceId to clone a group of ECS instances with the same configuration.
Resources:
  ECSInstanceGroup:
    Type: ALIYUN::ECS::InstanceGroupClone
    Properties:
      SourceInstanceId:
        Ref: SourceInstanceId
      MaxAmount:
        Ref: MaxAmount
      Password:
        Ref: Password
Outputs:
  InstanceIds:
    Description: The instance ID list of created ecs instance
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - InstanceIds
  PublicIps:
    Description: Public IP address list of created ecs instance.
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - PublicIps
  ZoneIds:
    Description: Zone ID of created instance.
    Value:
      Fn::GetAtt:
        - ECSInstanceGroup
        - ZoneIds

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "According the existing ECS instance, clone a set of ECS instanes with the same configuration(InstanceType, ImageId, InternetChargeType, InternetMaxBandwidthOut, system disk, data disk configurations, VPC properties). The user only needs to specify SourceInstanceId.",
  "Parameters": {
    "SourceInstanceId": {
      "Type": "String",
      "Description": "The source ECS instance ID to be cloned",
      "Label": "Source Instance ID"
    },
    "InstanceName": {
      "Type": "String",
      "Description": "The instance name. The name must be 2 to 128 characters in length. It can contain letters, Chinese characters, digits, underscores (_), periods (.), and hyphens (-).",
      "ConstraintDescription": "[2, 128] characters, consists of uppercase letter, lowercase letter, number or special characters.",
      "Label": "Instance Name",
      "Default": "ClonedECS",
      "MaxLength": 128,
      "MinLength": 2
    },
    "MaxAmount": {
      "Type": "Number",
      "Description": "The maximum number of ECS instances to create at a time. This value must be greater than or equal to the minimum number of ECS instances to create at a time.",
      "ConstraintDescription": "An integer within [1, 100]",
      "Label": "The Maximum of ECS Instances",
      "MaxValue": 100,
      "MinValue": 1,
      "Default": 1
    },
    "Password": {
      "Type": "String",
      "Description": "The password must be 8 to 30 characters in length. It must contain three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Supported special characters: ( ) ` ~ ! @ # $ % ^  * - + = | { } [ ] : ; ‘ , . ? /.",
      "ConstraintDescription": "Length 8-30, must contain three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Supported special characters: ()`~!@#$%^*_-+=|{}[]:;',.?/",
      "Label": "ECS Instance Password",
      "MaxLength": 30,
      "MinLength": 8,
      "AllowedPattern": "[a-zA-Z0-9-\\(\\)\\`\\~\\!@\\#\\$%\\^\\*-+=\\|\\{\\}\\[\\]\\:\\;\\‘\\,\\.\\?\\/]*",
      "NoEcho": true
    }
  },
  "Metadata": {
    "ALIYUN::ROS::Interface": {
      "ParameterGroups": [
        {
          "Parameters": [
            "InstanceName",
            "SourceInstanceId",
            "MaxAmount",
            "Password"
          ],
          "Label": {
            "default": "ECS"
          }
        }
      ],
      "TemplateTags": [
        "acs:example:elastic-computing:Specify SourceInstanceId to clone a group of ECS instances with the same configuration."
      ]
    }
  },
  "Resources": {
    "ECSInstanceGroup": {
      "Type": "ALIYUN::ECS::InstanceGroupClone",
      "Properties": {
        "SourceInstanceId": {
          "Ref": "SourceInstanceId"
        },
        "MaxAmount": {
          "Ref": "MaxAmount"
        },
        "Password": {
          "Ref": "Password"
        }
      }
    }
  },
  "Outputs": {
    "InstanceIds": {
      "Description": "The instance ID list of created ecs instance",
      "Value": {
        "Fn::GetAtt": [
          "ECSInstanceGroup",
          "InstanceIds"
        ]
      }
    },
    "PublicIps": {
      "Description": "Public IP address list of created ecs instance.",
      "Value": {
        "Fn::GetAtt": [
          "ECSInstanceGroup",
          "PublicIps"
        ]
      }
    },
    "ZoneIds": {
      "Description": "Zone ID of created instance.",
      "Value": {
        "Fn::GetAtt": [
          "ECSInstanceGroup",
          "ZoneIds"
        ]
      }
    }
  }
}