Elastic Compute Service:DescribeSpotAdvice

Description

• You can call this operation to query information that is generated for preemptible instances in the last 30 days and select suitable instance types based on the query results. The information that you can query by calling this operation includes:
  • Average release rate of preemptible instances
  • Percentage of the average preemptible instance price relative to the pay-as-you-go instance price
  • Average preemptible instance price that is calculated based on the preceding percentage
• This operation is applicable only to I/O optimized preemptible instances that are located in virtual private clouds (VPCs).
• You can use one of the following methods to query information that is generated for preemptible instances in the last 30 days:
  • Set the Cores and Memory parameters or the MinCores and MinMemory parameters to query information about instance types that have the specified number of vCPUs and memory size.
  • Set the InstanceTypes.N parameter to query information of the specified instance types.
  • Set the Cores and Memory parameters or the MinCores and MinMemory parameters, and set the InstanceTypeFamily or InstanceFamilyLevel parameter to query information of the instance types that have the specified number of vCPUs and memory size within the specified instance family or at the specified instance family level.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=DescribeSpotAdvice
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-i
&InstanceTypes.1=ecs.c5.large
&<Common request parameters>

Sample success responses

XML format

<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 format

{
    "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"
}

Error codes

For a list of error codes, visit the API Error Center.