本接口用于查詢指定地域下，搶占式實例近30天的平均釋放率、平均折扣率等信息。
接口說明
-
僅支持查詢專有網絡 VPC、I/O 優化的搶占式實例。
-
您可以通過以下任一方式調用接口查詢：
- 設置
Cores、Memory兩參數或MinCores、MinMemory兩參數，查詢符合 vCPU 及內存要求的實例規格信息。 - 設置
InstanceTypes.N查詢指定的實例規格信息。 - 設置
Cores、Memory兩參數或MinCores、MinMemory兩參數后，再設置InstanceTypeFamily或InstanceFamilyLevel，查詢某一實例規格族或某一級別內，符合 vCPU 及內存要求的實例規格信息。
- 設置
-
通過平均折扣率和按量付費實例價格可以計算出搶占式實例平均價格。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 地域 ID。您可以調用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| Cores | integer | 否 | 實例規格的 vCPU 數量。取值請參見實例規格族。 | 2 |
| Memory | float | 否 | 實例規格的內存大小。單位：GiB。取值請參見實例規格族。 | 8.0 |
| MinCores | integer | 否 | 實例規格的 vCPU 數量的最小值。取值請參見實例規格族。 | 2 |
| MinMemory | float | 否 | 實例規格的內存大小的最小值。取值請參見實例規格族。 | 8.0 |
| ZoneId | string | 否 | 可用區 ID。 默認值：無，即查詢指定地域下的所有可用區。 | cn-hangzhou-i |
| InstanceTypeFamily | string | 否 | 實例規格族。取值請參見實例規格族。 | ecs.c5 |
| InstanceFamilyLevel | string | 否 | 實例規格族級別。取值范圍：
默認值：無，即查詢所有級別。 | EntryLevel |
| GpuSpec | string | 否 | NVIDIA T4 | |
| GpuAmount | integer | 否 | GPU 實例對應的 GPU 數量。取值請參見 GPU 計算型實例概述。 | 2 |
| InstanceTypes | array | 否 | 實例規格列表。最多可輸入 10 個實例規格。 | |
| string | 否 | 實例規格。取值請參見實例規格族。 | ecs.c5.large |
返回參數
示例
正常返回示例
JSON格式
{
"RegionId": "cn-hangzhou",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"AvailableSpotZones": {
"AvailableSpotZone": [
{
"ZoneId": "cn-hangzhou-i",
"AvailableSpotResources": {
"AvailableSpotResource": [
{
"InterruptRateDesc": "0-3%",
"AverageSpotDiscount": 20,
"InstanceType": "ecs.c5.large",
"InterruptionRate": 0
}
]
}
}
]
}
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | Invalid.SaleStrategy | The specified saleStrategy is not valid. | - |
| 400 | Invalid.Param | The input parameter DestinationResource that is mandatory for processing this request is not supplied. | 目標資源類型無效。 |
| 400 | InvalidRegionId.MalFormed | The specified parameter RegionId is not valid. | 指定的 RegionId 不合法。 |
| 403 | InvalidDedicatedHostId.NotFound | The specified DedicatedHostId does not exist in our records. | 指定的宿主機在當前地域中不存在。 |
| 403 | InvalidParam.TypeAndCpuMem.Conflict | The specified 'InstanceType' and 'Cores','Memory' are not blank at the same time. | 不能同時指定規格、核數和內存 |
| 403 | InvalidParam.Cores | The specified parameter 'Cores' should not be empty | - |
| 403 | InvalidParam.Memory | The specified parameter 'Memory' should not be empty | - |
| 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. | - |
| 404 | Invalid.RegionId | The specified RegionId does not exist. | 地域參數無效。 |
| 404 | Unavailable.Regions | The available regions does not exists | 地域參數無效。 |
| 404 | Invalid.ResourceType | The ResourceType provided does not exist in our records. | 資源類型無效。 |
| 404 | Invalid.DestinationResource | The specified DestinationResource is not valid. | 指定的目標資源無效。 |
| 404 | Invalid.IoOptimized | The specified IoOptimized is not valid. | 指定的參數 IoOptimized 無效。 |
| 404 | Invalid.NetworkType | The specified NetworkType is not valid. | 指定的參數 NetworkType 無效。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史