产品文档

专有宿主机

allocDedicatedHosts

描述

创建一台或多台指定机型的专有宿主机。

详细操作说明请参考帮助文档:创建专有宿主机

接口说明

  • 创建专有宿主机必须指定专有资源池。

请求方式

POST

请求地址

https://dh.jdcloud-api.com/v1/regions/{regionId}/dedicatedHosts

名称 类型 是否必需 示例值 描述
regionId String cn-north-1 地域ID

请求参数

名称 类型 是否必需 示例值 描述
dedicatedHostSpec DedicatedHostSpec 描述专有宿主机配置
deployPolicy String preferred 是否支持AZ内专有宿主机强制均衡,可选值:
preferred:(默认值)非强制
required:强制]
maxCount Integer 1 购买云主机的数量;取值范围:[1,100],默认为1。
clientToken String 用于保证请求的幂等性。由客户端生成,长度不能超过64个字符。

DedicatedHostSpec

名称 类型 是否必需 示例值 描述
dedicatedPoolId String pool-p2a****u0c 专有资源池ID,创建专有宿主机必须指定专有资源池ID
az String 专有宿主机所属的可用区,不传入该参数时可用区属性从专有宿主机池中继承;指定的可用区必须是对应专有宿主机池中设置的可用区的子集
name String dh-name 专有宿主机名称
description String 专有宿主机描述
charge ChargeSpec 计费配置。
专有宿主机不支持按用量方式计费,默认为按配置计费。

ChargeSpec

名称 类型 是否必需 示例值 描述
chargeMode String postpaid_by_duration 计费模式,取值为:
prepaid_by_duration:预付费
postpaid_by_duration:(默认值)按配置
请参阅具体产品线帮助文档确认该产品线支持的计费类型
chargeUnit String 预付费计费单位,预付费必填,当chargeMode为prepaid_by_duration时有效,取值为:month、year,默认为month
chargeDuration Integer 预付费计费时长,预付费必填,当chargeMode取值为prepaid_by_duration时有效。当chargeUnit为month时取值为:1~9,当chargeUnit为year时取值为:1、2、3
autoRenew Boolean True:开通自动续费、False:(默认值)不开通自动续费
buyScenario String 产品线统一活动凭证JSON字符串,需要BASE64编码,目前要求编码前格式为 {"activity":{"activityType":必填字段, "activityIdentifier":必填字段}}

返回参数

名称 类型 示例值 描述
result Result 响应结果
requestId String c2hmmaan8w06w19qcdfuic4w03f7ft2d 请求ID

Result

名称 类型 示例值 描述
dedicatedHostIds String[ ] ["host-eummd6","host-y5nh9w"] 专有宿主机ID列表

请求示例

POST

/v1/regions/cn-north-1/dedicatedHosts
{
  "dedicatedHostSpec":{
     "dedicatedPoolId":"pool-p2a****u0c",
     "name":"dh-name"
  },
  "maxCount":1
}

返回示例

{
    "result":{
    "dedicatedHostIds":[
      "host-eumm****d6",
      "host-y5nh****9w"
    ]
  },
    "requestId": "a0633f72670e59f8c6db36b1ee257011"
}

返回码

返回码 描述
200 OK
400 Invalid parameter
401 Authentication failed
404 Not found
429 Quota exceeded
500 Internal server error
503 Service unavailable
更新时间:2022-02-21 19:12:23
feedback