API Gateway:スロットルポリシー

特別なユーザーとアプリを既存の調整ポリシーに追加できます。 特別なユーザーとアプリも、ポリシーにバインドされているAPIに対してのみ有効になります。

スロットルポリシーで、API、ユーザー、およびアプリのしきい値を設定できます。 スロットルの単位は、秒、分、時間、または日とすることができる。 スロットルポリシーを使用する前に、次のルールに注意してください。

• 次の表のディメンションは、スロットルポリシーでカバーされています。

  APIレベルのスロットルしきい値	スロットリングポリシーにバインドされたAPIが特定の時間単位内に呼び出すことができる最大回数。 時間の単位は、秒、分、時間、または日とすることができる。 たとえば、しきい値を1分あたり5,000回に設定できます。
  アプリレベルの調整しきい値	特定の単位時間内にスロットリングポリシーにバインドされているAPIをアプリが呼び出すことができる最大回数。 たとえば、このしきい値を1時間あたり50,000回に設定できます。
  ユーザーレベルのスロットルしきい値	Alibaba Cloudアカウントが、特定の単位時間内にスロットリングポリシーにバインドされたAPIを呼び出すことができる最大回数。 Alibaba Cloudアカウントに複数のアプリが存在する場合があります。 このスロットリングしきい値は、Alibaba Cloudアカウント内のすべてのアプリが開始できるAPI呼び出しの総数を制限します。 たとえば、このしきい値を1日あたり500,000回に設定できます。

  1つの調整ポリシーで、前のすべてのしきい値を指定できます。 ユーザーレベルの調整しきい値をAPIレベルの調整しきい値より大きくすることはできません。また、アプリレベルの調整しきい値をユーザーレベルの調整しきい値より大きくすることはできません。

  特別なアプリやユーザーをスロットルポリシーに追加することもできます。 これらの特別なアプリとユーザーに適用されるのは、調整ポリシーのAPIレベルの調整しきい値のみです。 ただし、特別なユーザーとアプリごとに特別なスロットリングしきい値を設定する必要があります。 特別なスロットリングしきい値の値は、APIレベルのスロットリングしきい値より大きくすることはできません。

• 署名キーの作成と同様に、スロットルポリシーを作成するときにリージョンを選択する必要があります。 ポリシーの作成後にリージョンを変更することはできません。 一方、作成したスロットルポリシーは、選択したリージョンのAPIにのみ適用されます。

• デフォルトでは、API Gatewayは、各APIグループ内のすべてのAPIが1秒間に開始できるクエリを500に制限します。 APIレベルのスロットリングしきい値の値を指定する場合は、この制限を考慮する必要があります。

• スロットルポリシーをAPIにバインドします。 スロットリングポリシーを複数のAPIにバインドできます。 しきい値、特別なユーザー、特別なアプリなどのスロットリングポリシーの設定は、バインドされた各APIで有効になります。 スロットルポリシーを、すでに別のスロットルポリシーにバインドされているAPIにバインドすると、新しいポリシーが以前のポリシーに置き換えられ、すぐに有効になります。

• 特別なユーザーとアプリを追加します。 スロットルポリシーに特別なアプリを追加する場合は、アプリのIDを取得する必要があります。 スロットリングポリシーに特別なユーザーを追加する場合は、Alibaba CloudアカウントのユーザーIDを取得する必要があります。

• API Gatewayコンソールでは、スロットルポリシーを作成、変更、削除、および表示できます。 APIからスロットルポリシーをバインド解除することもできます。 特別なユーザーやアプリをスロットリングポリシーに追加したり、特別なユーザーやアプリをスロットリングポリシーから削除したりすることもできます。