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

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リクエストという未認証制限にはカウントされません:

これらのリクエストは引き続き現在のレート制限の対象となります。GitLab for SlackアプリにはIPアドレスごとに独自の制限もあり、1時間あたり1,000リクエスト、1分あたり100リクエストです。

持続制限

レート制限FreePremiumUltimate
ユーザーの認証済みトラフィック5,000/時15,000/時25,000/時
トップレベルグループのトラフィック5,000/時未確定未確定
IPアドレスからの認証されていないトラフィック60/時60/時60/時

バースト制限

レート制限FreePremiumUltimate
ユーザーの認証済みトラフィック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レスポンスを受け取ることがあります。

さらに余裕が必要な場合

定期的に制限に達する場合、関与の度合いが低いものから高いものまで、いくつかのオプションがあります:

  1. APIの使用方法を最適化します。リクエストをバッチ処理し、レスポンスをキャッシュし、ページネーションを使用し、Retry-Afterヘッダーに従います。ほとんどの使用状況は制限を下回ります。
  2. リクエストを認証します。匿名トラフィックは最も低い許容量を受け取ります。パーソナルアクセストークン、OAuthトークン、またはCI/CDジョブトークンで認証すると、プランの全制限が適用されます。
  3. プランをアップグレードします。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トライアル100700
Open Source1,50010,000
Premium5,00050,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エラーが表示されます。