GitLab API

GitlabTool

Actions1095

Clusters → getApiV4DiscoverCertBasedClusters

AI-generated

Summary

Retrieve all certificate-based clusters in the specified group's hierarchy from the GitLab instance via the /api/v4/discover-cert-based-clusters endpoint.

Inputs

  • Group_id (required) — The numeric ID of the group to find all certificate-based clusters within its hierarchy.
  • Skip Authentication — Optionally skip authenticating the request; defaults to false (authentication applied).
  • baseUrl — The base URL of the GitLab instance; defaults to https://gitlab.com.
  • Method — HTTP method to use for the request; defaults to GET.

Output shape

a single response object from the GET request to the /api/v4/discover-cert-based-clusters endpoint, typically a JSON list of clusters.

The operation requires the 'group_id' query parameter. Authentication uses the configured GitLab API credentials unless 'Skip Authentication' is enabled. No request body is sent. The response shape depends on the GitLab API and is returned unmodified.

Examples

Example 1: Retrieve certificate-based clusters for a group with ID 123

Set Group_id to 123, use default baseUrl (https://gitlab.com), default GET method, and authenticate with GitLab API credentials.

Links

Discussion