グループのAPIレート制限
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab Self-Managed、GitLab Dedicated
GitLab 18.0以降にアップグレードすると、このAPIの構成可能なレート制限は0に設定されます。管理者は必要に応じてレート制限を調整できます。影響を受けるレート制限に関する情報については、プロジェクト、グループ、ユーザーAPIのレート制限に関する発表を参照してください。
グループのAPIレート制限を設定する
以下のグループAPIエンドポイントへのリクエストに対して、各IPアドレスとユーザーのレート制限を設定します:
| 制限 | デフォルト | 間隔 |
|---|---|---|
GET /groups | 200 | 1分 |
GET /groups/:id | 400 | 1分 |
GET /groups/:id/groups/shared | 0 | 1分 |
GET /groups/:id/invited_groups | 60 | 1分 |
GET /groups/:id/projects | 600 | 1分 |
POST /groups/:id/archive | 60 | 1分 |
POST /groups | 200 | 1日 |
前提条件:
- 管理者アクセス権。
レート制限を変更するには:
- 右上隅で、管理者を選択します。
- 左側のサイドバーで、設定 > ネットワークを選択します。
- グループのAPIレート制限を展開します。
- レート制限の値を変更するか、無効にするにはレート制限を
0に設定します。 - 変更を保存を選択します。
レート制限:
- 各認証済みユーザーに適用されます。リクエストが認証されていない場合、レート制限はIPアドレスに適用されます。
- レート制限を無効にするには0に設定できます。
レート制限を超過したリクエストは、auth.logファイルにログが記録されます。
たとえば、GET /groups/:idに400の制限を設定した場合、1分あたり400を超えるレートのエンドポイントへのリクエストはブロックされます。エンドポイントへのアクセスは1分後に復元されます。
グループおよびプロジェクトメンバーのリスト表示に関するレート制限
すべてのグループメンバーをリスト表示するAPIエンドポイントにレート制限が設定されます。
GET /projects/:id/members/allとGET /groups/:id/members/allのAPIエンドポイントは、同じレート制限設定を共有します。プロジェクトエンドポイントにレート制限を設定した場合、そのレート制限はグループエンドポイントにも適用されます。
前提条件:
- 管理者アクセス権。
両方のエンドポイントのこのレート制限を変更するには:
- 右上隅で、管理者を選択します。
- 左側のサイドバーで、設定 > ネットワークを選択します。
- プロジェクトのAPIレート制限を展開します。
- ユーザーまたはIPアドレスごとの、1分あたりの
GET /projects/:id/members/allAPIへの最大リクエスト数テキストボックスに値を入力します。 - 変更を保存を選択します。
レート制限:
- デフォルトは毎分200リクエストです。
- 各認証済みユーザーに適用されます。リクエストが認証されていない場合、レート制限はIPアドレスに適用されます。
- プロジェクトAPIレート制限設定を通じて構成されます。詳細については、プロジェクトメンバーのリスト表示に関するレート制限を設定するを参照してください。
- 両方のエンドポイントのレート制限を無効にするには、
0に設定できます。
レート制限を超過したリクエストは、auth.logファイルにログが記録されます。
例えば、毎分200リクエストを超えるAPIエンドポイントへのリクエストはブロックされます。エンドポイントへのアクセスは1分後に再開されます。
グループのアーカイブおよびアーカイブ解除に関するレート制限を設定する
- ステータス: 実験的機能
以下のグループアーカイブエンドポイントへのリクエストにレート制限を設定します:
POST /groups/:id/archive
POST /groups/:id/unarchive前提条件:
- 管理者アクセス権。
レート制限を変更するには:
- 右上隅で、管理者を選択します。
- 左側のサイドバーで、設定 > ネットワークを選択します。
- グループのAPIレート制限を展開します。
- ユーザーまたはIPアドレスごとの、1分あたりの
POST /groups/:id/archiveおよびPOST /groups/:id/unarchiveAPIへの最大リクエスト数テキストボックスに値を入力します。 - 変更を保存を選択します。
レート制限:
- デフォルトは毎分60リクエストです。
- 各認証済みユーザーに適用されます。リクエストが認証されていない場合、レート制限はIPアドレスに適用されます。
- 両方のエンドポイントのレート制限を無効にするには、
0に設定できます。
レート制限を超過したリクエストは、auth.logファイルにログが記録されます。
例えば、60の制限を設定した場合、1分あたり60リクエストを超えるAPIエンドポイントへのリクエストはブロックされます。エンドポイントへのアクセスは1分後に再開されます。
グループのアーカイブエンドポイントの詳細については、グループのアーカイブを参照してください。
グループメンバーの削除に関するレート制限を設定する
メンバー削除エンドポイントへのリクエストに対するグループおよびユーザーごとのレート制限を設定します。
前提条件:
- 管理者アクセス権。
レート制限を変更するには:
- 右上隅で、管理者を選択します。
- 左側のサイドバーで、設定 > ネットワークを選択します。
- メンバーAPIレート制限を展開します。
- グループまたはプロジェクトあたりの一分あたりの最大リクエスト数テキストボックスに値を入力します。
- 変更を保存を選択します。
レート制限:
- デフォルトは毎分60リクエストです。
- 各グループとユーザーに適用されます。
- レート制限を無効にするには、
0に設定できます。
レート制限を超過したリクエストは、auth.logファイルにログが記録されます。
例えば、60の制限を設定した場合、毎分60リクエストを超えるAPIエンドポイントへのリクエストはブロックされます。エンドポイントへのアクセスは1分後に復元されます。