本接口用于查询指定地域下，抢占式实例近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 | 否 | GPU 计算卡的类型。取值范围：
默认值：无，即查询所有类型。更多信息，请参见 GPU 计算型实例概述。 | 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 无效。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2025-02-24 | OpenAPI 描述信息更新、OpenAPI 错误码发生变更 | 查看变更详情 |