专属服务器DCC

    创建专属实例

    创建专属实例

    描述

    本接口用于在专属服务器上创建专属实例。在创建专属实例时,以下操作可能与您的业务相关:

    • 专属实例不参与计费。
    • 本接口用于创建一个或多个专属实例。
    • 支持批量创建,且如果创建过程中有一个专属实例创建失败,所有实例将全部回滚,均创建失败,如果创建时包含CDS,CDS也会回滚。
    • 专属实例支持创建、添加本地磁盘。
    • 本地磁盘不支持挂载、卸载、删除。
    • DCC允许用户自定义专属实例的cpu和内存等参数,所创建的专属实例资源将会使用DCC的资源。
    • 专属实例只能通过ephemeralDisks创建临时盘并指定磁盘类型。
    • 专属实例支持用户自定义安全组和子网,两者需要同时指定在同一个VPC下。如果未指定安全组和子网,在创建专属实例时会自动加入系统默认的安全组和子网内。

    请求结构

            POST /v{version}/dedicatedHost/instance?clientToken={clientToken} HTTP/1.1
            Host: dcc.bj.baidubce.com
            Authorization: authorization string
            {
                "instanceType": instanceType,
                "cpuCount": cpuCoreCount,
                "memoryCapacityInGB": memoryCapacityInGB,
                "ephemeralDisks": [
                    {
                        "storageType": storageType,
                        "sizeInGB": size
                    },
                    {
                        "storageType": storageType,
                        "sizeInGB": size
                    }
                ],
                "createCdsList": [
                    {
                        "storageType": storageType,
                        "cdsSizeInGB": cdsSizeInGB
                    }
                ],
                "name": "name",
                "imageId": "imageId",
                "localDiskSizeInGB": localDiskSizeInGB,
                "networkCapacityInMbps": networkCapacityInMbps,
                "dedicatedHostId": dedicatedHostId,
                "purchaseCount": purchaseCount,
                "billing":{
                    "paymentTiming": paymentTiming,
                    "reservation": {
                        "reservationLength": reservationLength
                    }
                },
                "zoneName": zoneName,
                "subnetId": subnetId,
                "securityGroupId": securityGroupId
            }

    请求头域

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

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号
    clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串。
    imageId String RequestBody参数 待创建虚拟机实例的镜像ID,可通过调用查询镜像列表接口选择获取所需镜像ID。
    billing Billing RequestBody参数 订单、计费相关参数
    instanceType String RequestBody参数 待创建虚拟机实例的类型,具体可选类型参见下述InstanceType,为空时使用默认虚机类型。
    cpuCount int RequestBody参数 待创建虚拟机实例的CPU核数,可选配置请参考区域机型以及可选配置
    memoryCapacityInGB int RequestBody参数 待创建虚拟机实例的内存容量,单位GB,可选配置请参考区域机型以及可选配置
    rootDiskSizeInGb int RequestBody参数 待创建虚拟机实例的系统盘大小,单位GB,默认是40GB,范围为[40, 100]GB,超过40GB按照云磁盘价格收费。注意指定的系统盘大小需要满足所使用镜像最小磁盘空间限制。
    rootDiskStorageType String RequestBody参数 待创建虚拟机实例系统盘介质,默认使用SSD型云磁盘,可指定系统盘磁盘类型可参见StorageType
    localDiskSizeInGB int RequestBody参数 [已废弃]待创建虚拟机实例的临时数据盘大小(不含系统盘,系统盘为免费赠送),单位为GB,大小为0~500G,请采用ephemeralDisks字段。
    ephemeralDisks List<EphemeralDisk> RequestBody参数 DCC实例可以创建多块本地盘,需要指定磁盘类型以及大小。其他类型BCC最多只能使用一块本地盘,使用默认磁盘类型,需要指定磁盘大小。FPGA实例以及GPU实例默认使用一块本地磁盘,根据配置指定本地盘大小,具体请参考GPU型BCC可选规格配置 以及FPGA型BCC可选规格配置
    createCdsList List<CreateCdsModel> RequestBody参数 待创建的CDS磁盘列表,具体数据格式参见下述CreateCdsModel
    networkCapacityInMbps int RequestBody参数 公网带宽,单位为Mbps。必须为0~200之间的整数,为0表示不分配公网IP,默认为0Mbps
    internetChargeType String RequestBody参数 公网带宽计费方式,可选参数详见internetChargeType,若不指定internetChargeType,默认付费方式同BCC,预付费默认为包年包月按带宽,后付费默认为按使用带宽计费。
    dedicatedHostId String RequestBody参数 专属服务器id,指定虚机置放位置时指定该值。
    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递增。支持大小写字母、数字、中文以及-_ /.特殊字符,必须以字母开头,长度1-65。
    adminPass String RequestBody参数 待指定的实例管理员密码,8-16位字符,英文,数字和符号必须同时存在,符号仅限!@#$%*(),密码需要加密传输,详见链接
    zoneName String RequestBody参数 zoneName命名规范是“国家-region-可用区序列",小写,例如北京可用区A为"cn-bj-a"。专属实例使用专属服务器所在zone,无需指定该字段。
    subnetId String RequestBody参数 指定subnet信息,为空时将使用默认子网
    securityGroupId String RequestBody参数 指定securityGroup信息,为空时将使用默认安全组
    gpuCard String RequestBody参数 待创建实例所要携带的GPU卡信息,具体可选信息参照GpuType,非GPU型实例无需指定此字段
    fpgaCard String RequestBody参数 待创建实例所要携带的FPGA卡信息,具体可选信息参照FpgaType,非FPGA型实例无需指定此字段
    cardCount String RequestBody参数 待创建实例所要携带的GPU卡FPGA卡数量,仅在gpuCard或fpgaCard字段不为空时有效,且需要满足GPU型BCC可选规格配置 以及FPGA型BCC可选规格配置

    返回头域

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

    返回参数

    参数名称 类型 描述
    instanceIds List 虚机实例ID的集合,其中ID符合BCE规范,必须是一个定长字符串,且只允许包含大小写字母、数字、连字号(-)和下划线(_)。

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    Instance.InsufficientRootDiskSize Not enough root disk size. 400 使用镜像过大,系统盘大小不够
    Instance.InvalidateRootDiskStorageType Invalidate root disk storage type. 400 无效的系统盘介质
    Instance.InstanceBeBanned The instance is banned, contact technical support for assistance. 403 Bcc服务已被封禁
    Instance.GlobalInstanceQuotaLimitExceeded Quota exceeds limit for regional postpaid instances pool, contact technical support for further assistance. 413 后付费类型的虚机数目超出当前区域预售额度限制
    Instance.InstanceQuotaLimitExceeded Quota exceeds limit. 413 实例个数超过限制
    Instance.EipQuotaLimitExceeded The number of eip will exceed the limit. 413 合并购买时eip个数超过限制
    Instance.InvalidateConfiguration Invalidate cpu memory configuration. 400 无效的虚机配置

    请求示例

            POST /v1/dedicatedHost/instance?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
            Host: dcc.bj.baidubce.com
            ContentType: application/json
            Authorization: bce-auth-v1/4e69d28643af46dea51fef90e221eb17/2019-02-12T09:21:27Z/1800/host;x-bce-date/a582637d5d092ac735a88756ddf3274425fb497f0bcc5cd0e425740d24838be0
            {
                "cpuCount": 1,
                "memoryCapacityInGB": 1,
                "ephemeralDisks": [
                    {
                        "storageType": "ssd",
                        "sizeInGB": 40
                    }
                ],
                "name" : "example",
                "imageId": "m-0N8yoUGf",
                "networkCapacityInMbps": 0,
                "dedicatedHostId": "d-1xU2a1k1",
                "purchaseCount": 1
            }

    返回示例

            HTTP/1.1 200 OK
            x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
            Content-Type: application/json;charset=UTF-8
            Server: BWS
            {
                "instanceIds": [
                    "i-aDrQKA9U"
                ]
            }
    上一篇
    专属服务器解绑标签
    下一篇
    修改专属实例名称