专属服务器DCC

    专属服务器创建

    专属服务器创建

    • 本接口用于创建一个或多个同配置的专属服务器。

    请求结构

    POST /v{version}/dedicatedHost?clientToken={clientToken} HTTP/1.1
    Host: dcc.bj.baidubce.com
    Authorization: authorization string
    
    {
        "vCpu": vCpu,  //cpu虚拟化核数
        "name": "name",  //专属服务器名称
        "flavorName": "flavorName",  //套餐类型:"C01"
        "purchaseCount": purchaseCount,  //购买数目,最小1
        "billing":{
            "paymentTiming": paymentTiming,  //付款时间,预付费(Prepaid)和后支付(Postid)
            "reservation": {
                "reservationLength": reservationLength  //购买时长,最小1
            }
        },
        "zoneName": zoneName   //zone信息,默认为空
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号
    clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串)。
    vCpu int RequestBody参数 待创建专属服务器虚拟CPU核数,数量不能超过物理CPU核数的两倍
    flavorName String RequestBody参数 套餐类型,可选计算型(calculation)C01/C02,可选大数据机型(storage)S01/S02
    purchaseCount int RequestBody参数 批量创建(购买)的虚专属服务器个数,必须为大于0的整数,可选参数,缺省为1
    name String RequestBody参数 专属服务器名字(可选)。默认都不指定name。如果指定name:批量时name作为名字的前缀。后端将加上后缀,后缀生成方式:name{ -序号}。如果没有指定name,则自动生成,方式:{instance-八位随机串-序号}。注:随机串从0~9a~z生成;序号按照count的数量级,依次递增,如果count为100,则序号从000~100递增,如果为10,则从00~10递增
    billing Billing RequestBody参数 订单、计费相关参数
    zoneName String RequestBody参数 指定zone信息,默认为空,由系统自动选择

    返回头域

    除公共头域,无其它特殊头域。

    返回参数

    参数名称 类型 描述
    dedicatedHostIds List<String> 专属服务器ID的集合,其中ID符合BCE规范,必须是一个定长字符串,且只允许包含大小写字母、数字、连字号(-)和下划线(_)。

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    dedicatedHost.dedicatedHostBeBanned The dedicatedHost is banned, contact technical support for assistance. 403 DCC服务已被封禁
    dedicatedHost.GlobalhostQuotaLimitExceeded Quota exceeds limit for regional prepaid dedicatedHost pool, contact technical support for further assistance. 413 预付费类型的专属服务器数目超出当前区域预售额度限制
    dedicatedHost.dedicatedHostQuotaLimitExceeded Quota exceeds limit. 413 专属服务器个数超过限制

    请求示例

    POST /v1/dedicatedHost?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
    Host: dcc.bj.baidubce.com
    ContentType: application/json    
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    
    {
        "cCpu": 22,  //cpu虚拟化核数
        "flavorName": "C01",  //套餐配置:"C01"
        "purchaseCount": 1,  //购买数目,最小1
        "billing":{
            "paymentTiming": "prepaid",  //付款时间,预付费(Prepaid)和后支付(Postid)
            "reservation": {
                "reservationLength": 1 //购买时长,最小1
            }
        }
    }

    返回示例

    HTTP/1.1 200 OK
    x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
    Date: Wed, 03 Dec 2014 06:42:19 GMT
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    
    {
        "dedicatedHostIds": [
            "d-qw2Pf3wB"
        ]
    }
    上一篇
    专属服务器续费
    下一篇
    专属服务器绑定标签