AllocateDedicatedHosts_云服务器 ECS_API调试-阿里云OpenAPI开发者门户

接口说明

创建专有宿主机前，您可以调用 DescribeAvailableResource 查看指定地域或者可用区内的资源供给情况。

创建专有宿主机会产生费用，建议您提前了解资源的计费方式。更多详情，请参见计费概述。

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

请求参数

字段名称	字段详情
RegionIdstring	专有宿主机所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
Tagarray<object>	标签列表。子级条数 <= 20
ResourceGroupIdstring	专有宿主机要加入的资源组 ID。示例值:rg-bp67acfmxazb4ph***参考取值来源: DescribeSecurityGroups
ZoneIdstring	专有宿主机所属的可用区编号。展开详情示例值:cn-hangzhou-f参考取值来源: DescribeZones
DedicatedHostNamestring	专有宿主机的名称。长度为 2~128 个字符，支持 Unicode 中 letter 分类下的字符（其中包括英文、中文和数字等）。可以包含半角冒号（:）、下划线（_）、半角句号（.）或者短划线（-）。示例值:myDDH参考取值来源: DescribeDedicatedHosts
DedicatedHostClusterIdstring	专有宿主机所属的专有宿主机集群 ID。示例值:dc-bp12wlf6am0vz9v2****参考取值来源: CreateDedicatedHostCluster DescribeDedicatedHostClusters
DedicatedHostTypestring	专有宿主机的规格。您可以调用 DescribeDedicatedHostTypes 接口获得最新的专有宿主机规格表。示例值:ddh.c5参考取值来源: DescribeDedicatedHostTypes
ActionOnMaintenancestring	当专有宿主机发生故障或者在线修复时，为其所宿实例设置迁移方案。取值范围：展开详情示例值:Migrate参考取值来源: DescribeInstanceMaintenanceAttributes
NetworkAttributes.SlbUdpTimeoutinteger<int32>	负载均衡连接的 UDP 会话超时时间，单位：秒。取值范围：15~310。示例值:60
NetworkAttributes.UdpTimeoutinteger<int32>	为专有宿主机上运行的云服务设置用户访问的 UDP 会话超时时间，单位：秒。取值范围：15~310。示例值:60
Descriptionstring	专有宿主机的描述。长度为 2~256 个英文或中文字符，不能以`http://`或`https://`开头。示例值:This-is-my-DDH
AutoPlacementstring	专有宿主机是否加入自动部署资源池。当您在专有宿主机上创建实例，却不指定 DedicatedHostId 时，阿里云将自动从加入资源池的专有宿主机中，为您选取适合的宿主机部署实例，更多信息，请参见自动部署功能介绍。取值范围：展开详情示例值:off
CpuOverCommitRationumber<float>	CPU 超卖比。仅自定义规格 g6s、c6s、r6s 支持设置 CPU 超卖比。取值范围：1~5。展开详情示例值:1
MinQuantityinteger<int32>	指定专有宿主机的最小购买数量。取值范围：1~100。展开详情示例值:2
ChargeTypestring	专有宿主机的计费方式。取值范围：展开详情示例值:PrePaid
Quantityinteger<int32>	本次创建的专有宿主机的数量。取值范围：1~100。展开详情示例值:2
Periodinteger<int32>	购买专有宿主机的包年包月时长。当参数`ChargeType`取值为`PrePaid`时，`Period`参数方可生效并为必选参数。取值范围：展开详情示例值:6
PeriodUnitstring	购买专有宿主机的时长单位。取值范围：展开详情示例值:Month
AutoRenewboolean	是否自动续费包年包月专有宿主机。展开详情示例值:false
AutoRenewPeriodinteger<int32>	单次自动续费的周期。当参数 AutoRenew 为 true 时，AutoRenewPeriod 参数方可生效，并为必选参数。取值范围：展开详情示例值:1
AutoReleaseTimestring	专有宿主机自动释放时间。需按照 ISO 8601 标准表示，并使用 UTC+0 时间，格式为`yyyy-MM-ddTHH:mm:ssZ`。展开详情示例值:2019-08-21T12:30:24Z
ClientTokenstring	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。示例值:123e4567-e89b-12d3-a456-426655440000

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:E2A664A6-2933-4C64-88AE-5033D003****
DedicatedHostIdSetsobject
OrderIdstring	订单 ID。展开详情示例值:23841229****

变更历史

	变更时间	变更内容概要	操作
	2025-03-18	变更请求参数ActionOnMaintenance
	2025-02-24	变更返回参数
	2025-02-20	删除返回参数
	2023-09-04	变更错误码404

1
2
10 条/页