GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation retrieves certificate-based clusters within a specified group hierarchy from the GitLab API. It is useful for users who need to discover and manage clusters associated with a particular group in GitLab, especially in environments where certificate-based authentication is used for cluster access. For example, a DevOps engineer might use this operation to list all clusters under a project group to monitor or configure them.

Use Case Examples

  1. Retrieve all certificate-based clusters for a given group ID to audit cluster access.
  2. Automate the discovery of clusters in a GitLab group for integration with monitoring tools.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the API request.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the API request is sent.
Method The HTTP method used for the API request, defaulting to GET.
Query Parameters Collection of query parameters for the API request, specifically the group_id to find certificate-based clusters in the hierarchy.

Output

JSON

  • clusters - List of certificate-based clusters discovered in the specified group hierarchy.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the group_id query parameter is provided and is a valid integer; missing or invalid group_id will cause the request to fail.
  • If authentication is enabled, verify that the GitLab API key credential is correctly configured and has sufficient permissions to access cluster information.
  • Check the baseUrl to ensure it points to the correct GitLab instance, especially if using a self-hosted GitLab server.

Links

Discussion