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