调用DescribeSpotPriceHistory查询抢占式实例近30天内的历史价格。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
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 |
返回参数
示例
正常返回示例
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 | 错误码 | 错误信息 | 描述 |
---|---|---|---|
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. | - |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|
暂无变更历史