全部产品
Search
文档中心

云服务器 ECS:DescribeSpotPriceHistory - 查询抢占式实例的历史价格

更新时间:Dec 06, 2024

本接口用于查询抢占式实例的历史价格,最多支持获取近30天内的数据,通过历史价格数据可以帮助您合理的设置抢占式实例的单台实例上限价格。

接口说明

  • 仅支持查询 I/O 优化的抢占式实例。
  • 接口返回的数据可能会分页,若返回的数据包含NextOffset参数,您可以将请求参数中的Offset值设置为NextOffset值进行后续数据查询。

调试

您可以在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.-

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

变更历史

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