すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:APIコールスロットル

最終更新日:Apr 18, 2024

Alibaba Cloudサービスの安定性とクラウドリソースの公平な使用を確保するため、ECS (Elastic Compute Service) はAPI呼び出しを抑制し、悪意のある攻撃やAPIの悪用を防止します。 このトピックでは、ECS API操作のスロットリング情報を表示する方法と、API呼び出しをスロットリングする方法について説明します。

ECS API操作のスロットリング情報の表示

さまざまなECS API操作のスロットルしきい値を表示するには、Quota Centerコンソールにログインし、左側のナビゲーションウィンドウで [APIレートの制限] をクリックし、[Elastic Compute Service] をクリックします。

image.png

説明

特定のECS API操作のスロットリングしきい値のみを表示できます。

スロットル範囲

  • ECSは、厳格なスロットリングメカニズムを使用してAPI呼び出しをスロットルします。 スロットリングメカニズムは、すべてのECS API操作に対して有効になっています。 リージョン固有のスロットリングしきい値は、さまざまなAPI操作に対して定義されます。

  • リージョン内の特定のAPI操作の呼び出し数は、同じAlibaba Cloudアカウントでシステム定義のスロットリングしきい値を超えることはできません。 システム定義のスロットリングしきい値に達すると、システムは特定の単位時間内に開始される後続のAPI呼び出しを拒否します。

  • API操作の呼び出し数は、ECSコンソール、Resource Access Management (RAM) ユーザー、Alibaba Cloudアカウントに基づく自己管理プラットフォーム、TerraformやAnsibleなどのInfrastructure as a Service (IaaS) オーケストレーションプラットフォームからのデータトラフィックに基づいて計算されます。

スロットルルール

次のAPI呼び出しスロットルルールに注意してください。

  • 各API操作の呼び出し数は独立して計算されます。 リージョンのAPI操作の呼び出し数がスロットリングしきい値に達した場合、他のAPI操作の呼び出しおよび他のリージョンのAPI操作の呼び出しは影響を受けません。

  • API操作の呼び出しが分Tで抑制される場合、操作は分T + 1まで呼び出すことができません。

  • API操作の呼び出しが抑制され、SDKまたはAlibaba Cloud CLIを使用してAPI操作を呼び出したときにエラーが報告された場合、ECSコンソールのAPI操作に対応する機能の呼び出しも抑制されます。

  • CreateInstanceまたはRunInstancesを呼び出して1つ以上のECSインスタンスを作成する場合、API呼び出しの調整に加えてリソースの量の制限を考慮します。 API呼び出しを開始して、Alibaba Cloudアカウントで1分以内に最大5,000個のECSインスタンスを作成できます。 1分以内に合計5,000個のECSインスタンスを作成するAPI呼び出しを開始した場合、インスタンスを作成してインスタンスを [実行中] 状態にするのに1分以上かかる場合があります。

スロットルAPI呼び出しの提案

ECS API操作の呼び出し数がスロットリングしきい値に達すると、システムはスロットリングエラーコードを報告し、ECS API操作へのAPI呼び出しを期待どおりに処理できません。 IaaSプラットフォームを構築するときは、API操作を呼び出す合理性を考慮してください。 以下の提案が提供されます。

  • 集約呼び出し

    一部のECS API操作を呼び出して、リソースをバッチ照会したり、リソースに対してバッチ操作を実行したりできます。 APIを呼び出して、複数のリソースをクエリしたり、複数のリソースに対して同時に操作を実行したりすることを推奨します。

  • コール頻度の修正

    API操作を呼び出してリソースの状態を確認する場合は、特定の間隔で、または逆バックオフメカニズムを使用してAPI操作を呼び出すことを推奨します。 例:

    • ほとんどの場合、開始や停止などのリソースステータスは、1〜2秒間隔でチェックされます。

    • 逆バックオフメカニズムでは、リソースに対して操作が実行された後、数秒間リソースのステータスをチェックせず、1〜2秒の固定間隔に達するまでチェック頻度を徐々に上げます。

  • バックオフ再試行ポリシーの使用

    API操作の呼び出し時にスロットリングによりエラーコードが返された場合は、API操作の呼び出しに対してバックオフの再試行ポリシーを設定します。 同じAlibaba CloudアカウントでAPI操作を再試行する場合、1秒間に1回のクエリ (QPS) を実行して、API操作が利用可能かどうかを確認できます。