产品与服务
解决方案
定价
文档
云市场
开发者
了解金山云
招标公告

热门搜索

云服务器 弹性IP 对象存储 IAM 账号管理 账单
控制台
备案
全部文档
当前文档

热搜词推荐

云服务器 虚拟私有网络 边缘节点计算 对等连接

共搜索到 0 条结果

暂无内容

如果没有找到您期望的内容，请尝试其他搜索词

文档中心

云服务器(KEC)

查看更多结果
未找到含当前关键字的文档标题
页面目录
全部展开全部收起
未找到含该关键词的产品
文档中心 云服务器(KEC) API文档 其他 竞价实例历史价格

竞价实例历史价格

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
参数名称
类型
必填
描述
Action String 是
公共参数，本接口取值：DescribeSpotPriceHistory。
Version String 是
公共参数，本接口取值：2016-03-04。
InstanceType String 是

实例套餐规格，支持机型E1，N2，N3

示例值：N3.2B
AvailabilityZone String 是

可用区信息

示例值：cn-beijing-6a
StartTime String 否

查询竞价实例历史价格的起始时间。按照ISO8601标准表示，并使用UTC +8时间，格式为yyyy-MM-ddTHH:mm:ssZ。默认值：空，空代表结束时间前3小时，最大值不得超过指定的结束时间3天。

示例值：——
EndTime String 否

查询抢占式实例历史价格的结束时间。按照ISO8601标准表示，并使用UTC +8时间，格式为yyyy-MM-ddTHH:mm:ssZ。默认值：空，空表示当前时间。（endtime不进行强校验）。

示例值：——

返回参数

参数名称
类型
描述
RequestId String
示例值：KEC-7ceaed40-66d9-4287-bf23-79fa60b47cf9002
InstanceType String
示例值：N3.1A
AvailabilityZone String
示例值：cn-beijing-6a
SpotPrices Object[]
SpotPrice Double
示例值：0.0393
OriginPrice Double
示例值：0.1965
Timestamp String
示例值：2023-09-17 16:00:00

请求示例

curl -X GET|POST
'http://kec.api.ksyun.com/?Action=DescribeSpotPriceHistory&Version=2016-03-04'
-H 'authorization: xxx, SignedHeaders=content-type;host;x-amz-date, Signature=xxx'
-H 'cache-control: no-cache'
-H 'content-type: application/x-www-form-urlencoded'
-H 'host: kec.api.ksyun.com'
-H 'x-amz-date: 20170720T022802Z'
-d 'InstanceType=xxx&AvailabilityZone=xxx&StartTime=xxx&EndTime=xxx'

返回示例

JSON格式

{
"RequestId":"KEC-7ceaed40-66d9-4287-bf23-79fa60b47cf9002",
"InstanceType":"N3.1A",
"AvailabilityZone":"cn-beijing-6a",
"SpotPrices":[
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-17 16:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-17 17:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-17 18:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-17 19:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-17 20:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-17 21:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-17 22:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-17 23:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 00:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 01:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 02:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 03:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 04:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 05:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 06:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 07:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 08:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 09:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 10:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 11:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 12:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 13:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 14:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 15:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 16:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 17:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 18:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 19:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 20:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 21:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 22:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-18 23:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 00:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 01:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 02:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 03:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 04:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 05:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 06:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 07:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 08:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 09:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 10:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 11:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 12:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 13:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 14:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 15:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 16:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 17:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 18:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 19:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 20:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 21:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 22:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-19 23:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 00:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 01:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 02:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 03:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 04:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 05:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 06:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 07:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 08:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 09:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 10:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 11:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 12:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 13:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 14:00:00"
},
{
"SpotPrice":0.0393,
"OriginPrice":0.1965,
"Timestamp":"2023-09-20 15:00:00"
}
]
}

错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码

错误码
错误信息
Http状态码
描述
EndTimeNotAllowedBeforeStartTimeThe start time should be earlier than end time.400结束时间不允许在开始时间之前
EndTimeIsMoreThanThreeDaysThanStartTimeThe time-span between the start and end time should be less than three days.400开始时间不得超过结束时间三天
EndTimeOutOfRangeThe start time should be earlier than now and within recent three months.400结束时间必须早于现在时间并且在三个月以内。
StartTimeOutOfRangeThe start time should be earlier than now and within recent three months.400开始时间必须早于现在时间并且在三个月以内。
SpotInstanceTypeOrAzNotExistOrSaleThe historical price of this instance type cannot be found. This instance type does not exist or is not sold spot in this availability zone.400查不到此机型的竞价实例历史价格，因此机型不存在或者不在指定可用区售卖竞价实例。
上一篇：存量虚机迁入容灾分组
下一篇：自定义镜像预热
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
电话咨询
400-1070-808
在线客服
专业人工服务，为您快速解决上云服务
提交工单
产品问题、技术问题及常见问题快速
聆听反馈
您的建议我们会及时处理/反馈，非常快
关于金山云
了解金山云 官网公告 投资者关系 联系我们 法律条款 合规性 白皮书 廉洁举报 诚聘英才
服务与支持
在线客服 注册认证 文档中心 备案服务 资源包管理 网上举报 隐私举报
热门产品
云服务器 数据库 对象存储 CDN 弹性IP 裸金属服务器
账户管理
管理控制台 账号管理 实名认证 订单管理 资源目录 索取发票 充值付款 提交工单

7x24小时服务

免费备案

建议反馈

专家服务
咨询热线
400-1070-808
在线客服
一 键 开 启 云 上 生 活 一 键 开 启 云 上 生 活
TRUSTe
©北京金山云网络技术有限公司 2022 Ksyun All Rights Reserved Kingsoft Corp.
京ICP证120829号  京B2-20180585   京ICP备 12032080号    京公网安备11010802017204号