REST API へのレート制限の適用

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:2分
  • 公開されているカタログアイテムの過度の使用や悪用を避けるために、REST API にレート制限を適用します。

    始める前に

    必要なロール:admin、catalog_admin、web_service_admin

    このタスクについて

    レート制限は、公開されているカタログアイテムの制御されていない作成を制限し、悪意のあるアクターや自動化されたボットに関連するリスクを軽減します。

    手順

    1. 次のように移動する。 All (すべて) > システム Web サービス > レート制限ルール.
    2. [New (新規)] を選択します。
      レート制限ルールフォームの表示
    3. 次のフィールド値を入力します。
      表 : 1. REST API レート制限ルールフォームのフィールド
      フィールド 説明
      REST API リソース 次のフィールドに入力された値から導出された値。
      名前 レート制限ルールの一意の名前。
      REST API

      インスタンスのすべての外部向け REST API のリストから選択された REST API。

      [サービスカタログ] を選択します。
      バージョン

      REST API のバージョンです。リストされる値は、選択した REST API によって異なります。

      [最新] を選択します。
      リソース

      バージョンのリソース。リストされる値は、選択したバージョンによって異なります。

      必要なリソースを選択します。

      たとえば

      • 購入アイテム
      • レコードプロデューサーを送信します
      • 変数の正規表現を検証 (アイテムが正規表現の検証を必要とする変数で構成されている場合)
      • チェックアウト注文ガイド
      • 変数表示値
      • アイテムの委任要求を確認
      [Active (アクティブ)] レート制限ルールが有効であることを示すチェックボックス 。

      レート制限ルールは、作成されるとデフォルトで直ちに有効になります。レート制限ルールを無効にしてレート制限の適用を停止したり、レート制限ルールを有効にしてレート制限の適用を再開したりすることができます。

      1 時間当たりの要求制限 1 時間あたりに許可される最大要求数です。
      注:
      このフィールドの値を更新するたびに、Now Platform により要求数が 0 にリセットされ、現在の時間のすべての違反が削除されます。
      適用先
      このルールで制限を受けるユーザー:
      • [単一ユーザー] では、特定のユーザーにレート制限を適用します。
      • [ロールを持つユーザー] では、特定のロールを持つすべてのユーザーにレート制限を適用します。
      • [すべてのユーザー] では、すべてのユーザーにレート制限を適用します。
      [ロールを持つユーザー] を選択します。
      ロール

      レート制限が適用されるロール。

      [ゲストユーザー] を選択します。
      注:
      [適用先] フィールドで [ロールを持つユーザー] を選択した場合にのみ表示されます。
    4. [Submit (送信)] を選択します。

    タスクの結果

    公開されている API にはレート制限が適用されます。