查询抢占实例市场价
更新时间: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"
}