调用AllocateDedicatedHosts创建一台或多台按量付费或者包年包月专有宿主机。专有宿主机是由单租户独享的物理机资源,您可以在专有宿主机上自行创建ECS实例和获取物理服务器属性信息等。

描述

创建专有宿主机前,您可以调用DescribeAvailableResource查看指定地域或者可用区内的资源供给情况。创建专有宿主机会产生费用,建议您提前了解资源的计费方式。更多详情,请参见计费概述

  • 单次最多能创建100台包年包月或者按量付费专有宿主机。
  • 创建成功后,您可以将返回的专有宿主机ID列表作为请求参数,调用DescribeDedicatedHosts查询新建专有宿主机状态。
  • 新建专有宿主机状态为可用Available)时,即可在宿主机上创建ECS实例。专有宿主机状态详情,请参见生命周期
  • 提交创建专有宿主机的请求后,指定的参数值不合规或者库存不足时会报错。具体报错原因,请参见错误码
  • 创建专有宿主机后,您可以通过ModifyInstanceDeployment将ECS实例从共享宿主机迁移到专有宿主机,也可以在两台专有宿主机上调整ECS实例部署。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值 :AllocateDedicatedHosts
RegionId String 专有宿主机所属的地域ID。您可以调用DescribeRegions接口查看最新的阿里云地域列表。
DedicatedHostType String 专有宿主机规格。您可以调用DescribeDedicatedHostTypes接口获取最新的专有宿主机规格表 。
Quantity Integer 本次创建的专有宿主机的数量。取值范围:1~100

默认值:1

ZoneId String 专有宿主机所属的可用区编号。

默认值:空,表示由系统选择。

DedicatedHostName String 专有宿主机的名称。

长度为2~128个大小写英文或中文字符,必须以大小字母或中文开头,可包含数字、点号(.)、半角冒号(:)、下划线(_)或连字符(-)。

Description String 专有宿主机的描述。长度为2~256个英文或中文字符,不能以http://和https://开头。
ChargeType String 专有宿主机的计费方式。取值范围:
  • PrePaid:包年包月。选择包年包月时,请确认您的支付方式支持余额或者信用额度支付,否则会提示InvalidPayMethod
  • PostPaid(默认):按量付费。
Period Integer 设置购买专有宿主机的包年包月时长,单位:月。取值范围:1~9 | 12 | 24 | 36
说明 当参数ChargeType取值为PrePaid时,Period参数方可生效并为必填参数。
AutoRenew Boolean 是否自动续费包年包月专有宿主机。取值范围:true | false(默认)
说明 当参数ChargeType取值为PrePaid时,AutoRenew参数方可生效。
AutoRenewPeriod Integer 单次自动续费的周期,单位:月。取值范围:1 | 2 | 3 | 6 | 12
说明 当参数AutoRenewtrue 时,AutoRenewPeriod参数方可生效并为必填参数。
AutoReleaseTime String 设置按量付费专有宿主机的自动释放时间。格式:yyyy-MM-ddTHH:mm:ssZ
说明
  • 需按照ISO8601标准表示,并使用UTC时间。
  • 若参数值中的秒不是00,则自动取为00。
  • 最短设置为当前时间之后半小时, 最长不能超过当前时间之后三年。
ActionOnMaintenance String 当专有宿主机发生故障或者在线修复时,为专有宿主机上的ECS实例设置迁移方案。取值范围:
  • Migrate:迁移ECS实例到其他专有宿主机并重新启动实例。

    默认值:Migrate(专有宿主机上挂载的是云盘存储时)

  • Stop:在当前专有宿主机上停止实例,确认无法修复专有宿主机后,迁移实例到其他专有宿主机并重新启动实例。

    默认值:Stop(专有宿主机上挂载的是本地盘存储时)

NetworkAttributes.SlbUdpTimeout Integer 负载均衡连接的UDP会话超时时间,单位:秒。取值范围:15~310
NetworkAttributes.UdpTimeout Integer 为专有宿主机上运行的云服务设置用户访问的UDP会话超时时间,单位:秒。取值范围:15~310
Tag.n.Key String 专有宿主机的标签键。n的取值范围:1~20。一旦传入该值,则不允许为空字符串。最多支持128个字符,不能以aliyun、acs:、http://或者https://开头。
Tag.n.Value String 专有宿主机的标签值。n的取值范围:1~20。一旦传入该值,可以为空字符串。最多支持128个字符,不能以aliyun、acs:、http://或者https://开头。
ResourceGroupId String 专有宿主机要加入的资源组ID。
ClientToken String 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。只支持ASCII字符,且不能超过64个字符。更多详情,请参见如何保证幂等性

返回参数

名称 类型 描述
DedicatedHostIdSets Array of DedicatedHostId 专有宿主机ID(DedicatedHostId)组成的列表。

示例

请求示例
https://ecs.aliyuncs.com/?Action=AllocateDedicatedHosts
&RegionId=cn-hangzhou
&DedicatedHostType=ddh.sn1ne
&Quantity=2
&<公共请求参数>
返回示例
  • XML格式
    <AllocateDedicatedHostsResponse>
      <RequestId>192C4203-ED9E-4BCD-847D-482995C01728</RequestId>
      <DedicatedHostIdSets>
        <DedicatedHostId>dh-dedicatedhost1</DedicatedHostId>
        <DedicatedHostId>dh-dedicatedhost2</DedicatedHostId>
      </DedicatedHostIdSets>
    </AllocateDedicatedHostsResponse>
  • JSON格式
    {
        "RequestId":"E2A664A6-2933-4C64-88AE-5033D003EADF",
        "DedicatedHostIdSets":{
            "DedicatedHostId":[
                "dh-dedicatedhost1",
                "dh-dedicatedhost2"
            ]
        }
    }

错误码

错误代码 错误信息 HTTP 状态码 说明
Account.Arrearage Your account has an outstanding payment. 400 您的账号已欠费。
InvalidChargeType.ValueNotSupported ChargeType is not valid. 400 您指定的ChargeType无效。
InvalidDedicatedHostName.Malformed The specified parameter DedicatedHostName is not valid. 400 您指定的DedicatedHostName格式无效。
InvalidDescription.Malformed The specified parameter Description is not valid. 400 您指定的Description格式无效。
MissingParamter The specified parameter Period can’t be null 400 当参数ChargeType取值为PrePaid时,Period为必填参数。
OperationDenied Sales of this resource are temporarily suspended in the specified region; please try again later. 400 指定地域暂时停售专有宿主机。
OperationDenied.NoStock Sales of this resource are temporarily suspended in the specified region; please try again later. 400 专有宿主机库存不足,请尝试其它资源类型或者切换可用区。
QuotaExceed.AfterpayDedicatedHost Living afterpay dedicated host quota exceeded. 400 您已超过专有宿主机的使用配额。
Zone.NotOnSale The specified zone is not available for purchase. 400 指定可用区无法创建专有宿主机。
Forbbiden User not authorized to operate on the specified resource. 403 您未被授权创建专有宿主机。
RegionUnauthorized User has no authority to create instance in the specified region. 403 您未被授权使用指定地域。
Zone.NotOpen The specified zone is not granted to you to buy resources yet. 403 您未被授权在指定可用区内创建专有宿主机。
InvalidDedicatedHostChargeType.NotFound The DedicatedHostChargeType does not exist in our records. 404 指定的ChargeType不存在。