查询抢占实例市场价

更新时间：2023-08-01

描述

本接口用于查询抢占实例市场价。

请求结构

POST /v{version}/instance/bidPrice HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string

{
    "instanceType": instanceType,
    "cpuCount": cpuCoreCount,
    "memoryCapacityInGB": memoryCapacityInGB,
    "rootDiskSizeInGb":rootDiskSizeInGb,
    "rootDiskStorageType":rootDiskStorageType,
    "createCdsList": [
        {
            "storageType": storageType,
            "cdsSizeInGB": cdsSizeInGB
        }
    ],
    "purchaseCount":purchaseCount
}

请求头域

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

请求参数

参数名称	类型	是否必需	参数位置	描述
version	String	是	URL参数	API版本号
clientToken	String	是	Query参数	幂等性Token，是一个长度不超过64位的ASCII字符串，详见链接。
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。
createCdsList	List<CreateCdsModel>	否	RequestBody参数	待创建的CDS磁盘列表，具体数据格式参见下述CreateCdsModel
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位字符，英文，数字和符号必须同时存在，符号仅限!@#$%^*()，密码需要加密传输，详见链接
keypairId	String	否	RequestBody参数	待查询实例所要绑定的密钥对ID
aspId	String	否	RequestBody参数	自动快照策略ID
imageId	String	否	RequestBody参数	待查询虚拟机实例的镜像ID，可通过调用查询镜像列表接口选择获取所需镜像ID。
bidModel	String	否	RequestBody参数	竞价实例出价模型，市场价: "market" 自定义："custom"。参考BidModel
bidPrice	String	否	RequestBody参数	竞价实例出价金额，若是自定义出价，且出价金额小于市场价，则不允许创建。当bidModel='custom'时才有效。
networkCapacityInMbps	int	否	RequestBody参数	公网带宽，单位为Mbps。必须为0~200之间的整数，为0表示不分配公网IP，默认为0Mbps
relationTag	boolean	否	RequestBody参数	待查询实例指定的标签是否需要和已有标签键进行关联，默认为false。注意值为true时要保证该标签键已存在
tags	List<TagModel>	否	RequestBody参数	待查询的标签列表，具体数据格式参见下述TagModel
securityGroupId	String	否	RequestBody参数	指定securityGroup信息，为空时将使用默认安全组
subnetId	String	否	RequestBody参数	指定subnet信息，为空时将使用默认子网
zoneName	String	否	RequestBody参数	指定zone信息，默认为空，由系统自动选择，可通过调用查询可用区列表接口查询可用区列表。zoneName命名规范是“国家-region-可用区序列"，小写，例如北京可用区A为"cn-bj-a"。专属实例使用专属服务器所在zone,无需指定该字段。
internetChargeType	String	否	RequestBody参数	公网带宽计费方式，可选参数详见internetChargeType，若不指定internetChargeType，默认付费方式同BCC，预付费默认为包年包月按带宽，后付费默认为按使用带宽计费。

返回头域

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

返回参数

参数名称	类型	描述
money	String	总价。
count	String	购买个数。
perMoney	String	单个价格。

错误码

错误码	错误描述	HTTP状态码	中文解释
BadRequest	invalid purchaseNum.	400	购买数量需要大于0
BadRequest	missing bcc config.	400	缺少bcc配置
BadRequest	invalid instanceType.	400	无效的实例类型
Instance.InvalidateZoneException	Invalidate zone name.	400	无效的可用区

请求示例

POST /v2/instance/bidPrice HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json    
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
    "instanceType": "N1",
    "cpuCount": 2,
    "memoryCapacityInGB": 2,
    "rootDiskSizeInGb":45,
    "rootDiskStorageType":"cloud_hp1",
    "createCdsList": [
        {
            "storageType": "std1",
            "cdsSizeInGB": 5
        }
    ],
    "purchaseCount": 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

{
    "money": "0.0011367",
    "count": "1",
    "perMoney": "0.0011367"
}

查询抢占实例套餐

取消抢占实例订单

百度智能云

云服务器 BCC

云服务器 BCC

查询抢占实例市场价