You need to enable JavaScript to run this app.
导航
云服务器
  • 文档首页
    • /
  • 云服务器

DescribeSpotPriceHistory

最近更新时间：2023.11.20 10:48:37

首次发布时间：2023.08.01 10:44:24

我的收藏

调用 DescribeSpotPriceHistory 接口查询抢占式实例近30天内的历史价格。

调试

API Explorer
您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

名称类型是否必选示例值描述
ActionString是DescribeSpotAdvice要执行的操作，取值：DescribeSpotPriceHistory。
VersionString是2020-04-01API的版本，取值：2020-04-01。
InstanceTypeIdString是ecs.g1ie.xlarge实例的规格，您可以调用DescribeInstances查询实例规格。
ZoneIdString否cn-beijing-a实例规格所在的可用区ID，您可以调用DescribeZones查询一个地域下的可用区信息。

TimestampStart

String

否

2021-06-28T18:29:38+08:00

查询抢占式实例历史价格的起始时间，当填写时间为30天前时，默认起始时间为30天。

  • 默认值为空，表示结束时间前3小时。

  • 时间格式支持YYYY-mm-ddTHH:MM:SSZ或者YYYY-mm-ddTHH:MM:SS+ZZ:ZZ。

TimestampEnd

String

否

2021-06-28T18:29:38+08:00

查询抢占式实例历史价格的结束时间。该时间不可以超过当前时间，也不可以为30天前。

  • 默认值为空，表示当前时间。

  • 时间格式支持YYYY-mm-ddTHH:MM:SSZ或者YYYY-mm-ddTHH:MM:SS+ZZ:ZZ

NextToken

String

否

-

分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。

MaxResults

Integer

否

10

分页查询时设置的每页行数：

  • 最小值：1

  • 最大值：1000

  • 默认值：100

返回数据

名称
类型
示例值
描述
SpotPrices
Array of Struct
-
抢占式实例价格详情。
NextToken
String
bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******
本次调用返回的查询凭证值，返回为空表示该页为末页。

请求示例

GET /?Action=DescribeSpotPriceHistory&Version=2020-04-01&ZoneId=cn-beijing-a&InstanceTypeId=ecs.g1ie.xlarge HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
ServiceName: ecs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230426113431A57961174C490267****",
        "Action": "DescribeSpotPriceHistory",
        "Version": "2020-04-01",
        "Service": "ecs",
        "Region": "cn-beijing-a"
    },
    "Result": {
        "SpotPrices": [
            {
                "InstanceType": "ecs.g1ie.xlarge",
                "SpotPrice": 0.036,
                "Timestamp": "2021-06-28T18:29:38+08:00",
                "ZoneId": "cn-beijing-a"
            }
        ],
        "NextToken": "bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******"
    }
}

错误码

HttpCode错误码错误信息描述
400InvalidTimestampEnd.MalformedThe specified TimestampEnd is malformed.指定的结束时间不合法。
400InvalidTimestampStart.MalformedThe specified TimestampStart is malformed.指定的开始时间不合法。
400MissingParameter.InstanceTypeIdThe required parameter InstanceTypeId is not supplied.实例规格ID不能为空。
412InvalidTimestampStartTimestampEnd.MismatchThe specified TimestampStart does not match TimestampEnd.指定的StartTime与EndTime不匹配。