获取抢占式实例历史价格
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET /api/v1/spots/{InstanceType}/pricehistory HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceType |
string |
否 |
抢占式实例的实例规格。支持 ECS 规格和灵骏规格 |
ml.gu7xf.8xlarge-gu108 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| SpotDuration |
integer |
否 |
抢占式实例的保留时长，单位为小时。 注意目前仅 ECS 规格支持设置抢占式实例保留时长，默认值：0。取值范围：
|
0 |
| StartTime |
string |
否 |
查询抢占式实例历史价格的起始时间，最大值不得超过指定的结束时间 7 天。按照 ISO 8601 标准表示，并使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。默认值：空，空代表结束时间前 3 天。 |
2024-12-26T09:36:46Z |
| EndTime |
string |
否 |
查询抢占式实例历史价格的结束时间。按照 ISO 8601 标准表示，并使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。默认值：空，空表示当前时间。 |
2024-12-30T09:36:46Z |
| PageNumber |
integer |
否 |
分页参数：当前页码，默认值1。仅查询灵骏规格的历史价格时该参数生效 |
1 |
| PageSize |
integer |
否 |
每页大小。默认值：10。仅查询灵骏规格的历史价格时该参数生效 |
10 |
| SortBy |
string |
否 |
用于排序的字段名，默认值： GmtCreatedTime，可选字段：
仅查询灵骏规格的历史价格时该参数生效 枚举值：
|
GmtCreatedTime |
| Order |
string |
否 |
排序顺序。默认值：asc，取值如下：
仅查询灵骏规格的历史价格时该参数生效 枚举值：
|
asc |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
抢占式实例历史价格详情 |
||
| RequestId |
string |
请求 ID。 |
8BDA4440-DD3C-5F4B-BBDD-94A9CE1E75C7 |
| SpotPriceHistory |
array |
抢占式实例历史价格详情列表 |
|
|
SpotPriceItem |
抢占式实例历史价格详情 |
||
| TotalCount |
integer |
抢占式实例历史价格总数 |
194 |
错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。