メタデータAPI
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
指定されたGitLabインスタンスのメタデータ情報を取得します。
GET /metadata
GET /versionレスポンスボディの属性:
| 属性 | 型 | 説明 |
|---|---|---|
version | 文字列 | GitLabインスタンスのバージョン。 |
revision | 文字列 | GitLabインスタンスのリビジョン。 |
kas | オブジェクト | Kubernetes向けGitLabエージェントサーバー (KAS)に関するメタデータ。 |
kas.enabled | ブール値 | KASが有効であるかどうかを示します。 |
kas.externalUrl | stringまたはnull | エージェントがKASと通信するために使用するURL。kas.enabledがfalseの場合、nullです。 |
kas.externalK8sProxyUrl | stringまたはnull | KubernetesツールがKAS Kubernetes APIプロキシと通信するために使用するURL。kas.enabledがfalseの場合、nullです。 |
kas.version | stringまたはnull | KASのバージョン。kas.enabledがfalseの場合、またはGitLabインスタンスがKASからサーバー情報をフェッチできなかった場合、nullです。 |
enterprise | ブール値 | GitLabインスタンスがEnterprise Editionであるかどうかを示します。 |
リクエスト例:
curl --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/metadata"curl --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/version"レスポンス例:
{
"version": "18.1.1-ee",
"revision": "ceb07b24cb0",
"kas": {
"enabled": true,
"externalUrl": "grpc://gitlab.example.com:8150",
"externalK8sProxyUrl": "https://gitlab.example.com:8150/k8s-proxy",
"version": "18.1.1"
},
"enterprise": true
}