ALIYUN::ECS::InstanceGroup

语法

{
  "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,
    "ZoneIds": List,
    "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,
    "SystemDiskProvisionedIops": Integer,
    "SystemDiskBurstingEnabled": Boolean,
    "SpotInterruptionBehavior": String,
    "SpotDuration": Integer,
    "UpdatePolicy": String
  }
}

属性

DiskMappings语法

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

DiskMappings属性

Tags语法

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

Tags属性

EniMappings语法

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

EniMappings属性

返回值

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地址，则列表中相应位置的元素为空。如果所有实例都没有任何IP地址，则将返回null。

示例

创建两台ECS实例（OpsEcsInstance、ProdEcsInstance），并为ProdEcsInstance实例完成OpsEcsInstance免密登录操作。

如果您需要对ECS实例的Userdata脚本执行结果进行消息通知。更多信息，请参见ALIYUN::ROS::WaitConditionHandle和ALIYUN::ROS::WaitCondition。

• YAML格式

  ROSTemplateFormatVersion: '2015-09-01'
  Description: Creates VPC ECS instance
  Parameters:
    VpcId:
      AssociationProperty: ALIYUN::ECS::VPC::VPCId
      Type: String
      Description:
        en: Please search the ID starting with (vpc-xxx) from console-Virtual Private Cloud
        zh-cn: 现有专有网络的实例ID
      Label:
        en: VPC ID
        zh-cn: 专有网络VPC实例ID
    VSwitchZoneId:
      AssociationProperty: ALIYUN::ECS::Instance:ZoneId
      Type: String
      Description:
        zh-cn: 交换机可用区
        en: VSwitch Availability Zone
      Label:
        zh-cn: 交换机可用区
        en: VSwitch Availability Zone
    VSwitchId:
      AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
      AssociationPropertyMetadata:
        VpcId: ${VpcId}
        ZoneId: ${VSwitchZoneId}
      Type: String
      Description:
        en: Instance ID of existing business network switches, console-Virtual Private Cloud-VSwitches under query
        zh-cn: 现有业务网络交换机的实例ID
      Label:
        en: VSwitch ID
        zh-cn: 交换机实例ID
    SecurityGroupId:
      Type: String
      AssociationProperty: ALIYUN::ECS::SecurityGroup::SecurityGroupId
      AssociationPropertyMetadata:
        VpcId: ${VpcId}
      Description:
        en: Please search the business security group ID starting with(sg-xxx)from console-ECS-Network & Security
        zh-cn: 现有业务安全组的实例ID
      Label:
        en: Business Security Group ID
        zh-cn: 业务安全组ID
    InstanceType:
      Type: String
      Description:
        zh-cn: 填写vSwitch可用区下可使用的规格。
        en: Fill in the specifications that can be used under the VSwitch availability zone.
      Label:
        zh-cn: 实例规格
        en: Instance Type
      AssociationProperty: ALIYUN::ECS::Instance::InstanceType
      AssociationPropertyMetadata:
        ZoneId: ${VSwitchZoneId}
    SystemDiskCategory:
      Type: String
      Label:
        en: System Disk Type
        zh-cn: 系统盘类型
      Description:
        en: System Disk Type
        zh-cn: 系统盘类型
      AssociationProperty: ALIYUN::ECS::Disk::SystemDiskCategory
      AssociationPropertyMetadata:
        ZoneId: ${VSwitchZoneId}
        InstanceType: ${InstanceType}
  Resources:
    OpsEcsInstance:
      Type: ALIYUN::ECS::InstanceGroup
      Properties:
        MaxAmount: 1
        HostName: OpsEcsInstance
        UserData:
          Fn::Sub:
            - |
              #!/bin/bash
              RootPassword=${RootPassword}
              ProdIP=${ProdIP}
              SSHConfig() {
              echo '[ ! -f /root/.ssh/id_rsa.pub ] && ssh-keygen -t rsa -P "" -f ~/.ssh/id_rsa &>/dev/null' >> /tmp/auto_ssh.sh
              echo 'while read line;do' >> /tmp/auto_ssh.sh
              echo '        ip=`echo $line | cut -d " " -f1`' >> /tmp/auto_ssh.sh
              echo '        user_name=`echo $line | cut -d " " -f2`' >> /tmp/auto_ssh.sh
              echo '        pass_word=`echo $line | cut -d " " -f3`' >> /tmp/auto_ssh.sh
              echo 'expect <<EOF' >> /tmp/auto_ssh.sh
              echo '        spawn ssh-copy-id -i /root/.ssh/id_rsa.pub $user_name@$ip' >> /tmp/auto_ssh.sh
              echo '        expect {' >> /tmp/auto_ssh.sh
              echo '                  "yes/no" { send "yes\n";exp_continue}' >> /tmp/auto_ssh.sh
              echo '                  "password" { send "$pass_word\n"}' >> /tmp/auto_ssh.sh
              echo '        }' >> /tmp/auto_ssh.sh
              echo '        expect eof' >> /tmp/auto_ssh.sh
              echo 'EOF' >> /tmp/auto_ssh.sh
              echo 'done < /tmp/host_ip.txt' >> /tmp/auto_ssh.sh
              }
              SetHostsConfig() {
              echo "`ifconfig eth0 | awk '/inet /{print $2}'` root ${RootPassword}" >> /tmp/host_ip.txt
              echo "${ProdIP} root ${RootPassword}" >> /tmp/host_ip.txt
              sh /tmp/auto_ssh.sh
              }
              main() {
              yum install -y expect
              SSHConfig
              SetHostsConfig
              rm -rf /tmp/host_ip.txt
              }
              main
            - ProdIP:
                Fn::Select:
                  - '0'
                  - Fn::GetAtt:
                      - ProdEcsInstance
                      - PrivateIps
              RootPassword: Admin@123!
        VpcId:
          Ref: VpcId
        SecurityGroupId:
          Ref: SecurityGroupId
        VSwitchId:
          Ref: VSwitchId
        ImageId: centos_7
        AllocatePublicIP: false
        InstanceType:
          Ref: InstanceType
        SystemDiskSize: 40
        SystemDiskCategory:
          Ref: SystemDiskCategory
        Password: Admin@123!
    ProdEcsInstance:
      Type: ALIYUN::ECS::InstanceGroup
      Properties:
        MaxAmount: 1
        HostName: ProdEcsInstance
        SystemDiskCategory:
          Ref: SystemDiskCategory
        VpcId:
          Ref: VpcId
        SecurityGroupId:
          Ref: SecurityGroupId
        SystemDiskSize: 40
        ImageId: centos_7
        VSwitchId:
          Ref: VSwitchId
        Password: Admin@123!
        InstanceType:
          Ref: InstanceType
        AllocatePublicIP: false
  Outputs: {}                  

