文档

DescribeSpotAdvice - 查询历史30天平均实例释放率

更新时间:

调用DescribeSpotAdvice查询指定地域下,抢占式实例近30天的实例平均释放率、平均折扣率等信息。

接口说明

  • 您可以通过该接口查询抢占式实例近 30 天的信息,便于您合理选择抢占式实例的实例规格。支持查询的信息包括:
    • 实例平均释放率。
    • 实例平均折扣率。
    • 通过折扣率计算出的平均价格。
  • 仅支持查询专有网络 VPC、I/O 优化的抢占式实例。
  • 您可以通过以下任一方式查询抢占式实例近 30 天的信息:
    • 设置CoresMemory两参数或MinCoresMinMemory两参数,查询符合 vCPU 及内存要求的实例规格信息。
    • 设置InstanceTypes.N查询指定的实例规格信息。
    • 设置CoresMemory两参数或MinCoresMinMemory两参数后,再设置InstanceTypeFamilyInstanceFamilyLevel,查询某一实例规格族或某一级别内,符合 vCPU 及内存要求的实例规格信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
Coresinteger

实例规格的 vCPU 数量。取值请参见实例规格族

2
Memoryfloat

实例规格的内存大小。单位:GiB。取值请参见实例规格族

8.0
MinCoresinteger

实例规格的 vCPU 数量的最小值。取值请参见实例规格族

2
MinMemoryfloat

实例规格的内存大小的最小值。取值请参见实例规格族

8.0
ZoneIdstring

可用区 ID。

默认值:无,即查询指定地域下的所有可用区。

cn-hangzhou-i
InstanceTypeFamilystring

实例规格族。取值请参见实例规格族

ecs.c5
InstanceFamilyLevelstring

实例规格族级别。取值范围:

  • EntryLevel:入门级。
  • EnterpriseLevel:企业级。
  • CreditEntryLevel:积分入门级。更多信息,请参见突发性能实例

默认值:无,即查询所有级别。

EntryLevel
GpuSpecstring

GPU 计算卡的类型。取值范围:

  • NVIDIA P4
  • NVIDIA T4
  • NVIDIA P100
  • NVIDIA V100

默认值:无,即查询所有类型。更多信息,请参见 GPU 计算型实例概述

NVIDIA T4
GpuAmountinteger

GPU 实例对应的 GPU 数量。取值请参见 GPU 计算型实例概述

2
InstanceTypesarray

实例规格列表。最多可输入 10 个实例规格。

string

实例规格。取值请参见实例规格族

ecs.c5.large

返回参数

名称类型描述示例值
object
RegionIdstring

地域 ID。

cn-hangzhou
RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
AvailableSpotZonesobject []

可用区及其对应的抢占式实例相关信息组成的数组。

说明 返回值的顺序按照实例规格的历史平均折扣率排序。
ZoneIdstring

可用区 ID。

cn-hangzhou-i
AvailableSpotResourcesobject []

近 30 天抢占式实例的释放率、折扣率等信息组成的数组。

InterruptRateDescstring

近 30 天抢占式实例的释放率的范围,对应InterruptionRate返回值。可能值:

  • 0-3%
  • 3-5%
  • 5-10%
  • 10-100%
0-3%
AverageSpotDiscountinteger

近 30 天抢占式实例的均价相比按量付费实例价格的折扣率。单位:%。可能值:1~100。

您可以根据该返回值计算抢占式实例的均价。例如,按量付费实例的价格为 1,该返回值为 20(即 20%),则近 30 天抢占式实例的均价为 0.2。

20
InstanceTypestring

实例规格。

ecs.c5.large
InterruptionRatefloat

近 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错误码错误信息描述
400Invalid.SaleStrategyThe specified saleStrategy is not valid.-
400Invalid.ParamThe input parameter DestinationResource that is mandatory for processing this request is not supplied.目标资源类型无效。
400InvalidRegionId.MalFormedThe specified parameter RegionId is not valid.指定的 RegionId 不合法。
403InvalidDedicatedHostId.NotFoundThe specified DedicatedHostId does not exist in our records.指定的宿主机在当前地域中不存在。
403InvalidParam.TypeAndCpuMem.ConflictThe specified 'InstanceType' and 'Cores','Memory' are not blank at the same time.-
403InvalidParam.CoresThe specified parameter 'Cores' should not be empty-
403InvalidParam.MemoryThe specified parameter 'Memory' should not be empty-
403OperationDenied.RegionIdNotSupportedregion not support spot duration instance.-
403OperationDenied.FlavorNotSupportedflavor not support spot duration instance.-
403OperationDenied.TimestampNotSupportedtimestamp not support spot duration instance.-
404Invalid.RegionIdThe specified RegionId does not exist.地域参数无效。
404Unavailable.RegionsThe available regions does not exists地域参数无效。
404Invalid.ResourceTypeThe ResourceType provided does not exist in our records.资源类型无效。
404Invalid.DestinationResourceThe specified DestinationResource is not valid.指定的目标资源无效。
404Invalid.IoOptimizedThe specified IoOptimized is not valid.指定的参数 IoOptimized 无效。
404Invalid.NetworkTypeThe specified NetworkType is not valid.指定的参数 NetworkType 无效。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史
  • 本页导读 (1)
文档反馈