文档

DescribeSpotPriceHistory - 查询抢占式实例近30天内的历史价格

更新时间:

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

调试

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

授权信息

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

请求参数

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

实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
ZoneIdstring

可用区 ID。

cn-hangzhou-g
NetworkTypestring

抢占式实例网络类型。取值范围:

  • classic:表示抢占式实例的网络类型为经典网络。

  • vpc:表示抢占式实例的网络类型为专有网络。

vpc
InstanceTypestring

实例规格。

ecs.t1.xsmall
SpotDurationinteger

抢占式实例的保留时长,单位为小时。 默认值:1。取值范围:

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

实例回收前 5 分钟阿里云会通过 ECS 系统事件向您发送通知。抢占式实例按秒计费,建议您结合具体任务执行耗时来选择合适的保留时长。

说明 当 SpotStrategy 值为 SpotWithPriceLimit 或 SpotAsPriceGo 时该参数生效。
1
IoOptimizedstring

是否为 I/O 优化实例。取值范围:

  • optimized:表示抢占式实例为 I/O 优化实例。

  • none:表示抢占式实例为非 I/O 优化实例。

系列 I 实例默认值:none。

其余实例规格族默认值:optimized。

optimized
StartTimestring

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

默认值:空,空代表结束时间前 3 小时。

2017-08-22T08:45:08Z
EndTimestring

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

默认值:空,空表示当前时间。

2017-08-22T08:45:08Z
OSTypestring

操作系统的发行平台类型。取值范围:

  • linux。
  • windows。
linux
Offsetinteger

查询开始行。

默认值:0。

0

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Currencystring

价格的货币单位。

中国站:CNY。

国际站:USD。

CNY
NextOffsetinteger

下一页开始行,查询下一页的数据。参数Offset的指定值为该值。

1000
SpotPricesarray<object>

抢占价格详情。

SpotPriceTypeobject
IoOptimizedstring

抢占式实例是否为 I/O 优化实例。

optimized
ZoneIdstring

抢占式实例所属的可用区 ID。

cn-hangzhou-c
SpotPricefloat

抢占式实例价格。

0.036
Timestampstring

时间格式为yyyy-MM-ddTHH:mm:ssZ的价格时间。

2019-11-19T06:00:00Z
NetworkTypestring

抢占式实例的网络类型。

vpc
InstanceTypestring

抢占式实例的实例规格。

ecs.g5.large
OriginPricefloat

按量付费实例部分原价。

0.354

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Currency": "CNY",
  "NextOffset": 1000,
  "SpotPrices": {
    "SpotPriceType": [
      {
        "IoOptimized": "optimized",
        "ZoneId": "cn-hangzhou-c",
        "SpotPrice": 0.036,
        "Timestamp": "2019-11-19T06:00:00Z",
        "NetworkType": "vpc",
        "InstanceType": "ecs.g5.large",
        "OriginPrice": 0.354
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400MissingParameter%s缺失参数,请检查参数是否完整。
400UnsupportedParameter%s不支持参数。
400InvalidParameter%s无效的参数。
400InvalidInstanceID.Malformed%s参数 InstanceId 格式错误。
400InvalidParams.StartTime%s指定的参数 StartTime 无效。
400InvalidParams.EndTime%s指定的参数 EndTime 无效。
400Abs.Abs.InvalidSpotInstanceUID%s抢占式实例ID格式不正确。
400InvalidParams.NetworkType%s指定的参数 NetworkType 无效。
400InvalidParams.IoOptimized%s指定的参数 IoOptimized 无效。
400InvalidParams.OSType%s指定的参数 OSType 无效。
400Abs.IoOptimized.ValueNotSupported%s实例 I/O 优化属性无效,请检查参数设置是否正确。
400InvalidZoneId.NotFoundThe specified zone does not exist.指定的可用区 ID 不存在。
400InvalidParams.ZoneId%s指定的参数 ZoneId 无效。
400InvalidParams.RegionId%s指定的参数 RegionId 无效。
400InvalidParams.InstanceType%s指定的参数 InstanceType 无效。
400InvalidParams.PageSize%s指定的参数 PageSize 无效。
400InvalidParams.Offset%s指定的参数 Offset 无效。
400InvalidInstanceType.ValueNotSupported%s该操作暂不支持指定的实例类型。
400DependencyViolation.IoOptimizedThe specified instancetype must be IoOptimized instance.指定的实例规格必须为I/O优化实例,请您检查实例规格是否正确。
400InvalidSpotDurationThe specified SpotDuration is not valid.指定的 SpotDuration 参数有误。
400OperationDenied.QueryFailQuery spot price fail, please retry later.-
403InvalidUserType.NotSupported%s您当前的账号不支持此操作。
403Abs.InvalidAccount.NotFound%s您的阿里云账号不存在,或者您的 AccessKey 已经过期。
403Forbedden.NotSupportRAM%s暂不支持RAM用户执行该操作。
403Forbbiden.SubUser%s您的账号没有操作此资源的权限,请向主账号申请相关的权限。
403OperationDenied.RegionIdNotSupportedregion not support spot duration instance.-
403OperationDenied.FlavorNotSupportedflavor not support spot duration instance.-
403OperationDenied.TimestampNotSupportedtimestamp not support spot duration instance.-

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

变更历史

变更时间变更内容概要操作
暂无变更历史