GitHub Actions APIとUIにおけるクエリ結果の変更Changes to query results in the GitHub Actions API and UI
匿名の公開いいねです。記事の保存・お気に入りではなく、Featured、Top 3、重要度、掲載順位には影響しません。仕組みとプライバシーAnonymous public likes are reactions, not saved articles or bookmarks. They do not affect Featured, Top 3, importance, or listing order.How it works and privacy
- GitHub Actionsは、ワークフロー実行の条件検索で該当件数が2,500件を超える場合、「2,500+」と表示するよう変更した。
- 最大1,000件のページ分割取得は維持され、検索性能と件数表示の信頼性が向上する。
GitHub Actions now labels filtered workflow-run totals above 2,500 as "2,500+" while retaining pagination for up to 1,000 items, giving users faster, more reliable counts.
本ページの本文と要約は AI による自動生成です。日本語版と英語版は言語ごとに独立して生成されるため、表現や詳しさが異なる場合があります。正確性は元記事 (github.blog) をご確認ください。The body and summaries are AI-generated independently for each language, so wording and detail may differ. Verify accuracy at the original source (github.blog).
要約と収集メタデータに基づく AI 解説。元記事全文の転載・翻訳ではありません。AI explainer based on the summaries and collected metadata, not a copy or translation of the full source article.
クエリ結果
GitHub ActionsのAPIとUIで、ワークフロー実行を条件検索した際の件数表示が変更された。大量のレコードが該当する検索では、厳密な総数を示す代わりに、精度と性能を重視した表示になる。
2,500件超
ワークフロー、イベント、ステータス、ブランチ、実行者を条件に検索し、見つかったレコードが2,500件を超える場合、件数は「2,500+」と報告される。従来のように正確な総数の算出を試みるのではなく、2,500件を超えていることを示す方式だ。そのため数値としての細かさは下がる一方、表示される件数の信頼性は高まると説明されている。
タイムアウト
2,500件を超えるレコードを取得するクエリは、頻繁にタイムアウトしていた。タイムアウトが発生すると、真の総数ではなく、その時点までに見つかったレコード数が返されることがあった。上限を設けて「2,500+」と報告することで、不完全な件数が正確な総数のように見える状況を避け、顧客向けの検索性能も改善するとされる。
フィルター
ページ分割された検索結果については、最大1,000件まで返す仕組みが維持される。一方、連携機能やスクリプトが単一のクエリから2,500件を超える一致したワークフロー実行を取得する必要がある場合は、検索条件を狭める必要がある。具体的には日付範囲を追加するなど、必要な実行だけを対象にする方法が示されている。
Queries for workflow runs
GitHub Actions has changed how query totals appear in its API and UI when users filter workflow runs. The change matters for searches with large result sets because the reported count is now less precise but more accurate.
The affected queries search by workflow, event, status, branch, or actor. When more than 2,500 records match a query, GitHub Actions now reports the total as “2,500+” rather than attempting to provide an exact number.
More accurate count
The previous approach could produce misleading totals for large searches. Queries retrieving more than 2,500 records frequently time out, causing them to return the number of records found before the timeout instead of the true total.
By imposing the reporting limit, GitHub Actions avoids presenting that incomplete count as an exact result. The displayed “2,500+” figure communicates that the result set exceeds the threshold without claiming a precision that the query may not reliably deliver. The announcement says this will make counts more accurate and improve performance for customers.
Paginated results
The change affects the reported count, but paginated query results remain available. GitHub Actions will continue returning paginated results of up to 1,000 items.
As a result, a query with more than 2,500 matching workflow runs can show “2,500+” as its total while continuing to provide results through the existing pagination behavior. The count should therefore be treated as a threshold indicator for these larger searches, rather than an exact total.
Narrow your filters
Integrations or scripts that rely on retrieving more than 2,500 matching workflow runs from one query may need narrower filters. GitHub recommends refining the query to target the specific runs required.
One stated option is to add a date range. Reducing the scope of a search can keep the matching set focused and allow integrations or scripts to retrieve the particular workflow runs they need without depending on a single query covering more than 2,500 matches.
ポコとTECHガイドPoko & TECH Guide
ポコと当サイトのTECHガイドが、記事の要約と収集した情報から読みどころを語るAI生成の対話です。Poko and TECH Dashboard's own TECH Guide discuss the article's highlights in an AI-generated conversation based on its summary and collected source details.
- ポコPoko2,500件を超えると「2,500+」になるのは、どうして正確な件数を出さないの？Why does it show “2,500+” instead of an exact total when there are more matches?
- TECHガイドTECH Guide2,500件超の検索はタイムアウトしやすく、途中の件数を返すことがあったからだよ。幅を持たせて、より確かな表示に変えたんだ。Queries above 2,500 often timed out and could report only the records found before that point. The broader label makes the displayed count more reliable.
- ポコPokoじゃあ、たくさんのワークフロー実行を探す人が、速くて信頼しやすい件数を見られるってこと？So people searching lots of workflow runs get a faster count they can trust more?
- TECHガイドTECH Guideうん、検索性能と件数表示の信頼性が上がる変更だね。結果はこれまで通り、最大1,000件までページ分割で取得できるよ。Yes. The change improves search performance and count reliability, while paginated results remain available for up to 1,000 items.
- ポコPoko正確な総数より「少なくとも2,500件超」と示して、検索を安定させるんだね。Got it—it favors a stable “more than 2,500” count over an unreliable exact total.
- TECHガイドTECH Guideただし、1回の検索で2,500件超を必要とする連携やスクリプトは、日付範囲などで条件を絞る必要があるよ。One caution: integrations or scripts needing over 2,500 matching runs from one query should narrow the filters, such as by adding a date range.
