DescribeSpotAdvice - 查詢搶佔式執行個體平均釋放率和折扣率 - Elastic Compute Service

本介面用於查詢指定地區下，搶佔式執行個體近30天的平均釋放率、平均折扣率等資訊。

介面說明

僅支援查詢Virtual Private Cloud、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	number	否	執行個體規格的記憶體大小。單位：GiB。取值請參見執行個體規格類型系列。	8.0
MinCores	integer	否	執行個體規格的 vCPU 數量的最小值。取值請參見執行個體規格類型系列。	2
MinMemory	number	否	執行個體規格的記憶體大小的最小值。取值請參見執行個體規格類型系列。	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 個執行個體規格。	ecs.c5.large
	string	否	執行個體規格。取值請參見執行個體規格類型系列。	ecs.c5.large

返回參數

名稱	類型	描述	樣本值
	object
RegionId	string	地區 ID。	cn-hangzhou
RequestId	string	請求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
AvailableSpotZones	object
AvailableSpotZone	array<object>	可用性區域及其對應的搶佔式執行個體相關資訊組成的數組。說明傳回值的順序按照執行個體規格的歷史平均折扣率排序。
	array<object>
ZoneId	string	可用性區域 ID。	cn-hangzhou-i
AvailableSpotResources	object
AvailableSpotResource	array<object>	近 30 天搶佔式執行個體的釋放率、折扣率等資訊組成的數組。
	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	number	近 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 無效。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。