正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

プロジェクトAPIのレート制限

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab Self-Managed、GitLab Dedicated

GitLab 18.0以降にアップグレードすると、このAPIの設定可能なレート制限は0に設定されます。管理者は必要に応じてレート制限を調整できます。影響を受けるレート制限については、Projects、Groups、およびUsers APIに関するレート制限の発表を参照してください。

プロジェクトAPIのレート制限を設定する

以下のプロジェクトAPIエンドポイントへのリクエストについて、各IPアドレスとユーザーのレート制限を設定します:

制限デフォルト間隔
GET /projects (未認証のリクエスト)40010分
GET /projects (認証済みリクエスト)200010分
GET /projects/:id4001分
GET /users/:user_id/projects3001分
GET /users/:user_id/contributed_projects1001分
GET /users/:user_id/starred_projects1001分

前提条件:

  • 管理者アクセス権。

レート制限を変更するには:

  1. 右上隅で、管理者を選択します。
  2. 左サイドバーで、設定 > ネットワークを選択します。
  3. プロジェクトのAPIレート制限を展開する。
  4. レート制限の値を変更するか、またはレート制限を0に設定して無効にします。
  5. 変更を保存を選択します。

レート制限:

  • 各認証済みユーザーに適用されます。リクエストが認証されていない場合、レート制限はIPアドレスに適用されます。

レート制限を超えるリクエストは、auth.logファイルにログが記録されます。

たとえば、GET /projects/:idに400の制限を設定した場合、1分あたり400リクエストのレートを超えるAPIエンドポイントへのリクエストはブロックされます。1分後にエンドポイントへのアクセスが復元されます。

プロジェクトAPIエンドポイントの詳細については、projects APIを参照してください。

プロジェクトメンバーの削除に関するレート制限を設定する

メンバー削除エンドポイントへのリクエストについて、各プロジェクトとユーザーのレート制限を設定します。

前提条件:

  • 管理者アクセス権。

レート制限を変更するには:

  1. 右上隅で、管理者を選択します。
  2. 左サイドバーで、設定 > ネットワークを選択します。
  3. Members API rate limitを展開する。
  4. グループまたはプロジェクトあたりの一分あたりの最大リクエスト数テキストボックスに値を入力します。
  5. 変更を保存を選択します。

レート制限:

  • 毎分60リクエストがデフォルトです。
  • 各プロジェクトとユーザーに適用されます。
  • レート制限を無効にするには0に設定できます。

レート制限を超えるリクエストは、auth.logファイルにログが記録されます。

例えば、60の制限を設定した場合、毎分60リクエストを超えるリクエストを送信するAPIエンドポイントはブロックされます。1分後にエンドポイントへのアクセスが再開されます。

プロジェクトメンバーのリスト表示に関するレート制限を設定する

プロジェクトメンバーリストエンドポイントへのリクエストのレート制限を設定します。

GET /projects/:id/members/allGET /groups/:id/members/allのAPIエンドポイントは、同じレート制限設定を共有します。プロジェクトエンドポイントにレート制限を設定すると、そのレート制限はグループエンドポイントにも適用されます。

前提条件:

  • 管理者アクセス権。

レート制限を変更するには:

  1. 右上隅で、管理者を選択します。
  2. 左サイドバーで、設定 > ネットワークを選択します。
  3. プロジェクトのAPIレート制限を展開する。
  4. Maximum requests to the GET /projects/:id/members/all API per minute per user or IP addressテキストボックスに値を入力します。
  5. 変更を保存を選択します。

レート制限:

  • 毎分200リクエストがデフォルトです。
  • 各プロジェクトとユーザーに適用されます。
  • レート制限を無効にするには、0に設定できます。

レート制限を超えるリクエストは、auth.logファイルにログが記録されます。

たとえば、200の制限を設定した場合、1分あたり200リクエストのレートを超えるAPIエンドポイントへのリクエストはブロックされます。1分後にエンドポイントへのアクセスが再開されます。