调用AllocateDedicatedHosts创建一台或多台按量付费或者包年包月专有宿主机。专有宿主机是单租户独享的物理机资源，您可以在专有宿主机上自行创建ECS实例和获取物理服务器属性等信息。接口说明调试您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。授权信息下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：操作：是指具体的权限点。访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。资源类型：是指操作中支持授权的资源类型。具体说明如下：对于必选的资源类型，用背景高亮的方式表示。对于不支持资源级授权的操作，用全部资源表示。条件关键字：是指云产品自身定义的条件关键字。关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。操作访问级别资源类型条件关键字关联操作ecs:AllocateDedicatedHostscreateDedicatedHost无无请求参数名称类型必填描述示例值RegionIdstring是cn-hangzhouTagarray<object>否object否Keystring否EnvironmentValuestring否ProductionResourceGroupIdstring否rg-bp67acfmxazb4ph***ZoneIdstring否cn-hangzhou-fDedicatedHostNamestring否myDDHDedicatedHostClusterIdstring否dc-bp12wlf6am0vz9v2****DedicatedHostTypestring是ddh.c5ActionOnMaintenancestring否MigrateNetworkAttributes.SlbUdpTimeoutinteger否60NetworkAttributes.UdpTimeoutinteger否60Descriptionstring否This-is-my-DDHAutoPlacementstring否offCpuOverCommitRatiofloat否1MinQuantityinteger否2ChargeTypestring否PrePaidQuantityinteger否2Periodinteger否6PeriodUnitstring否MonthAutoRenewboolean否 默认值：false。falseAutoRenewPeriodinteger否1AutoReleaseTimestring否2019-08-21T12:30:24ZClientTokenstring否123e4567-e89b-12d3-a456-426655440000返回参数RequestIdstringE2A664A6-2933-4C64-88AE-5033D003****DedicatedHostIdSetsarraystringdh-bp67acfmxazb4d****示例正常返回示例JSON格式{ "RequestId": "E2A664A6-2933-4C64-88AE-5033D003****", "DedicatedHostIdSets": { "DedicatedHostId": [ "dh-bp67acfmxazb4d****" ] } }错误码HTTP status code错误码错误信息描述400InvalidInstanceType.ValueUnauthorizedThe specified InstanceType is not authorized.指定的实例规格未授权使用。400InvalidDescription.MalformedThe specified parameter "Description" is not valid.指定的资源描述格式不合法。长度为2-256个字符，不能以http://和https://开头。400InvalidParameter.ConflictThe specified region and cluster do not match.指定的地域与指定的集群不匹配。400InvalidAutoRenewPeriod.ValueNotSupportedThe specified autoRenewPeriod is not valid.指定的参数 AutoRenewPeriod 不合法。400InvalidTagKey.MalformedThe specified Tag.n.Key is not valid.指定的标签键参数有误。400InvalidDedicatedHostType.ValueNotSupported%s指定的专有宿主机类型无效。400RegionUnauthorized%s该地域未被授权。%s为变量，将根据调用API的实际情况动态返回错误信息。400Zone.NotOnSale%s该可用区暂时关闭了售卖。%s为变量，将根据调用API的实际情况动态返回错误信息。400OperationDeniedThe specified DedicatedHostType or Zone is not available or not authorized.指定宿主机规格、可用区不可用或者没有操作的权限。400InvalidPeriodUnit.ValueNotSupportedThe specified parameter PeriodUnit is not valid.参数 PeriodUnit 无效。400InvalidTagValue.MalformedThe specified Tag.n.Value is not valid.指定的标签值参数有误。400QuotaExceed.AfterpayDedicatedHostThe maximum number of Pay-As-You-Go DedicatedHosts is exceeded: %s按量付费的宿主机库存不足，请减少创建数量。400InvalidChargeType.ValueNotSupportedChargeType is not valid付费类型无效。400InvalidParameter.SlbUdpTimeoutThe specified value is invalid.指定的参数 SlbUdpTimeout 无效。400InvalidParameter.UdpTimeoutThe specified value is invalid.指定的参数 UdpTimeout 无效。400Duplicate.TagKeyThe Tag.N.Key contain duplicate key.标签中存在重复的键，请保持键的唯一性。400InvalidParameter.QuantityThe specified Quantity is invalid.-400InvalidDedicatedHostPrice.NotFoundThe specified Dedicated price is not found.-400InvalidDedicatedHostType.CpuOverCommitRatioNotSupported%s-400InvalidCpuOverCommitRatio.ValueNotSupported%s-400InvalidDedicatedHostType.ValueNotSupportedThe specified HostType does not exist or beyond the permitted range.指定的宿主机规格不合法（超出可选范围）。403OperationDeniedThe creation of Host to the specified Zone is not allowed.无法在指定可用区创建专用宿主机。403OperationDenied.NoStockThe requested resource is sold out in the specified zone; try other types of resources or other regions and zones.库存不足。403OperationDeniedSales of this resource are temporarily suspended in the specified region; please try again later.指定的地域暂时关闭了此资源的售卖，请稍后重试。403NodeControllerUnavailableThe Node Controller is temporarily unavailable.节点控制器暂不可用。403OperationDeniedThe resource is out of usage.该实例不在运行状态，请您启动实例或检查操作是否合理。403InvalidParameter.ResourceOwnerAccountResourceOwnerAccount is Invalid.指定的 ResourceOwnerAccount 不合法。403InvalidUserData.ForbiddenUser not authorized to input the parameter "UserData", please apply for permission "UserData"-403Zone.NotOpenThe specified zone is not granted to you to buy resources yet.用户未被授权购买指定的可用区的资源。403Zone.NotOnSaleThe specified zone is not available for purchase.指定可用区已经售罄，请您更换实例规格或者更换地域创建。403InvalidResourceType.NotSupported%s-403InvalidDedicatedHostType.ValueNotSupportedThe specified DedicatedHostType does not exist or beyond the permitted range.指定的宿主机规格不存在。403InvalidDedicatedHostType.ZoneNotSupportedThe specified zone does not support this dedicatedHostType.指定可用区不支持指定宿主机规格。403InvalidUserData.Base64FormatInvalidThe specified UserData is not valid指定的UserData参数编码出错403InvalidParameter.NotMatch%s您输入的参数无效，请检查参数之间是否冲突。403Account.ArrearageYour account has been in arrears.账户余额不足，请先充值再操作。404InvalidZoneId.NotFoundThe ZoneId provided does not exist in our records.指定的可用区 ID 不存在。404OperationDeniedAnother Host has been creating另一个宿主机正在创建。404PaymentMethodNotFoundNo payment method has been registered on the account.账户尚未注册支付方式。404InvalidDedicatedHostName.MalformedThe specified parameter DedicatedHostName is not valid.指定的参数 DedicatedHostName 无效。404InvalidZoneId.NotFoundThe specified ZoneId does not exist.指定的可用区 ID 不存在。404InvalidDedicatedHostClusterId.NotFoundThe specified DedicatedHostClusterId does not exist.-404InvalidDedicatedHostClusterId.ExceedMaxSizeThe specified Dedicated Host Cluster exceeded max capacity.-404InvalidParameter.ActionOnMaintenanceThe specified ActionOnMaintenance does not exist.指定的迁移方案不存在。500InternalErrorThe request processing has failed due to some unknown error.内部错误，请重试。500InternalError%s内部错误。访问错误中心查看更多错误码。变更历史变更时间变更内容概要操作2023-09-04OpenAPI 错误码发生变更查看变更详情