本介面用於查詢搶佔式執行個體的歷史價格，最多支援獲取近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
}
]
}
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | MissingParameter | %s | |
| 400 | UnsupportedParameter | %s | |
| 400 | InvalidParameter | %s | |
| 400 | InvalidInstanceID.Malformed | %s | |
| 400 | InvalidParams.StartTime | %s | |
| 400 | InvalidParams.EndTime | %s | |
| 400 | Abs.Abs.InvalidSpotInstanceUID | %s | |
| 400 | InvalidParams.NetworkType | %s | |
| 400 | InvalidParams.IoOptimized | %s | |
| 400 | InvalidParams.OSType | %s | |
| 400 | Abs.IoOptimized.ValueNotSupported | %s | |
| 400 | InvalidZoneId.NotFound | The specified zone does not exist. | |
| 400 | InvalidParams.ZoneId | %s | |
| 400 | InvalidParams.RegionId | %s | |
| 400 | InvalidParams.InstanceType | %s | |
| 400 | InvalidParams.PageSize | %s | |
| 400 | InvalidParams.Offset | %s | |
| 400 | InvalidInstanceType.ValueNotSupported | %s | |
| 400 | DependencyViolation.IoOptimized | The specified instancetype must be IoOptimized instance. | |
| 400 | InvalidSpotDuration | The specified SpotDuration is not valid. | |
| 400 | OperationDenied.QueryFail | Query spot price fail, please retry later. | |
| 403 | InvalidUserType.NotSupported | %s | |
| 403 | Abs.InvalidAccount.NotFound | %s | |
| 403 | Forbedden.NotSupportRAM | %s | |
| 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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。