调用DescribeSpotAdvice查询抢占式实例的平均释放率和折扣率-云服务器 ECS-阿里云-阿里云帮助中心

本接口用于查询指定地域下，抢占式实例近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：入门级。 EnterpriseLevel：企业级。 CreditEntryLevel：积分入门级。更多信息，请参见突发性能实例。默认值：无，即查询所有级别。	EntryLevel
GpuSpec	string	否	GPU 计算卡的类型。取值范围： NVIDIA P4 NVIDIA T4 NVIDIA P100 NVIDIA V100 默认值：无，即查询所有类型。更多信息，请参见 GPU 计算型实例概述。	NVIDIA T4
GpuAmount	integer	否	GPU 实例对应的 GPU 数量。取值请参见 GPU 计算型实例概述。	2
InstanceTypes	array	否	实例规格列表。最多可输入 10 个实例规格。
	string	否	实例规格。取值请参见实例规格族。	ecs.c5.large

返回参数

名称	类型	描述	示例值
	object
RegionId	string	地域 ID。	cn-hangzhou
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
AvailableSpotZones	array<object>	可用区及其对应的抢占式实例相关信息组成的数组。说明返回值的顺序按照实例规格的历史平均折扣率排序。
AvailableSpotZone	object
ZoneId	string	可用区 ID。	cn-hangzhou-i
AvailableSpotResources	array<object>	近 30 天抢占式实例的释放率、折扣率等信息组成的数组。
AvailableSpotResource	object
InterruptRateDesc	string	近 30 天抢占式实例的释放率的范围，对应`InterruptionRate`返回值。可能值： 0-3% 3-5% 5-10% 10-100%	0-3%
AverageSpotDiscount	integer	近 30 天抢占式实例的均价相比按量付费实例价格的折扣率。单位：%。可能值：1~100。您可以根据该返回值计算抢占式实例的均价。例如，按量付费实例的价格为 1，该返回值为 20（即 20%），则近 30 天抢占式实例的均价为 0.2。	20
InstanceType	string	实例规格。	ecs.c5.large
InterruptionRate	float	近 30 天抢占式实例的平均释放率。单位：%。	0

示例

正常返回示例

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 错误码发生变更	查看变更详情