全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
资源编排

ALIYUN::ECS::Instance

更新时间:2017-09-05 18:34:27

ALIYUN::ECS::Instance 类型可用于创建 ECS 实例。

语法

  1. {
  2. "Type" : "ALIYUN::ECS::Instance",
  3. "Properties" : {
  4. "DiskMappings" : List,
  5. "IoOptimized" : String,
  6. "InternetChargeType" : String,
  7. "PrivateIpAddress" : String,
  8. "SystemDiskDiskName" : String,
  9. "VpcId" : String,
  10. "Description" : String,
  11. "Tags" : List,
  12. "HostName" : String,
  13. "ImageId" : String,
  14. "InstanceChargeType" : String,
  15. "VSwitchId" : String,
  16. "Password" : String,
  17. "InstanceType" : String,
  18. "SystemDiskCategory" : String,
  19. "SystemDiskSize" : Integer,
  20. "ZoneId" : String,
  21. "InternetMaxBandwidthOut" : Integer,
  22. "InstanceName" : String,
  23. "InternetMaxBandwidthIn" : Integer,
  24. "UserData" : String,
  25. "SecurityGroupId" : String,
  26. "Period" : Integer,
  27. "AllocatePublicIP" : Boolean,
  28. "SystemDiskDescription" : String,
  29. "KeyPairName": String
  30. }
  31. }

属性

