Skip to main content

このバージョンの GitHub Enterprise サーバーはこの日付をもって終了となりました: 2024-09-25. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの向上、新機能の向上を図るために、最新バージョンの GitHub Enterprise サーバーにアップグレードしてください。 アップグレードに関するヘルプについては、GitHub Enterprise サポートにお問い合わせください

REST API はバージョン管理になりました。 詳細については、「API のバージョン管理について」を参照してください。

GitHub Enterprise 管理用の REST API エンドポイント

REST API を使うと、Enterprise の管理ができます。

Note

これらのエンドポイントでは、personal access token (classic) を使う認証のみがサポートされます。 詳しくは、「個人用アクセス トークンを管理する」を参照してください。

エンドポイント URL

これらのエンドポイント (Manage GitHub Enterprise Server API と Management Console API を除く) の前には、次の URL が付けられます。

http(s)://HOSTNAME/api/v3

Manage GitHub Enterprise Server API と Management Console API のエンドポイントの前には、ホスト名と管理ポートのみが付けられます。

http(s)://HOSTNAME:ADMINISTRATION-PORT/

認証

GitHub Enterprise Server のインストールの API エンドポイントは、GitHub API と同じ認証方法を受け入れます。 詳しくは、「REST API に対する認証」をご覧ください。

これらのエンドポイントで使用する場合、OAuth トークンには site_admin OAuth スコープが必要です。

これらのエンドポイントには、認証された GitHub Enterprise Server サイト管理者のみがアクセスできます。ただし、管理コンソール ユーザーとして認証できる GitHub Enterprise Server の管理用の REST API エンドポイント API と 管理コンソール用の REST API エンドポイント API のエンドポイントは除きます。 「Web UI からインスタンスを管理する」を参照してください。

バージョン情報

Enterprise の現在のバージョンは、REST API の応答ヘッダー X-GitHub-Enterprise-Version: enterprise-server@3.10.0 で返されます。 GET /metaを呼び出すことで、現在のバージョンを読み取ることもできます。 詳しくは、「メタデータ用 REST API エンドポイント」をご覧ください。

エンドポイント