GitLab.comのレート制限
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab.com
以下のレート制限がGitLab.comに適用されます。
GitLab Self-ManagedおよびGitLab Dedicatedインスタンスには、インスタンスの運用者が管理する独自の制限があります。GitLab.comを使用しない場合は、代わりにレート制限または認証済みユーザーのレート制限を参照してください。
プランごとのレート制限
このセクションの制限は提案されているもので、まだ有効になっていません。現在のレート制限にある制限は現在適用されており、これらの変更が有効になった後も引き続き適用されます。GitLabは具体的な日付を事前に発表します。制限が適用される前に、GitLabは予定されたブラウンアウト期間を実施し、新しい制限が一時的に有効になることで、新しい制限がワークロードにどのような影響を与えるかを確認できるようにします。
レート制限はプランを考慮したものになりつつあります。全員に同じ数値を適用する代わりに、制限はプランを反映し、ユーザーごと、トップレベルグループごとに適用されます。認証済みリクエストには、プランの許容量が全て適用されます。匿名リクエストは、同様のプラットフォームと同様に、はるかに低い許容量を受け取ります。
各プランには認証済みトラフィックに対する2つの制限があり、持続制限が優先されます:
- 1時間ごとに測定される持続制限。この数値を使用して使用状況を計画してください。
- 1分ごとに測定されるバースト制限。GitLabはこのデフォルト値を設定することで、短時間のスパイクが1時間の許容量全体を一度に消費しないようにしています。
安定した作業では、持続制限に先に達します。バースト制限のレートで1時間継続してリクエストを送信すると、どのプランでも持続制限を超過します。バースト制限は、維持できるレートではなく、短時間のスパイクに対する上限として扱ってください。
バースト制限でリクエストを送信した場合、Freeでは約50分、Premiumでは12分、Ultimateでは12.5分で持続制限に達します。
これらの制限は、APIリクエスト、Webリクエスト、認証済みのHTTPS経由のGitリクエストに適用されます。各Gitのクローン、フェッチ、プッシュは1つのリクエストとしてカウントされ、各Git LFS転送も同様にカウントされます。一部の未認証リクエストは、IPアドレスからの1時間あたり60リクエストという未認証制限にはカウントされません:
- HTTPS経由のGitリクエスト
- 依存プロキシへのコンテナイメージリクエスト
- SAML SSOやGoogleやGitHubなどのサードパーティプロバイダーによるサインインを含むサインインリクエスト
- OAuth 2.0の認可、アクセストークン、デバイス認可、動的クライアント登録のリクエスト
- クラウドプロバイダーがCI/CD IDトークンを検証するために行うリクエストなど、OpenID Connectのディスカバリーリクエスト
- MCPクライアントがサインインする前に行うOAuthディスカバリーリクエスト
- Terraformモジュールレジストリからモジュールをインストールする前に行われるTerraformのサービスディスカバリリクエスト
- Unleashクライアントからの機能フラグのポーリング
- 登録トークンを使用してRunnerを登録するリクエスト
- アイデンティティプロバイダーからのSCIMプロビジョニングリクエスト
- Jira CloudがGitLab for Jira Cloudアプリに送信するリクエスト(リポジトリの検索やリンクなど)
- GitLab for Slackアプリからのリクエスト
- パイプライントリガートークンでパイプラインをトリガーするリクエスト
- モニタリングツールがアラートインテグレーションのエンドポイントに送信するアラート
これらのリクエストは引き続き現在のレート制限の対象となります。GitLab for SlackアプリにはIPアドレスごとに独自の制限もあり、1時間あたり1,000リクエスト、1分あたり100リクエストです。
持続制限
| レート制限 | Free | Premium | Ultimate |
|---|---|---|---|
| ユーザーの認証済みトラフィック | 5,000/時 | 15,000/時 | 25,000/時 |
| トップレベルグループのトラフィック | 5,000/時 | 未確定 | 未確定 |
| IPアドレスからの認証されていないトラフィック | 60/時 | 60/時 | 60/時 |
バースト制限
| レート制限 | Free | Premium | Ultimate |
|---|---|---|---|
| ユーザーの認証済みトラフィック | 100/分 | 1,250/分 | 2,000/分 |
| トップレベルグループのトラフィック | 400/分 | 5,000/分 | 10,000/分 |
制限を超えた場合
リクエストがレート制限されている場合、GitLabは429 Too Many Requestsステータスコードで応答します。再度リクエストを試みる前に待機してください。
スロットルされたリクエストへのレスポンスには、クォータがリセットされるまでの残り秒数を示すRetry-Afterヘッダーと、同じ情報を日時として示すRateLimit-ResetTimeヘッダーが含まれます。プロジェクトおよびグループの作成の制限では、期間は24時間であるため、Retry-Afterは最大86,400秒になる場合があります。スロットルされたかどうかにかかわらず、すべてのレスポンスには、制限に達する前に使用状況を追跡するために使用できるRateLimit-Limit、RateLimit-Remaining、および関連ヘッダーが含まれます。完全なリストについては、レスポンスヘッダーを参照してください。
制限を正しく処理するには:
- 再試行する前に、
Retry-Afterで指定された時間だけ待機します。 - スロットルされ続ける場合は、指数関数的にバックオフします。
RateLimit-Remainingを監視し、クォータを使い果たす前に速度を落とします。
プロジェクト、グループ、およびユーザーAPIのレート制限レスポンスには、情報ヘッダーは含まれていません。レスポンスヘッダーには他の一部の制限が反映されないため、前回のレスポンスのヘッダーに残りのクォータが表示されていた場合でも、429レスポンスを受け取ることがあります。
さらに余裕が必要な場合
定期的に制限に達する場合、関与の度合いが低いものから高いものまで、いくつかのオプションがあります:
- APIの使用方法を最適化します。リクエストをバッチ処理し、レスポンスをキャッシュし、ページネーションを使用し、
Retry-Afterヘッダーに従います。ほとんどの使用状況は制限を下回ります。 - リクエストを認証します。匿名トラフィックは最も低い許容量を受け取ります。パーソナルアクセストークン、OAuthトークン、またはCI/CDジョブトークンで認証すると、プランの全制限が適用されます。
- プランをアップグレードします。PremiumおよびUltimateには、より高い制限があります。
プランの制限を超える持続的なニーズに対応するため、追加の余裕を購入できるオプションが検討されています。詳細は、提供開始が近づいた時点で公開されます。
現在のレート制限
これらの制限は現在GitLab.comで有効であり、プランごとのレート制限が導入された後も引き続き適用されます。
GitLabは、まずプランの制限を確認し、次にこの表の制限を確認します。低い方の制限が適用されます。この表の制限は、プランの制限より低い場合があるため、先にその制限に達する可能性があります。
たとえば、ユーザーの認証済みAPIトラフィックは、1分あたり2,000リクエストに制限されています。FreeおよびPremiumでは、プランのバースト制限の方が低いため、先にその制限に達します。Ultimateでは、バースト制限も1分あたり2,000リクエストであるため、両方の制限は同じです。
| レート制限 | 設定 |
|---|---|
| IPアドレスの保護されたパス | 毎分10件のリクエスト |
IPアドレスごとのサインイン試行(POST /users/sign_in) | 5分ごとに10リクエスト |
| プロジェクト、コミット、またはファイルパスのrawエンドポイントトラフィック | 毎分300件のリクエスト |
| プロジェクトの未認証rawエンドポイントトラフィック | 800リクエスト/分 |
| IPアドレスからの認証されていないトラフィック | 毎分500件のリクエスト |
| ユーザーの認証済みAPIトラフィック | 毎分2,000件のリクエスト |
| ユーザーの認証済み非API HTTPトラフィック | 毎分1,000件のリクエスト |
| ユーザーの認証済みGit HTTPSトラフィック | 10,000リクエスト/分 |
| IPアドレスからの未認証Git HTTPSトラフィック | 15,000リクエスト/分 |
| ユーザー、プロジェクト、Gitコマンドごとのgit SSH操作 | 600操作/分 |
| IPアドレスからのすべてのトラフィック | 毎分2,000件のリクエスト |
| イシューの作成 | 毎分200件のリクエスト |
ユーザーのプロジェクト作成(POST /api/v4/projectsとUI) | 200リクエスト/日 |
ユーザーのグループ作成(POST /api/v4/groupsとUI) | 200リクエスト/日 |
| イシューおよびマージリクエストに関するノートの作成 | 毎分60件のリクエスト |
| IPアドレスの高度な検索、プロジェクト検索、またはグループ検索のAPI | 毎分100件のリクエスト |
| ユーザーの高度な検索、プロジェクト検索、またはグループ検索API | 毎分100件のリクエスト |
| IPアドレスのGitLab Pagesリクエスト | 50秒ごとに1,000件のリクエスト |
| GitLab PagesドメインのGitLab Pagesリクエスト | 10秒ごとに5,000件のリクエスト |
| IPアドレスのGitLab Pages TLS接続 | 50秒ごとに1,000件のリクエスト |
| GitLab PagesドメインのGitLab Pages TLS接続 | 10秒ごとに400件のリクエスト |
| プロジェクト、ユーザー、またはコミットのパイプライン作成リクエスト | 毎分25件のリクエスト |
| ユーザーのパイプライン作成リクエスト | 毎分2,000件のリクエスト |
| プロジェクトのアラートインテグレーションエンドポイントのリクエスト | 1時間あたり3,600件のリクエスト |
GitLab Duo aiActionのリクエスト | 8時間ごとに160件のリクエスト |
| プルミラーリングの間隔 | 5分 |
ユーザーから/api/v4/users/:idへのAPIリクエスト | 10分ごとに300件のリクエスト |
| IPアドレスごとのGitLabパッケージホスティングシステムリクエスト | 毎分1,000件のリクエスト |
| IPアドレスおよびトップレベルグループに対する仮想レジストリのリクエスト | 15秒ごとに4,000リクエスト |
| IPアドレスに対する拒否された仮想レジストリパッケージリクエスト | 15秒ごとに4,000リクエスト |
IPアドレスとファイルパスに対するリポジトリファイルAPIリクエスト(GET /api/v4/projects/:id/repository/files/*) | 毎分500件のリクエスト |
ユーザーフォロワーのリクエスト(/api/v4/users/:id/followers) | 毎分100件のリクエスト |
ユーザーのフォローリクエスト(/api/v4/users/:id/following) | 毎分100件のリクエスト |
ユーザーステータスのリクエスト(/api/v4/users/:user_id/status) | 毎分240件のリクエスト |
ユーザーSSHキーのリクエスト(/api/v4/users/:user_id/keys) | 毎分120件のリクエスト |
単一SSHキーのリクエスト(/api/v4/users/:id/keys/:key_id) | 毎分120件のリクエスト |
ユーザーGPGキーリクエスト(/api/v4/users/:id/gpg_keys) | 毎分120件のリクエスト |
単一のGPGキーリクエスト(/api/v4/users/:id/gpg_keys/:key_id) | 毎分120件のリクエスト |
ユーザープロジェクトリクエスト(/api/v4/users/:user_id/projects) | 毎分300件のリクエスト |
ユーザーがコントリビュートしたプロジェクトのリクエスト(/api/v4/users/:user_id/contributed_projects) | 毎分100件のリクエスト |
ユーザーのStar付きプロジェクトのリクエスト(/api/v4/users/:user_id/starred_projects) | 毎分100件のリクエスト |
プロジェクトリストのリクエスト(/api/v4/projects) | 10分ごとに2,000件のリクエスト |
IPアドレスからの未認証プロジェクト一覧リクエスト(/api/v4/projects) | 10分ごとに400リクエスト |
グループプロジェクトのリクエスト(/api/v4/groups/:id/projects) | 毎分600件のリクエスト |
単一プロジェクトのリクエスト(/api/v4/projects/:id) | 毎分400件のリクエスト |
グループリストのリクエスト(/api/v4/groups) | 50リクエスト/分 |
単一グループのリクエスト(/api/v4/groups/:id) | 毎分400件のリクエスト |
Runnerトークンを使用したRunnerジョブリクエスト(/api/v4/jobs/request) | 毎分2,000件のリクエスト |
IPアドレスからRunnerトークンを使用したRunnerジョブリクエスト(/api/v4/jobs/request) | 2,400リクエスト/分 |
ジョブトークンを使用したRunnerジョブトレースパッチリクエスト(/api/v4/jobs/trace) | 毎分200件のリクエスト |
ジョブトークンを使用したRunnerジョブリクエスト(/api/v4/jobs/*) | 毎分200件のリクエスト |
| プロジェクト内のすべてのプロジェクトメンバーを一覧表示 | 毎分200件のリクエスト |
保護パスおよびrawエンドポイントのレート制限の詳細については、リンク先をご覧ください。
GitLabは、いくつかのレイヤーでリクエストのレート制限を行うことができます。これらの制限は、各IPアドレスに対して最も制限の厳しいものです。
仮想レジストリのレート制限
仮想レジストリは、Mavenなどのパッケージリクエストに専用のレート制限を適用します。リクエストがどちらのレート制限にカウントされるかは、そのリクエストがアクセスチェックに合格するかどうかによって決まります:
| リクエスト | レート制限 | レート制限の範囲 |
|---|---|---|
| リクエストがアクセスチェックに合格した場合 | 15秒ごとに4,000リクエスト | IPアドレスおよびトップレベルグループ |
| リクエストがアクセスチェックに失敗した場合 | 15秒ごとに4,000リクエスト | IPアドレス |
リクエストが次の場合、アクセスチェックに失敗します:
- レジストリIDが存在しません。
- 認証情報が存在しないか、無効です。
- ユーザーがレジストリへのアクセス権を持っていません。
認証済みの仮想レジストリパッケージリクエストは、ユーザーの認証済みAPIトラフィック制限やプランごとのレート制限にはカウントされません。代わりに仮想レジストリのレート制限が適用されます。
ユーザーごとの除外、およびアクセスチェックに失敗したリクエストの制限は、パッケージリクエストのみに適用され、コンテナ仮想レジストリのリクエストには適用されません。
いずれかの制限を超えると、GitLabは429 Too Many Requestsエラーを返します。保護されたパスのスロットルは引き続き適用されます。
Service Deskメールのレート制限
GitLab.comは、トップレベルグループが1時間ごとおよび1日ごとに送信できるService Deskの送信通知メールの数をプランごとに制限します:
| プラン | 1時間あたりの制限 | 1日あたりの制限 |
|---|---|---|
| Free、Premiumトライアル、Ultimateトライアル | 100 | 700 |
| Open Source | 1,500 | 10,000 |
| Premium | 5,000 | 50,000 |
| Ultimate、Ultimateトライアル有料顧客 | 無制限 | 無制限 |
詳細については、Service Deskメールのレート制限を参照してください。
エクスポートファイルをアップロードすることによるグループとプロジェクトのインポート
不正利用を防ぐため、GitLab.comは次の項目にレート制限を適用します:
- プロジェクトとグループのインポート
- ファイルを使用するグループおよびプロジェクトのエクスポート
- エクスポートのダウンロード
詳細については、以下を参照してください。
IPブロック
IPブロックは、GitLab.comが単一のIPアドレスからシステムが潜在的に悪意のあるものと見なす異常なトラフィックを受信した場合に発生する可能性があります。これらのブロックは、レート制限の設定に基づく場合があります。異常なトラフィックが収まると、GitLabは自動的にIPアドレスを解放します。解放のタイミングは、次のセクションで説明するブロックの種類によって異なります。
GitLab.comへのすべてのリクエストに対して403 Forbiddenエラーを受け取る場合は、ブロックを引き起こしている可能性のある自動化プロセスがないか確認してください。サポートが必要な場合は、影響を受けているIPアドレスなどの詳細を添えてGitLabサポートにお問い合わせください。
Gitおよびコンテナレジストリの認証失敗によるBAN
単一のIPアドレスが1分間に300件の認証失敗リクエストを送信すると、GitLab.comは15分間403 Forbiddenステータスコードで応答します。
このレスポンスは、Gitリクエストとコンテナレジストリ(/jwt/auth)リクエスト(合計)にのみ適用されます。
この制限は、次のようになります。
- 認証に成功したリクエストでリセットされます。たとえば、299件の認証失敗リクエストの後に成功したリクエストが1件、さらにその後に299件の認証失敗リクエストが続いても、利用停止はトリガーされません。
gitlab-ci-tokenで認証されたJSON Webトークンリクエストには適用されません。
応答ヘッダーは提供されません。
HTTPS経由のGitリクエストは、常に最初に未認証のリクエストを送信します。これはプライベートリポジトリの場合、401 Unauthorizedエラーになります。その後Gitは、利用可能であれば、ユーザー名、パスワード、またはアクセストークンを使用して認証済みリクエストを試みます。これらのリクエストでは、同時にあまりに多くのリクエストが送信されると、一時的なIPブロックにつながる可能性があります。このイシューを解決するには、SSHキーを使用してGitLabと通信します。
設定できない制限
GitLab.comで使用されている非設定可能なレート制限の詳細については、非設定可能な制限を参照してください。
ページネーション応答ヘッダー
パフォーマンス上の理由から、クエリが10,000件を超えるレコードを返す場合、GitLabは一部のヘッダーを除外します。
保護パスのスロットル
同じIPアドレスが1分間に保護されたパスへ10件を超えるPOSTリクエストを送信すると、GitLab.comは429 Too Many Requestsステータスコードを返します。
保護されたパスには、ユーザー作成、ユーザー確認、ユーザーサインイン、パスワードリセットが含まれます。完全なリストについては、保護されたパスを参照してください。
GitLabがブロックされたリクエストに含めるヘッダーについては、ユーザーおよびIPのレート制限を参照してください。
SSHの最大接続数
GitLab.comは、MaxStartups設定を使用して、同時実行される認証されていないSSH接続の最大数を定義します。許可されている最大接続数を超える接続が同時に発生した場合、GitLabは超過分の接続を破棄します。その結果、ユーザーにはssh_exchange_identificationエラーが表示されます。