GitHub のコードカバレッジ ruleset を REST API で管理とは？設定できる値・必要な条件・対象プランを一次情報で解説（2026年9月18日）

AI開発ツールアップデート料金改定GitHubテスト・品質

GitHub が 2026年9月18日に一般提供（GA）したのは、「Restrict code coverage」リポジトリ ruleset オプションを REST API で作成・更新・読み取れるようにする変更です。以前は Web UI でしか設定できませんでした。設定できる値・必要な条件・対象プランを一次情報で整理します。

結論から言うと、GitHub の「Restrict code coverage」リポジトリ ruleset を REST API で作成・更新・読み取れるようになりました（2026年9月18日 GA・従来は Web UI のみ）。以下、設定できる値・必要な条件・対象プランを一次情報の出典付きで解説します。

2026年9月18日、GitHub はプルリクエストのコードカバレッジを強制できるリポジトリ ruleset オプション「Restrict code coverage」を、REST API から作成・更新・読み取りできるようにしたと発表しました。一般提供（GA）です。以前はこのオプションの設定は Web UI だけで、数十〜数百のリポジトリへ同じルールを展開するには手作業が必要でした。API 対応により、既存の infrastructure-as-code（IaC）ワークフローに組み込めるようになります。

本稿では、REST API でできるようになったこと、使うための条件（GitHub Code Quality とカバレッジのアップロード）、対象プラン、既存の運用をどう変えられるかを、公式の一次情報だけから整理します。本文中の値はすべて出典付きで、取得日は 2026年9月19日です。

REST API でできるようになったこと

GitHub Changelog「Manage the code coverage ruleset condition with the REST API」（2026年9月18日）によると、リポジトリ ruleset のオプション「Restrict code coverage」を REST API で作成・更新・読み取りできるようになりました。UI での設定サポートはそのまま残り、API が追加される形です。

• できること: この ruleset オプションの作成・更新・読み取りをプログラムから実行する（発表の表現では create, update, and read programmatically）。
• 強制できる値: 行カバレッジ（line coverage）に基づく最小コードカバレッジ率、またはプルリクエストに対する最大許容カバレッジ低下（maximum tolerable coverage drop）。
• 組み込み先: 複数のリポジトリにまたがってカバレッジ要件を一貫して管理しやすくなり、既存の infrastructure-as-code ワークフローに組み込めます。
• エンドポイントの詳細: 発表は rules の REST API ドキュメント（docs.github.com/rest/repos/rules）と、rulesets で利用可能なルールのドキュメントを案内しています。具体的なエンドポイントのパスは発表には記載がありません。

使うための条件と対象プラン

利用要件は「リポジトリで GitHub Code Quality が有効で、コードカバレッジのアップロードが設定されていること」です。対象プランは GitHub Enterprise Cloud と GitHub Team（データレジデンシー付き Enterprise Cloud を含む）で、GitHub Enterprise Server では利用できません（出典: GitHub Changelog 2026年9月18日）。

• 前提 1: リポジトリで GitHub Code Quality が有効になっていること。
• 前提 2: コードカバレッジのデータがプルリクエストのブランチへアップロードされる設定になっていること。ルールはこのデータに対して評価されます。
• プラン: GitHub Enterprise Cloud、GitHub Team（データレジデンシー付き Enterprise Cloud を含む）。GitHub Enterprise Server は対象外です。

既存の運用をどう変えられるか（実務的な視点）

変わるのは「カバレッジルールの設定経路」です。これまで UI でリポジトリごとに設定していたルールを、スクリプトや IaC ツールの一部として定義できるため、組織内の標準（たとえば「PR でカバレッジが 2% より下がったらブロック」のような値）を多数のリポジトリへ同じ形で展開・監査しやすくなります。UI は変わらず使えるため、既存の設定を作り直す必要はありません。なお、今回の発表には料金の変更や無料プランへの展開に関する記載はなく、その点は公式未公表です。

関連記事: GitHub Actions ワークフロー実行保護 ／ stage-only npm トークン

よくある質問

Q. コードカバレッジの ruleset 条件はどのプランで使えますか？

GitHub Enterprise Cloud と GitHub Team です。データレジデンシー付き Enterprise Cloud を含みます。GitHub Enterprise Server では利用できません（出典: GitHub Changelog 2026年9月18日）。

Q. 何を強制できるのですか？

行カバレッジに基づく最小コードカバレッジ率の強制、またはプルリクエストに対する最大許容カバレッジ低下の設定です（出典: GitHub Changelog 2026年9月18日）。評価対象はカバレッジのデータで、利用には GitHub Code Quality の有効化とカバレッジのアップロード設定が必要です。

Q. UI で設定した既存の ruleset に影響はありますか？

ありません。UI での設定サポートはそのまま残り、REST API による管理が追加された形です（出典: GitHub Changelog 2026年9月18日）。既存の設定を作り直す必要はありません。

Q. API はどのドキュメントで確認できますか？

発表が案内している rules の REST API ドキュメント（docs.github.com/rest/repos/rules）で確認できます。エンドポイントの具体的なパスは今回の発表には記載されていません。

AI開発ツール速報（当サイト）は、GitHub・Cursor・VS Code など開発ツールの仕様変更や料金改定を、公式発表への出典付きで最速でお届けする速報メディアです。CI の品質ゲートのように開発フローに直接響く変更は、更新があったら当サイトの一覧で確認できます。

この記事は AI が一次ソースを読んで執筆しました。数値と日付は出典に記した公式情報の執筆時点の値です。誤りを見つけたら訂正の窓口へお知らせください。確認のうえ本文を直し、訂正履歴に残します。編集方針