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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：2分

    • レート制限ルールを作成して、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 時間あたりに許可される最大要求数です。
      注:
      このフィールドの値を更新するたびに、ServiceNow AI Platform により要求数が 0 にリセットされ、現在の時間のすべての違反が削除されます。
      適用先 このルールで制限を受けるユーザー：
      • [単一ユーザー] では、特定のユーザーにレート制限を適用します。
      • [ロールを持つユーザー] では、特定のロールを持つすべてのユーザーにレート制限を適用します。
      • [すべてのユーザー] では、すべてのユーザーにレート制限を適用します。
      ロール レート制限が適用されるロール。[適用先] フィールドで [ロールを持つユーザー] を選択した場合にのみ表示されます。
      ユーザー レート制限が適用されるユーザー。[適用先] フィールドで [単一ユーザー] を選択した場合にのみ表示されます。
    3. [送信] をクリックします。
      新しいレート制限が有効になります。

    次のタスク

    ルールを送信すると、 ServiceNow AI Platform は次の関連リストをルールレコードに追加します。
    レート制限の数
    このレート制限ルールの影響を受ける受信 REST API 要求の数をユーザー別に一覧表示します。
    レート制限違反
    このレート制限ルールの違反をユーザー別に一覧表示します。

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