指定されたリージョンの過去30日間にプリエンプティブルインスタンスに対して生成された従量課金インスタンス価格に対する平均リリース率や平均価格の割合などの情報を照会します。

説明

  • このAPIを呼び出して、過去30日間にプリエンプティブルインスタンスに対して生成された情報をクエリし、クエリ結果に基づいて適切なインスタンスタイプを選択できます。 この操作を呼び出して照会できる情報は次のとおりです。
    • Average release rate of preemptible instances
    • Percentage of the average preemptible instance price relative to the pay-as-you-go instance price
    • 上記の割合に基づいて計算されるプリエンプティブルインスタンスの平均価格
  • この操作は、仮想プライベートクラウド (VPC) にあるI/O最適化プリエンプティブルインスタンスにのみ適用できます。
  • 次のいずれかの方法を使用して、過去30日間にプリエンプティブルインスタンスに対して生成された情報を照会できます。
    • CoresおよびMemoryパラメーターまたはMinCoresおよびMinMemoryパラメーターを設定して、指定された数のvCPUとメモリサイズを持つインスタンスタイプに関する情報を照会します。
    • InstanceTypes.Nパラメーターを設定して、指定されたインスタンスタイプの情報を照会します。
    • CoresおよびMemoryパラメーターまたはMinCoresおよびMinMemoryパラメーターを設定し、InstanceTypeFamilyまたはInstanceFamilyLevelパラメーターを設定して、指定されたインスタンスファミリー内または指定されたインスタンスファミリーレベル内のvCPU数とメモリサイズを持つインスタンスタイプの情報を照会します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 String 任意 DescribeSpotAdvice

実行する操作です。 値をDescribeSpotAdviceに設定します。

RegionId String 必須 cn-hangzhou

リージョンのID。 DescribeRegions を呼び出すと、最新のリージョンリストを照会できます。

コア Integer 任意 2

インスタンスタイプのvCPUの数。 有効な値については、「インスタンスファミリー」をご参照ください。

Memory Float 任意 8.0

インスタンスタイプのメモリサイズ。 単位: GiB。 有効な値については、「インスタンスファミリー」をご参照ください。

ミンコア Integer 任意 2

インスタンスタイプのvCPUの最小数。 有効な値については、「インスタンスファミリー」をご参照ください。

MinMemory Float 任意 8.0

インスタンスタイプの最小メモリサイズ。 For information about the valid values, see Instance families.

ZoneId String 任意 cn-hangzhou-i

ゾーン ID を設定します。

This parameter is empty by default, which indicates that all zones in the specified region are queried.

InstanceTypes.N RepeatList 任意 ecs.c5.large

インスタンスタイプN。Nの有効値: 1〜10。 For information about the valid values, see Instance families.

InstanceTypeFamily String 任意 ecs.c5

インスタンスファミリー。 有効な値については、「インスタンスファミリー」をご参照ください。

InstanceFamilyLevel String 任意 EntryLevel

インスタンスファミリーのレベル。 設定可能な値は以下のとおりです。

このパラメーターはデフォルトでは空です。これは、すべてのレベルのインスタンスファミリーが照会されることを示します。

GpuSpec String 任意 NVIDIA T4

GPUタイプ。 設定可能な値は以下のとおりです。

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

このパラメーターはデフォルトで空です。これは、すべてのGPUタイプがクエリされることを示します。 For more information, see GPU-accelerated compute optimized instance types.

GpuAmount Integer 任意 2

The number of GPUs per GPU-accelerated instance. 有効な値については、「GPU高速化コンピューティング最適化インスタンスタイプ」をご参照ください。

レスポンスパラメーター

パラメーター データ型 説明
AvailableSpotZones AvailableSpotZoneの配列

指定したリージョンのゾーン内のプリエンプティブルインスタンスの詳細。

The return values are sorted based on the historical percentages of average preemptible instance prices relative to pay-as-you-go instance prices for instance types.
AvailableSpotZone
AvailableSpotResources AvailableSpotResourceの配列

過去30日間のプリエンプティブルインスタンスの詳細 (リリース率、従量課金制インスタンス価格に対するプリエンプティブルインスタンスの平均価格の割合など) 。

AvailableSpotResource
AverageSpotDiscount Integer 20

The percentage of the average preemptible instance relative to the pay-as-you-go instance price in the last 30 days. 単位: パーセント (%) 。 Valid values: 1 to 100.

プリエンプティブルインスタンスの平均価格は、戻り値に基づいて計算できます。 たとえば、従量課金インスタンスの価格が1で、このパラメーターの戻り値が20の場合、過去30日間のプリエンプティブルインスタンスの平均価格は0.2です。

InstanceType String ecs.c5.large

インスタンスタイプです。

割り込みRateDesc String 0-3%

過去30日間のプリエンプティブルインスタンスのリリース率の範囲。InterruptionRateの値に対応します。 有効値:

  • 0-3%
  • 3-5%
  • 5-10%
  • 10-100%
InterruptionRate Float 0

過去30日間のプリエンプティブルインスタンスの平均リリース率。 単位: パーセント (%) 。

ZoneId String cn-hangzhou-i

ゾーン ID を設定します。

RegionId String cn-hangzhou

リージョンの ID

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエストの ID です。

リクエストの例

https://ecs.aliyuncs.com/?Action=DescribeSpotAdvice
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-i
&InstanceTypes.1=ecs.c5.large
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

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 形式

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

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 無効な. RegionId The specified RegionId does not exist. 指定された RegionId パラメーターが無効な場合に返されるエラーメッセージ。
404 使用できないリージョン 使用可能なリージョンが存在しません 指定された RegionId パラメーターが無効な場合に返されるエラーメッセージ。
400 無効. Param このリクエストの処理に必須の入力パラメーターDestinationResourceが指定されていません。 指定されたDestinationResourceパラメーターが無効な場合に返されるエラーメッセージ。
404 Invalid.ResourceType 指定されたResourceTypeはレコードに存在しません。 指定されたResourceTypeパラメーターが無効な場合に返されるエラーメッセージ。
404 Invalid.DestinationResource 指定されたDestinationResourceは無効です。 指定されたDestinationResourceパラメーターが無効な場合に返されるエラーメッセージ。
404 無効な. IoOptimized 指定されたIoOptimizedは無効です。 指定された IoOptimized パラメーターが無効な場合に返されるエラーメッセージ。
404 無効な. NetworkType 指定されたNetworkTypeは無効です。 指定されたNetworkTypeパラメーターが無効な場合に返されるエラーメッセージ。
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. InstanceTypes.N、Core、およびMemoryパラメーターがすべて空の場合に返されるエラーメッセージ。
400 InvalidRegionId.MalFormed 指定されたパラメータ RegionId は無効です。 指定された RegionId パラメーターが無効な場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。