GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation retrieves details of a specific cluster within a GitLab group by making a GET request to the GitLab API endpoint `/api/v4/groups/{id}/clusters/{cluster_id}`. It is useful for scenarios where you need to fetch cluster information associated with a particular group in GitLab, such as monitoring cluster status or managing cluster configurations.

Use Case Examples

  1. Fetch details of a Kubernetes cluster linked to a GitLab group to monitor its status.
  2. Retrieve cluster information to automate deployment workflows based on cluster attributes.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public or unauthenticated endpoints.
Authentication Type of authentication to use, defaulting to GitLab API key authentication.
baseUrl Base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Path Parameters Parameters to specify the group ID and cluster ID for the API request.

Output

JSON

  • id - The unique identifier of the cluster.
  • name - The name of the cluster.
  • environment_scope - The environment scope associated with the cluster.
  • status - The current status of the cluster.
  • platform_kubernetes_version - The Kubernetes version of the cluster platform.
  • created_at - Timestamp when the cluster was created.
  • updated_at - Timestamp when the cluster was last updated.

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the group ID and cluster ID path parameters are correctly set; incorrect IDs will result in 404 Not Found errors.
  • If authentication is enabled, verify that the GitLab API key credential is valid and has sufficient permissions to access group cluster information.
  • Check the base URL if using a self-hosted GitLab instance to ensure it is correct and accessible.

Links

Discussion