GitLab API icon

GitLab API

Gitlab

Actions880

Overview

This node operation retrieves a list of clusters associated with a specific GitLab group by calling the GitLab API endpoint `/api/v4/groups/{id}/clusters`. It is useful for users who want to manage or monitor Kubernetes clusters linked to their GitLab groups. For example, a DevOps engineer can use this node to fetch cluster details for automation or reporting purposes.

Use Case Examples

  1. Fetch clusters for a GitLab group with ID 123 to monitor their status.
  2. Automate retrieval of cluster information for integration with other systems.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the API request.
Authentication Type of authentication used for the API request, defaulting to GitLab API key.
baseUrl Base URL of the GitLab instance, default is https://gitlab.com.
Method HTTP method to use for the API request, default is GET.
Query Parameters Optional query parameters for pagination, including page number and items per page.
Path Parameters Path parameter specifying the group ID to fetch clusters for.

Output

JSON

  • clusters - Array of cluster objects returned from the GitLab API for the specified group.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the group ID path parameter is correctly set and not empty to avoid 404 errors.
  • Verify that the GitLab API key credential is valid and has sufficient permissions to access group clusters.
  • Check the base URL if using a self-hosted GitLab instance to ensure it is correct.
  • If pagination parameters are used, ensure they are valid integers to avoid request errors.

Links

Discussion