指定されたリージョンの過去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数とメモリサイズを持つインスタンスタイプの情報を照会します。
-
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | 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タイプ。 設定可能な値は以下のとおりです。
このパラメーターはデフォルトで空です。これは、すべての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 | 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
形式
{
"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"
}
エラーコード
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 エラーセンター」をご参照ください。