本接口用于查詢搶占式實例的歷史價格,最多支持獲取近30天內的數據,通過歷史價格數據可以幫助您合理的設置搶占式實例的單臺實例上限價格。
接口說明
- 僅支持查詢 I/O 優化的搶占式實例。
- 接口返回的數據可能會分頁,若返回的數據包含
NextOffset
參數,您可以將請求參數中的Offset
值設置為NextOffset
值進行后續數據查詢。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
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. | - |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|