调用DescribeSpotAdvice查询指定地域下,抢占式实例近30天的实例平均释放率、平均折扣率等信息。
接口说明
- 您可以通过该接口查询抢占式实例近 30 天的信息,便于您合理选择抢占式实例的实例规格。支持查询的信息包括:
- 实例平均释放率。
- 实例平均折扣率。
- 通过折扣率计算出的平均价格。
- 仅支持查询专有网络 VPC、I/O 优化的抢占式实例。
- 您可以通过以下任一方式查询抢占式实例近 30 天的信息:
- 设置
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 无效。 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|
暂无变更历史