コンテンツへスキップ

GitHub Actionsでの API レート制限超過: 対処法

最終更新

GitHub ActionsのログにAPI rate limit exceeded for installation IDと表示された場合、ステップがワークフローのGITHUB_TOKENを使ってGitHub APIを呼び出し、1時間の上限を使い切ったことを意味します。このトークンは1リポジトリあたり1時間に1,000リクエストに制限されています(GitHub Enterprise Cloudアカウントが所有するリソースでは15,000)。対処法は、呼び出し回数を減らす、結果をキャッシュする、より適切なトークンで認証する、またはGitHubから指示があった場合に待機する、のいずれかです。上限の数値はGitHubのREST API レート制限のドキュメント(2026年10月確認)によるものです。

表示される正確なメッセージ

HttpError: API rate limit exceeded for installation ID 12345678.
403 API rate limit exceeded for installation. If you reach out to GitHub Support for help, please include the request ID ...
You have exceeded a secondary rate limit. Please wait a few minutes before you try again.
rate limit exceeded

最初の表示形式はプライマリ制限で、1時間分の上限を使い切ったときに発生します。「secondary rate limit」と表示される形式は、1時間の合計数ではなくリクエストのパターンに関するものです。関連する表示形式として、API rate limit exceeded for user ID ...(個人用トークンの場合)と、API rate limit exceeded for <IP> (But here's the good news: Authenticated requests get a higher rate limit)(トークンを一切使わずに呼び出した場合)があります。

適用される制限

認証情報制限
トークンなし(IP単位)1時間あたり60リクエスト
個人用アクセストークン(ユーザー)1時間あたり5,000
GitHub Appのインストール1時間あたり5,000。リポジトリやユーザーの数に応じて最大12,500まで増加
ActionsのGITHUB_TOKENリポジトリごとに1時間あたり1,000
GITHUB_TOKEN、Enterprise Cloudアカウントリポジトリごとに1時間あたり15,000

GITHUB_TOKENの上限は、同じリポジトリで同じ1時間内に実行されるすべてのワークフロー実行で共有されます。ジョブ数の多いリポジトリでは、各ジョブが数十回しか呼び出さなくても、上限を使い切ってしまうことがあります。

ドキュメントによるセカンダリ制限は次のとおりです。同時リクエストは100件まで、REST エンドポイントでは1分あたり900ポイントまで、一般に内容を作成するリクエストは1分あたり80件まで、1時間あたり500件までです。GitHubは、これらの値が予告なく変更される場合があると説明しています。

考えられる原因(可能性の高い順)

1. マトリックスや多数の実行が同時にAPIを呼び出す

30個のマトリックスセルがそれぞれgh apiやリリース用アクションを40回呼び出すと、合計1,200リクエストになります。呼び出しを1つのジョブにまとめ、結果を共有してください。

2. リストに対するループ

gh pr listの後にPRごとにgh apiを実行するのは典型的なパターンです。ページ分割された1回の呼び出しを使うか、複数のフィールドを1リクエストにまとめられるGraphQLを使ってください。

- run: gh pr list --state open --json number,title,labels --limit 200
  env:
    GH_TOKEN: ${{ github.token }}

3. リリースのダウンロードやバージョン確認を行うツール

最新バージョンを取得するためにReleases APIへ問い合わせるバージョンマネージャーやセットアップアクション(asdf、nvmのエイリアス、setup-*アクションでlatestを指定するもの)は、トークンを使用します。バージョンを固定するか、トークンを渡して、キャッシュまたは認証済みの上限を利用するようにしてください。

4. トークンなしの呼び出し

ランナーからのトークンなしの呼び出しは、ランナーのIP上限である1時間あたり60を共有します。必ずトークンを渡してください。

env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

5. 同じリポジトリ内のボットや自動化

Dependabot、ラベル付けツール、古いIssueを整理するボット、リリースツールはいずれも、同じリポジトリの上限を消費します。

6. 急激なリクエストによるセカンダリ制限

ループ内で大量のコメント、Issue、ステータスを作成すると、セカンダリ制限に達します。短いsleepを入れて速度を落とし、これらの呼び出しを並列に実行しないでください。

対処法

残りの上限を確認する

- run: gh api rate_limit --jq '.resources.core'
  env:
    GH_TOKEN: ${{ github.token }}

ドキュメントによると、信頼できる情報源はレスポンスヘッダーのx-ratelimit-remainingとx-ratelimit-reset(エポック秒)です。

負荷の高い自動化にはGitHub Appトークンを使う

GitHub Appのインストールには独自の1時間あたり5,000の上限があります(大規模なインストールではさらに多くなります)。これはリポジトリのGITHUB_TOKENとは別です。create-github-app-tokenアクションを使うと、ジョブ内でトークンを発行できます。

- uses: actions/create-github-app-token@v1
  id: app
  with:
    app-id: ${{ vars.APP_ID }}
    private-key: ${{ secrets.APP_PRIVATE_KEY }}
- run: gh api repos/${{ github.repository }}/issues --paginate
  env:
    GH_TOKEN: ${{ steps.app.outputs.token }}

インストールトークンのレート制限メッセージにも「installation ID」と表示されるため、ステップがどのトークンを使っているかを確認してください。

制限時の待機

プライマリ制限の場合は、x-ratelimit-resetの時刻まで待ちます。セカンダリ制限の場合、GitHubはretry-afterがあればそれに従い、なければ少なくとも1分待ってから指数バックオフを行うよう勧めています。ドキュメントでは、制限中にリクエストを送り続けると、インテグレーションが禁止される可能性があるとも警告しています。

for i in 1 2 3 4; do
  gh api repos/OWNER/REPO/issues && break
  sleep $((30 * i))
done

リクエストを減らす

  • ETagとIf-None-Matchを使った条件付きリクエストを利用してください。304レスポンスはプライマリ制限にカウントされません。
  • per_page=100とフィルターを使って、必要なデータだけを要求してください。
  • 変更が少ない API の結果は、actions/cache でキャッシュしてください(GitHub Actions のキャッシュを参照)。
  • スケジュールされたジョブの実行頻度を下げ、cron の時刻をずらしてください(cron ビルダー)。

Docker やキャッシュの制限とは別物です

エラーに toomanyrequests が含まれる場合は、Docker の pull レート制限を参照してください。キャッシュ API の制限(1 分あたりのアップロード数)はこの制限とは別です。詳しくはキャッシュの制限を参照してください。レート制限はトークンごとに適用され、ランナーの速度とは無関係です。そのため、ランナーのプロバイダーを変更してもこの制限は変わりません。compiler.dev などのプロバイダーでも、GitHub API の呼び出しには引き続きお使いの GitHub トークンが使われます。

予防方法

  1. GITHUB_TOKEN は軽量な呼び出しにのみ使用し、大量の自動化には App トークンを使用してください。
  2. API の呼び出しはマトリックスの各セルではなく、1 つのジョブにまとめてください。
  3. 項目ごとのループよりも、GraphQL やページネーションされたリスト取得を優先してください。
  4. ツールのバージョンを固定し、セットアップのステップで API に問い合わせないようにしてください。
  5. 負荷の高いワークフローの最後に残りのクォータを記録し、増加傾向を把握してください。

よくある質問

GITHUB_TOKEN のレート制限はどのくらいですか?

リポジトリごとに 1 時間あたり 1,000 リクエストです。GitHub Enterprise Cloud アカウントのリソースでは 15,000 リクエストです。

ワークフロー内でレート制限を確認するには?

GH_TOKEN を設定したうえで gh api rate_limit を実行するか、任意の API レスポンスから x-ratelimit-remaining ヘッダーを読み取ってください。

セカンダリレート制限とは何ですか?

リクエストのパターンに対する制限です。たとえば、同時実行数が多すぎるリクエストや、コンテンツを作成するリクエストが多すぎる場合に適用されます。1 時間あたりのクォータに余裕があっても発動することがあります。

制限は 1 時間ごとにリセットされますか?

はい。ウィンドウは x-ratelimit-reset に示された時刻にリセットされます。