本接口用于查询抢占式实例的历史价格，最多支持获取近30天内的数据，通过历史价格数据可以帮助您合理的设置抢占式实例的单台实例上限价格。
接口说明
仅支持查询 I/O 优化的抢占式实例。
接口返回的数据可能会分页，若返回的数据包含
NextOffset参数，您可以将请求参数中的Offset值设置为NextOffset值进行后续数据查询。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 |
cn-hangzhou |
| RegionId |
string |
是 |
实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 |
cn-hangzhou |
| ZoneId |
string |
否 |
可用区 ID。 |
cn-hangzhou-g |
| NetworkType |
string |
是 |
抢占式实例网络类型。取值范围：
|
vpc |
| InstanceType |
string |
是 |
实例规格。 |
ecs.t1.xsmall |
| SpotDuration |
integer |
否 |
抢占式实例的保留时长，单位为小时。 默认值：1。取值范围：
实例回收前 5 分钟阿里云会通过 ECS 系统事件向您发送通知。抢占式实例按秒计费，建议您结合具体任务执行耗时来选择合适的保留时长。 说明
当 SpotStrategy 值为 SpotWithPriceLimit 或 SpotAsPriceGo 时该参数生效。 |
1 |
| IoOptimized |
string |
否 |
是否为 I/O 优化实例。取值范围：
系列 I 实例默认值：none。 其余实例规格族默认值：optimized。 |
optimized |
| StartTime |
string |
否 |
查询抢占式实例历史价格的起始时间，最大值不得超过指定的结束时间 30 天。按照ISO 8601标准表示，并使用 UTC +0 时间，格式为 默认值：空，空代表结束时间前 3 小时。 |
2017-08-22T08:45:08Z |
| EndTime |
string |
否 |
查询抢占式实例历史价格的结束时间。按照ISO 8601标准表示，并使用 UTC +0 时间，格式为 默认值：空，空表示当前时间。 |
2017-08-22T08:45:08Z |
| OSType |
string |
否 |
操作系统的发行平台类型。取值范围：
|
linux |
| Offset |
integer |
否 |
查询开始行。 默认值：0。 |
0 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| Currency |
string |
价格的货币单位。 中国站：CNY。 国际站：USD。 |
CNY |
| NextOffset |
integer |
下一页开始行，查询下一页的数据。参数 |
1000 |
| SpotPrices |
object |
||
| SpotPriceType |
array<object> |
抢占价格详情。 |
|
|
object |
|||
| IoOptimized |
string |
抢占式实例是否为 I/O 优化实例。 |
optimized |
| ZoneId |
string |
抢占式实例所属的可用区 ID。 |
cn-hangzhou-c |
| SpotPrice |
number |
抢占式实例价格。 |
0.036 |
| Timestamp |
string |
时间格式为 |
2019-11-19T06:00:00Z |
| NetworkType |
string |
抢占式实例的网络类型。 |
vpc |
| InstanceType |
string |
抢占式实例的实例规格。 |
ecs.g5.large |
| OriginPrice |
number |
按量付费实例部分原价。 |
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
}
]
}
}异常返回示例
JSON格式
{
"RequestId": "540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx",
"HostId": "ecs.aliyuncs.com",
"Code": "IncompleteSignature",
"Message": "The request signature does not conform to Aliyun standards."
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | MissingParameter | %s | 缺失参数，请检查参数是否完整。 |
| 400 | UnsupportedParameter | %s | 不支持参数。 |
| 400 | InvalidParameter | %s | 无效的参数。 |
| 400 | InvalidInstanceID.Malformed | %s | 参数 InstanceId 格式错误。 |
| 400 | InvalidParams.StartTime | %s | 指定的参数 StartTime 无效。 |
| 400 | InvalidParams.EndTime | %s | 指定的参数 EndTime 无效。 |
| 400 | Abs.Abs.InvalidSpotInstanceUID | %s | 抢占式实例ID格式不正确。 |
| 400 | InvalidParams.NetworkType | %s | 指定的参数 NetworkType 无效。 |
| 400 | InvalidParams.IoOptimized | %s | 指定的参数 IoOptimized 无效。 |
| 400 | InvalidParams.OSType | %s | 指定的参数 OSType 无效。 |
| 400 | Abs.IoOptimized.ValueNotSupported | %s | 实例 I/O 优化属性无效，请检查参数设置是否正确。 |
| 400 | InvalidZoneId.NotFound | The specified zone does not exist. | 指定的可用区 ID 不存在。 |
| 400 | InvalidParams.ZoneId | %s | 指定的参数 ZoneId 无效。 |
| 400 | InvalidParams.RegionId | %s | 指定的参数 RegionId 无效。 |
| 400 | InvalidParams.InstanceType | %s | 指定的参数 InstanceType 无效。 |
| 400 | InvalidParams.PageSize | %s | 指定的参数 PageSize 无效。 |
| 400 | InvalidParams.Offset | %s | 指定的参数 Offset 无效。 |
| 400 | InvalidInstanceType.ValueNotSupported | %s | 该操作暂不支持指定的实例类型。 |
| 400 | DependencyViolation.IoOptimized | The specified instancetype must be IoOptimized instance. | 指定的实例规格必须为I/O优化实例，请您检查实例规格是否正确。 |
| 400 | InvalidSpotDuration | The specified SpotDuration is not valid. | 指定的 SpotDuration 参数有误。 |
| 400 | OperationDenied.QueryFail | Query spot price fail, please retry later. | |
| 403 | InvalidUserType.NotSupported | %s | 您当前的账号不支持此操作。 |
| 403 | Abs.InvalidAccount.NotFound | %s | 您的阿里云账号不存在，或者您的 AccessKey 已经过期。 |
| 403 | Forbedden.NotSupportRAM | %s | 暂不支持RAM用户执行该操作。 |
| 403 | Forbbiden.SubUser | %s | 您的账号没有操作此资源的权限，请向主账号申请相关的权限。 |
| 403 | OperationDenied.RegionIdNotSupported | region not support spot duration instance. | |
| 403 | OperationDenied.FlavorNotSupported | flavor not support spot duration instance. | |
| 403 | OperationDenied.TimestampNotSupported | timestamp not support spot duration instance. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。