GetSpotPriceHistory - 获取抢占式实例历史价格

获取抢占式实例历史价格

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /api/v1/spots/{InstanceType}/pricehistory HTTP/1.1

请求参数

名称类型必填描述示例值
InstanceTypestring

抢占式实例的实例规格。支持 ECS 规格和灵骏规格

ml.gu7xf.8xlarge-gu108
SpotDurationinteger

抢占式实例的保留时长,单位为小时。 注意目前仅 ECS 规格支持设置抢占式实例保留时长,默认值:0。取值范围:

  • 1:创建后阿里云会保证实例运行 1 小时不会被自动释放;超过 1 小时后,系统会自动比较出价与市场价格、检查资源库存,来决定实例的持有和回收。
  • 0:创建后,阿里云不保证实例运行 1 小时,系统会自动比较出价与市场价格、检查资源库存,来决定实例的持有和回收。
0
StartTimestring

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

2024-12-26T09:36:46Z
EndTimestring

查询抢占式实例历史价格的结束时间。按照 ISO 8601 标准表示,并使用 UTC +0 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。默认值:空,空表示当前时间。

2024-12-30T09:36:46Z
PageNumberinteger

分页参数:当前页码,默认值1。仅查询灵骏规格的历史价格时该参数生效

1
PageSizeinteger

每页大小。默认值:10。仅查询灵骏规格的历史价格时该参数生效

10
SortBystring

用于排序的字段名,默认值: GmtCreatedTime,可选字段:

  • GmtCreatedTime

仅查询灵骏规格的历史价格时该参数生效

GmtCreatedTime
Orderstring

排序顺序。默认值:asc,取值如下:

  • desc:降序。
  • asc:升序。

仅查询灵骏规格的历史价格时该参数生效

asc

返回参数

名称类型描述示例值
object

抢占式实例历史价格详情

RequestIdstring

请求 ID。

8BDA4440-DD3C-5F4B-BBDD-94A9CE1E75C7
SpotPriceHistoryarray

抢占式实例历史价格详情列表

SpotPriceItemSpotPriceItem

抢占式实例历史价格详情

TotalCountinteger

抢占式实例历史价格总数

194

错误码

访问错误中心查看更多错误码。