• JSON格式

  {
    "ROSTemplateFormatVersion": "2015-09-01",
    "Description": "Creates VPC ECS instance",
    "Parameters": {
      "VpcId": {
        "AssociationProperty": "ALIYUN::ECS::VPC::VPCId",
        "Type": "String",
        "Description": {
          "en": "Please search the ID starting with (vpc-xxx) from console-Virtual Private Cloud",
          "zh-cn": "现有专有网络的实例ID"
        },
        "Label": {
          "en": "VPC ID",
          "zh-cn": "专有网络VPC实例ID"
        }
      },
      "VSwitchZoneId": {
        "AssociationProperty": "ALIYUN::ECS::Instance:ZoneId",
        "Type": "String",
        "Description": {
          "zh-cn": "交换机可用区",
          "en": "VSwitch Availability Zone"
        },
        "Label": {
          "zh-cn": "交换机可用区",
          "en": "VSwitch Availability Zone"
        }
      },
      "VSwitchId": {
        "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
        "AssociationPropertyMetadata": {
          "VpcId": "${VpcId}",
          "ZoneId": "${VSwitchZoneId}"
        },
        "Type": "String",
        "Description": {
          "en": "Instance ID of existing business network switches, console-Virtual Private Cloud-VSwitches under query",
          "zh-cn": "现有业务网络交换机的实例ID"
        },
        "Label": {
          "en": "VSwitch ID",
          "zh-cn": "交换机实例ID"
        }
      },
      "SecurityGroupId": {
        "Type": "String",
        "AssociationProperty": "ALIYUN::ECS::SecurityGroup::SecurityGroupId",
        "AssociationPropertyMetadata": {
          "VpcId": "${VpcId}"
        },
        "Description": {
          "en": "Please search the business security group ID starting with(sg-xxx)from console-ECS-Network & Security",
          "zh-cn": "现有业务安全组的实例ID"
        },
        "Label": {
          "en": "Business Security Group ID",
          "zh-cn": "业务安全组ID"
        }
      },
      "InstanceType": {
        "Type": "String",
        "Description": {
          "zh-cn": "填写vSwitch可用区下可使用的规格。",
          "en": "Fill in the specifications that can be used under the VSwitch availability zone."
        },
        "Label": {
          "zh-cn": "实例规格",
          "en": "Instance Type"
        },
        "AssociationProperty": "ALIYUN::ECS::Instance::InstanceType",
        "AssociationPropertyMetadata": {
          "ZoneId": "${VSwitchZoneId}"
        }
      },
      "SystemDiskCategory": {
        "Type": "String",
        "Label": {
          "en": "System Disk Type",
          "zh-cn": "系统盘类型"
        },
        "Description": {
          "en": "System Disk Type",
          "zh-cn": "系统盘类型"
        },
        "AssociationProperty": "ALIYUN::ECS::Disk::SystemDiskCategory",
        "AssociationPropertyMetadata": {
          "ZoneId": "${VSwitchZoneId}",
          "InstanceType": "${InstanceType}"
        }
      }
    },
    "Resources": {
      "OpsEcsInstance": {
        "Type": "ALIYUN::ECS::InstanceGroup",
        "Properties": {
          "MaxAmount": 1,
          "HostName": "OpsEcsInstance",
          "UserData": {
            "Fn::Sub": [
              "#!/bin/bash\nRootPassword=${RootPassword}\nProdIP=${ProdIP}\nSSHConfig() {\necho '[ ! -f /root/.ssh/id_rsa.pub ] && ssh-keygen -t rsa -P \"\" -f ~/.ssh/id_rsa &>/dev/null' >> /tmp/auto_ssh.sh\necho 'while read line;do' >> /tmp/auto_ssh.sh\necho '        ip=`echo $line | cut -d \" \" -f1`' >> /tmp/auto_ssh.sh\necho '        user_name=`echo $line | cut -d \" \" -f2`' >> /tmp/auto_ssh.sh\necho '        pass_word=`echo $line | cut -d \" \" -f3`' >> /tmp/auto_ssh.sh\necho 'expect <<EOF' >> /tmp/auto_ssh.sh\necho '        spawn ssh-copy-id -i /root/.ssh/id_rsa.pub $user_name@$ip' >> /tmp/auto_ssh.sh\necho '        expect {' >> /tmp/auto_ssh.sh\necho '                  \"yes/no\" { send \"yes\\n\";exp_continue}' >> /tmp/auto_ssh.sh\necho '                  \"password\" { send \"$pass_word\\n\"}' >> /tmp/auto_ssh.sh\necho '        }' >> /tmp/auto_ssh.sh\necho '        expect eof' >> /tmp/auto_ssh.sh\necho 'EOF' >> /tmp/auto_ssh.sh\necho 'done < /tmp/host_ip.txt' >> /tmp/auto_ssh.sh\n}\nSetHostsConfig() {\necho \"`ifconfig eth0 | awk '/inet /{print $2}'` root ${RootPassword}\" >> /tmp/host_ip.txt\necho \"${ProdIP} root ${RootPassword}\" >> /tmp/host_ip.txt\nsh /tmp/auto_ssh.sh\n}\nmain() {\nyum install -y expect\nSSHConfig\nSetHostsConfig\nrm -rf /tmp/host_ip.txt\n}\nmain\n",
              {
                "ProdIP": {
                  "Fn::Select": [
                    "0",
                    {
                      "Fn::GetAtt": [
                        "ProdEcsInstance",
                        "PrivateIps"
                      ]
                    }
                  ]
                },
                "RootPassword": "Admin@123!"
              }
            ]
          },
          "VpcId": {
            "Ref": "VpcId"
          },
          "SecurityGroupId": {
            "Ref": "SecurityGroupId"
          },
          "VSwitchId": {
            "Ref": "VSwitchId"
          },
          "ImageId": "centos_7",
          "AllocatePublicIP": false,
          "InstanceType": {
            "Ref": "InstanceType"
          },
          "SystemDiskSize": 40,
          "SystemDiskCategory": {
            "Ref": "SystemDiskCategory"
          },
          "Password": "Admin@123!"
        }
      },
      "ProdEcsInstance": {
        "Type": "ALIYUN::ECS::InstanceGroup",
        "Properties": {
          "MaxAmount": 1,
          "HostName": "ProdEcsInstance",
          "SystemDiskCategory": {
            "Ref": "SystemDiskCategory"
          },
          "VpcId": {
            "Ref": "VpcId"
          },
          "SecurityGroupId": {
            "Ref": "SecurityGroupId"
          },
          "SystemDiskSize": 40,
          "ImageId": "centos_7",
          "VSwitchId": {
            "Ref": "VSwitchId"
          },
          "Password": "Admin@123!",
          "InstanceType": {
            "Ref": "InstanceType"
          },
          "AllocatePublicIP": false
        }
      }
    },
    "Outputs": {
    }
  }                    

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