属性名称 类型 必须 允许更新 描述 约束
ImageId string 用于启动 ECS 实例的镜像 ID,包括公共镜像、自定义镜像和云市场镜像。
ECS 公共镜像列表
支持通过模糊的方式指定公共镜像Id,而不需要指定一个完整的公共镜像Id。 一般情况,大家部署ECS的时候,选择镜像只对镜像的类型和版本比较感兴趣,那么现在大家只需要在输入模板的地方,只用指定镜像的类型和版本或者只指定镜像类型,ROS会选择自动适配符合的公共镜像Id。在模糊镜像ID中,可以用通配符 “”指代镜像ID的某一部分。
以所有阿里云提供的Ubuntu的公共镜像为例:
ubuntu_14_0405_32_40G_alibase_20170711.vhd
ubuntu_14_0405_64_20G_alibase_20170824.vhd
ubuntu_16_0402_32_40G_alibase_20170711.vhd
ubuntu_16_0402_64_20G_alibase_20170818.vhd
在给ECS 指定公共镜像Id的时候,可以按照如下方式:
指定:ubuntu
最终会匹配:ubuntu_16_0402_64_20G_alibase_20170818.vhd
指定:ubuntu_14
最终会匹配:ubuntu_14_0405_64_20G_alibase_20170824.vhd
指定:ubuntu
1432
最终会匹配:ubuntu14_0405_32_40G_alibase_20170711.vhd
指定:ubuntu_16_0402_32
最终会匹配:ubuntu_16_0402_32_40G_alibase_20170711.vhd
InstanceType string ECS 实例规格。 ECS实例规格列表
SecurityGroupId string 指定创建实例所属安全组。
Description string 描述信息。 最长 256 个字符。
InstanceName string 实例名称。 最长 128 个字符,可包含英文、中文、数字、’‘、‘.’、’-‘。
Password string ECS 实例登录密码。 实例的密码。8-30 个字符,必须同时包含三项(大、小写字母,数字和特殊符号)。支持以下特殊字符:( ) ` ~ ! @ # $ % ^ & - + = | { } [ ] : ; ‘ < > , . ? /。如果传入 Password 参数,请务必使用 HTTPS 协议调用API以避免可能发生的密码泄露。
HostName string 主机名。 表示云服务器的主机名,最少 2 字符,“.”和“-”是不能作为 hostname 的首尾字符,不能连续使用。 Windows 平台最长为 15 字符,允许字母(不限制大小写)、数字和“-”组成,不支持点号(”.”),不能全是数字。其他(Linux 等)平台最长为 30 字符,允许支持多个点号,点之间为一段,每段允许字母(不限制大小写)、数字和“-”组成。
AllocatePublicIP boolean 指定是否创建公网 IP。如果 InternetMaxBandwidthOut 设置为 0,不会分配公网 IP。 默认为 true
PrivateIpAddress string 在 VPC 网络环境下,指定内网 IP,IP 地址不能与 VPC 网络下的其他实例重复。
InternetChargeType string 公网访问带宽计费方式,默认为按流量付费。 可选值: PayByBandwidth (按固定带宽计费)、PayByTraffic (按流量计费)
InternetMaxBandwidthIn integer 公网最大入网带宽,单位 Mbps。 数值范围: [1, 100],默认值:100。
InternetMaxBandwidthOut integer 公网最大出网带宽,单位 Mbps。 按固定带宽计费时取值范围:[0, 200],默认值为0;按流量计费时取值范围:[1, 200],必须指定。
IoOptimized string 指定是否创建 IO 优化实例。 可选值:none(非 IO 优化)、optimized(IO 优化),默认:none。
DiskMappings list 指定需要挂载的磁盘。 最多支持 4 块磁盘。
SystemDiskCategory string 指定系统盘类型。 可选值:cloud、cloud_efficiency、cloud_ssd、 ephemeral_ssd。
SystemDiskDescription string 系统盘描述信息。
SystemDiskDiskName string 系统盘名称。
SystemDiskSize string 系统盘大小。 取值范围: 40~500 GB,如果使用自定义镜像创建系统盘,需要保证系统盘大于自定义镜像大小。
Tags list 用户自定义标签。 最多支持 4 个标签,格式如: [{“Key”:”tagKey”,”Value”:”tagValue”},{“Key”:”tagKey2”,”Value”:”tagValue2”}]。
UserData string 创建 ECS 实例时传递的用户数据。 内容需要限制在 16 KB 以内。
ZoneId string 可用区 ID。
VpcId string VPC ID.
VSwitchId string VSwitch ID.
InstanceChargeType string 指定创建按量付费或是预付费ECS 可选值:Prepiad、Postpaid。默认值:Postpaid。如果指定 Prepaid,必须确保余额充足,否则创建失败。
Period integer 当 InstanceChargeType 指定为 Prepaid,必需指定付费周期;当 InstanceChargeType 指定为 Postpaid,忽略该值。 可选值:1-9、12、24、36,单位是:月。
KeyPairName string 给 ECS 实例绑定的密钥对名称。如果是 Windows ECS 实例,则忽略该参数。默认为空。如果填写了 KeyPairName,Password 的内容仍旧会被设置到实例中,但是 Linux 中的密码登录方式会被初始化成禁止。

DiskMappings 语法

  1. "DiskMappings" : [
  2. {
  3. "Category" : String,
  4. "DiskName" : String,
  5. "Description" : String,
  6. "Device" : String,
  7. "SnapshotId" : String,
  8. "Size" : String
  9. }
  10. ]

DiskMappings 属性

属性名称 类型 必须 允许更新 描述 约束
Size string 数据盘大小,单位:GB。
Category string 数据盘的类型。 允许的可选值:cloud、cloudefficiency、cloud_ssd、ephemeral_ssdDefault。
DiskName string 数据盘的名称。 最长 128 个字符,可包含英文、中文、数字、’‘、‘.’、’-‘。
Description string 描述信息。 取值范围:[2,256],默认值是空。
Device string 指定数据盘在 ECS 中的名称。 例如:/dev/xvd[a-z]。
SnapshotId string 通过 SnapshotId 创建数据盘。

Tags 语法

  1. "Tags" : [
  2. {
  3. "Value" : String,
  4. "Key" : String
  5. }
  6. ]

Tags 属性

属性名称 类型 必须 允许更新 描述 约束
Key string
Value string

返回值

Fn::GetAtt

  • InstanceId:实例 ID,由系统生成,全局唯一。是访问实例的唯一标识。

  • PrivateIp:VPC 类型实例的私网 IP。 当 NetworkType 为 VPC 时,这个参数生效。

  • InnerIp:Classic 类型实例的私网 IP。 当 NetworkType 为 Classic 时,这个参数生效。

  • PublicIp:Classic 类型实例的公网 IP 列表。 当 NetworkType 为 Classic 时,这个参数生效。

  • ZoneId:可用区 ID。

  • HostName:实例的主机名称。

示例

  1. {
  2. "ROSTemplateFormatVersion" : "2015-09-01",
  3. "Resources" : {
  4. "WebServer": {
  5. "Type": "ALIYUN::ECS::Instance",
  6. "Properties": {
  7. "ImageId" : "m-25l0rcfjo",
  8. "InstanceType": "ecs.t1.small",
  9. "SecurityGroupId": "sg-25zwc3se0",
  10. "ZoneId": "cn-beijing-b",
  11. "Tags": [{
  12. "Key": "tiantt",
  13. "Value": "ros"
  14. },{
  15. "Key": "tiantt1",
  16. "Value": "ros1"
  17. }
  18. ]
  19. }
  20. }
  21. },
  22. "Outputs": {
  23. "InstanceId": {
  24. "Value" : {"get_attr": ["WebServer","InstanceId"]}
  25. },
  26. "PublicIp": {
  27. "Value" : {"get_attr": ["WebServer","PublicIp"]}
  28. }
  29. }
  30. }
本文导读目录