GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation retrieves the 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 to display in a dashboard.
  2. Automate monitoring of cluster status for a specific group.

Properties

Name Meaning
Skip Authentication If set to true, the node will skip using authentication for the API request.
Authentication Select the authentication method to use for the API request (hidden unless Skip Authentication is false).
baseUrl The base URL of the GitLab instance to connect to, defaulting to https://gitlab.com.
Method HTTP method to use for the API request, default is GET.
Query Parameters Optional query parameters to control pagination of results.
Path Parameters Path parameters required for the API endpoint.

Output

JSON

  • id - Unique identifier of the cluster.
  • name - Name of the cluster.
  • environment_scope - The environment scope the cluster is associated with.
  • platform_kubernetes_api_url - API URL of the Kubernetes platform.
  • status - Current status of the cluster.
  • created_at - Timestamp when the cluster was created.
  • updated_at - Timestamp when the cluster was last updated.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the group ID path parameter is correctly set; missing or incorrect ID will cause API errors.
  • Verify that the authentication credentials are valid and have sufficient permissions to access group clusters.
  • Check the baseUrl if using a self-hosted GitLab instance to ensure it is correct.
  • Pagination parameters (page, per_page) should be valid integers; invalid values may cause unexpected results or errors.

Links

Discussion