ALIYUN::ECS::InstanceGroupClone

语法

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

属性

DiskMappings语法

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

DiskMappings属性

EniMappings语法

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

EniMappings属性

Tags语法

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

Tags属性

返回值

Fn::GetAtt

• InstanceIds：实例ID，是访问实例的唯一标识。由系统生成，全局唯一。
• PrivateIps：VPC类型实例的私网IP列表。当NetworkType为vpc时，此参数生效。例如：一个带有格式的JSON Array: [“172.16.XX.XX”, “172.16.XX.XX”, … “172.16.XX.XX”]，最多100个IP，用半角逗号（,）隔开。
• InnerIps：Classic类型实例的私网IP列表。当NetworkType为classic时，此参数生效。例如：一个带有格式的JSON Array: [“10.1.XX.XX”, “10.1.XX.XX”, … “10.1.XX.XX”]，最多100个IP，用半角逗号（,）隔开。
• PublicIps：Classic类型实例的公网IP列表。当NetworkType为classic时，此参数生效。例如：一个带有格式的JSON Array: [“42.1.XX.XX”, “42.1.XX.XX”, … “42.1.XX.XX”]，最多100个IP，用半角逗号（,）隔开。
• HostNames：所有实例的主机名称列表。
• OrderId：实例的订单ID列表。
• ZoneIds：可用区ID。
• Ipv6AddressIds：已创建ECS实例的IPv6地址ID列表。注意：返回类型是两层列表。如果实例没有任何IPv6地址，则列表中相应位置的元素为空。如果所有实例都没有任何IP地址，则将返回null。
• Ipv6Addresses：已创建ECS实例的IPv6地址列表。注意：返回类型是两层列表。如果实例没有任何IPv6地址，则列表中相应位置的元素为null。如果所有实例都没有任何IP地址，则将返回null。

示例

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": {
        "en": "The source ECS instance ID to be cloned",
        "zh-cn": "需要克隆的ECS实例ID"
      },
      "Label": {
        "zh-cn": "源实例ID",
        "en": "Source Instance ID"
      }
    },
    "InstanceName": {
      "Type": "String",
      "Description": {
        "en": "[2, 128] alphanumeric letters, underline, dot or hyphen",
        "zh-cn": "实例名称。长度为2~128个字符，可包含英文、汉字、数字、下划线（_）、半角句号（.）和短划线（-）。"
      },
      "ConstraintDescription": {
        "en": "[2, 128] characters, consists of uppercase letter, lowercase letter, number or special characters.",
        "zh-cn": "长度为2~128个字符，可包含英文字母、数字或特殊字符。"
      },
      "Label": {
        "zh-cn": "实例名称",
        "en": "Instance Name"
      },
      "Default": "ClonedECS",
      "MaxLength": 128,
      "MinLength": 2
    },
    "MaxAmount": {
      "Type": "Number",
      "Description": {
        "en": "The maximum of ECS instances, must be greater than or equal to the minimum.",
        "zh-cn": "一次性创建ECS实例的最大个数，必须大于或等于一次性创建ECS实例的最小个数。"
      },
      "ConstraintDescription": {
        "zh-cn": "1~100内的整数",
        "en": "An integer within [1, 100]"
      },
      "Label": {
        "zh-cn": "最大个数",
        "en": "The Maximum of ECS Instances"
      },
      "MaxValue": 100,
      "MinValue": 1,
      "Default": 1
    },
    "Password": {
      "Type": "String",
      "Description": {
        "en": "[8, 30] characters, consists of uppercase letter, lowercase letter, number or special characters such as ( ) ` ~ ! @ # $ % ^  * - + = | { } [ ] : ; ‘ , . ? / ",
        "zh-cn": "长度为8~30个字符。必须同时包含大写英文字母、小写英文字母、数字和特殊字符中的三项，支持的特殊字符为：( ) ` ~ ! @ # $ % ^  * - + = | { } [ ] : ; ‘ , . ? /。"
      },
      "ConstraintDescription": {
        "en": "Length 8-30, must contain upper case letters, lower case letters, Numbers, special symbols three; special characters include: ()`~!@#$%^*_-+=|{}[]:;',.?/",
        "zh-cn": "长度为8~30个字符。必须同时包含大写英文字母、小写英文字母、数字和特殊字符中的三项，支持的特殊字符为()`~!@#$%^*_-+=|{}[]:;' ,.?/。"
      },
      "Label": {
        "zh-cn": "ECS实例密码",
        "en": "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:弹性计算：指定SourceInstanceId克隆出相同配置的一组ECS实例。"
      ]
    }
  },
  "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"
        ]
      }
    }
  }
}

更多示例，请参见创建一组相同配置的ECS实例、克隆一个ECS实例、新建云助手命令和为一台或多台ECS实例触发一条云助手命令的组合示例：JSON示例和YAML示例。