調用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. | - |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史