ALIYUN::ECS::DedicatedHost创建专有宿主机的语法与属性-资源编排-阿里云

ALIYUN::ECS::DedicatedHost用于创建专有宿主机。

语法

{
  "Type": "ALIYUN::ECS::DedicatedHost",
  "Properties": {
    "DedicatedHostType": String,
    "DedicatedHostName": String,
    "PeriodUnit": String,
    "AutoReleaseTime": String,
    "Description": String,
    "AutoPlacement": String,
    "Tags": List,
    "AutoRenewPeriod": Number,
    "ActionOnMaintenance": String,
    "Period": Number,
    "AutoRenew": String,
    "NetworkAttributesSlbUdpTimeout": Integer,
    "ChargeType": String,
    "ResourceGroupId": String,
    "DedicatedHostClusterId": String,
    "MinQuantity": Integer,
    "CpuOverCommitRatio": Number,
    "ZoneId": String,
    "NetworkAttributesUdpTimeout": Integer,
    "Quantity": Integer
  }
}

属性

属性名称	类型	必须	允许更新	描述	约束
DedicatedHostType	String	是	否	专有宿主机的类型。	无
DedicatedHostName	String	否	否	专有宿主机的名称。	长度为2~128个字符。必须以英文字母或汉字开头，不能以`http://`或`https://`开头。可包含英文字母、汉字、数字、半角冒号（:）、下划线（_）和短划线（-）。
PeriodUnit	String	否	否	续费单位。	取值： Week Month（默认值） Year
AutoReleaseTime	String	否	否	自动释放时间。	如果不指定AutoReleaseTime参数，表示取消自动释放，专有宿主机在预约时间点不再自动释放。自动释放时间最短不能晚于当前时间半小时内，最长不能超过当前时间三年以后。如果秒（`ss`）取值不是 `00`，则自动取当前分钟（`mm`）开始时刻。
Description	String	否	否	专有宿主机的描述。	无
AutoRenewPeriod	Number	否	否	单次自动续费的周期。	取值：1、2、3、6、12。单位：月。
Period	Number	否	否	预付费时长。	取值： PeriodUnit=Week时：1、2、3。 PeriodUnit=Month时：1、2、3、4、5、6、7、8、9。 PeriodUnit=Year时：1、2、3、4、5。
DedicatedHostClusterId	String	否	否	专有宿主机集群 ID。	无
MinQuantity	Integer	否	否	指定专有宿主机的最小购买数量。	取值范围：1~100。
CpuOverCommitRatio	Number	否	否	CPU 超卖比。	仅自定义规格 g6s、c6s、r6s 支持设置 CPU 超卖比。取值范围：1~5。 CPU 超卖比影响 DDH 的可用 vCPU 数，一台 DDH 的可用 vCPU 数=物理 CPU 核数2CPU 超卖比。例如，g6s 的物理 CPU 核数为 52，如果设置 CPU 超卖比为 4，则 DDH 创建完成后 vCPU 总数显示为 416。针对 CPU 绝对稳定性要求不严苛或 CPU 负载不高的场景，例如开发测试环境，提升超卖比可以提升可用 vCPU 数，用于部署更多同等规格的 ECS 实例，降低单位部署成本。
ZoneId	String	否	否	专有宿主机所属的可用区ID。	默认值：空，表示由系统选择。
AutoRenew	String	否	否	是否自动续费预付费的专有宿主机。	取值： True False（默认值）
ChargeType	String	否	否	专有宿主机的计费方式。	取值： PrePaid：预付费，即包年包月。选择预付费时，请确认您的支付方式支持余额或者信用额度支付，否则会提示 `InvalidPayMethod`。 PostPaid：按量付费。
AutoPlacement	String	否	否	专有宿主机是否加入自动部署资源池。	取值： on（默认值）：专有宿主机加入自动部署资源池。 off：专有宿主机不加入自动部署资源池。当您在专有宿主机上创建实例，却不指定DedicatedHostId时，阿里云将自动从加入资源池的专有宿主机中，为您选取适合的宿主机部署实例。更多信息，请参见功能特性。
Tags	List	否	否	用户自定义标签。	最多支持20个标签，格式：`[{"Key": "tagKey", "Value": "tagValue"},{"Key": "tagKey2", "Value": "tagValue2"}]`。更多信息，请参见Tags属性。
ActionOnMaintenance	String	否	否	当专有宿主机发生故障或者在线修复时，为其所宿实例设置迁移方案。	取值： Migrate：迁移实例到其他物理机并重新启动实例。 Stop：在当前专有宿主机上停止实例，确认无法修复专有宿主机后，迁移实例到其他物理机并重新启动实例。当专有宿主机上挂载云盘存储时默认值为Migrate，当专有宿主机上挂载本地盘存储时默认值为Stop。
NetworkAttributesSlbUdpTimeout	Integer	否	否	负载均衡连接的UDP会话超时时间。	取值范围：15~310。单位：秒。
ResourceGroupId	String	否	是	专有宿主机要加入的资源组ID。	无
NetworkAttributesUdpTimeout	Integer	否	否	为专有宿主机上运行的云服务设置用户访问的UDP会话超时时间。	取值范围：15~310。单位：秒。
Quantity	Integer	否	否	本次创建的专有宿主机的数量。	取值范围：1~100。默认值：1。

Tags语法

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

Tags属性

属性名称	类型	必须	允许更新	描述	约束
Key	String	是	否	标签键。	长度为1~128个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://` 。
Value	String	否	否	标签值。	长度为0~128个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://` 。

返回值

Fn::GetAtt

OrderId：订单ID。
DedicatedHostIds：主机ID列表。
Arn：阿里云资源名称。

示例

YAML

ROSTemplateFormatVersion: '2015-09-01'
Description: Test ECS DedicatedHost
Parameters:
  DedicatedHostType:
    Type: String
    Default: ddh.g6
  DedicatedHostName:
    Type: String
    Default: mytest
Resources:
  DedicatedHost:
    Type: ALIYUN::ECS::DedicatedHost
    Properties:
      DedicatedHostType:
        Ref: DedicatedHostType
      DedicatedHostName:
        Ref: DedicatedHostName
      ChargeType: PostPaid
Outputs:
  OrderId:
    Value:
      Fn::GetAtt:
        - DedicatedHost
        - OrderId
  DedicatedHostIds:
    Value:
      Fn::GetAtt:
        - DedicatedHost
        - DedicatedHostIds

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": "Test ECS DedicatedHost",
  "Parameters": {
    "DedicatedHostType": {
      "Type": "String",
      "Default": "ddh.g6"
    },
    "DedicatedHostName": {
      "Type": "String",
      "Default": "mytest"
    }
  },
  "Resources": {
    "DedicatedHost": {
      "Type": "ALIYUN::ECS::DedicatedHost",
      "Properties": {
        "DedicatedHostType": {
          "Ref": "DedicatedHostType"
        },
        "DedicatedHostName": {
          "Ref": "DedicatedHostName"
        },
        "ChargeType": "PostPaid"
      }
    }
  },
  "Outputs": {
    "OrderId": {
      "Value": {
        "Fn::GetAtt": [
          "DedicatedHost",
          "OrderId"
        ]
      }
    },
    "DedicatedHostIds": {
      "Value": {
        "Fn::GetAtt": [
          "DedicatedHost",
          "DedicatedHostIds"
        ]
      }
    }
  }
}