受信 REST API レート制限を作成する

レート制限ルールを作成して、1 時間あたりに処理される受信 REST API 要求の数を制限します。

始める前に

必要なロール：rate_limit_admin

このタスクについて

すべてのユーザー、特定のロールを持つユーザー、またはすべてのユーザーに対してレート制限を設定します。

注:

要求がインスタンスに達したときに、各ノードはユーザーごとのレート制限数を維持します。30 秒ごとに、カウントがデータベースにコミットされます。その結果、レート制限ルールが最大 30 秒間有効にならない場合があります。

手順

1. 移動先 すべて > システム Web サービス > REST > レート制限ルール.
2. [新規] をクリックし、次のフィールドの値を入力します。

   表 : 1. REST API レート制限ルールフォーム

   フィールド	説明
   REST API リソース	次のフィールドに入力された値から導出された値。
   名前	レート制限ルールの一意の名前。
   REST API	インスタンスのすべての外部向け REST API のリストから選択された REST API。
   バージョン	REST API のバージョン。リストされる値は、選択した REST API によって異なります。
   リソース	バージョンのリソース。リストされる値は、選択したバージョンによって異なります。
   テーブル	ターゲットにするテーブル。[REST API] として [テーブル API] を選択した場合にのみ表示されます。
   インポート セット テーブル	ターゲットにするインポートセットテーブル。[REST API] として [インポートセット API] を選択した場合にのみ表示されます。
   アクティブ	レート制限ルールが有効であることを示すチェックボックス 。 レート制限ルールは、作成されるとデフォルトで直ちに有効になります。レート制限ルールを無効にしてレート制限の適用を停止したり、レート制限ルールを有効にしてレート制限の適用を再開したりすることができます。
   1 時間当たりの要求制限	1 時間あたりに許可される最大要求数です。 注: このフィールドの値を更新するたびに、Now Platform により要求数が 0 にリセットされ、現在の時間のすべての違反が削除されます。
   適用先	このルールで制限を受けるユーザー： [単一ユーザー] では、特定のユーザーにレート制限を適用します。 [ロールを持つユーザー] では、特定のロールを持つすべてのユーザーにレート制限を適用します。 [すべてのユーザー] では、すべてのユーザーにレート制限を適用します。
   ロール	レート制限が適用されるロール。[適用先] フィールドで [ロールを持つユーザー] を選択した場合にのみ表示されます。
   ユーザー	レート制限が適用されるユーザー。[適用先] フィールドで [単一ユーザー] を選択した場合にのみ表示されます。

3. [送信] をクリックします。
   新しいレート制限が有効になります。

次のタスク

ルールを送信すると、Now Platform によって次の関連リストがルールレコードに追加されます。

レート制限の数

このレート制限ルールの影響を受ける受信 REST API 要求の数をユーザー別に一覧表示します。

レート制限違反

このレート制限ルールの違反をユーザー別に一覧表示します。

これらの関連リストを使用すると、「受信 REST API のレート制限数と違反を監視する」を行うことができます。