云服务器 ECS：DescribeSpotAdvice

接口说明

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

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeSpotAdvice
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-i
&InstanceTypes.1=ecs.c5.large
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeSpotAdviceResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <AvailableSpotZones>
        <AvailableSpotZone>
            <ZoneId>cn-hangzhou-i</ZoneId>
        </AvailableSpotZone>
        <AvailableSpotZone>
            <AvailableSpotResources>
                <AvailableSpotResource>
                    <InterruptRateDesc>0-3%</InterruptRateDesc>
                    <InstanceType>ecs.c5.large</InstanceType>
                    <AverageSpotDiscount>20</AverageSpotDiscount>
                    <InterruptionRate>0</InterruptionRate>
                </AvailableSpotResource>
            </AvailableSpotResources>
        </AvailableSpotZone>
    </AvailableSpotZones>
    <RegionId>cn-hangzhou</RegionId>
</DescribeSpotAdviceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "AvailableSpotZones" : {
    "AvailableSpotZone" : [ {
      "ZoneId" : "cn-hangzhou-i"
    }, {
      "AvailableSpotResources" : {
        "AvailableSpotResource" : [ {
          "InterruptRateDesc" : "0-3%",
          "InstanceType" : "ecs.c5.large",
          "AverageSpotDiscount" : "20",
          "InterruptionRate" : "0"
        } ]
      }
    } ]
  },
  "RegionId" : "cn-hangzhou"
}

错误码

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