GitLab API

GitlabTool
Join our community

Actions1000

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.

Use Case Examples

  1. A DevOps engineer wants to list all certificate-based clusters under a specific GitLab group to audit cluster access and configurations.
  2. A system administrator needs to automate the discovery of clusters for monitoring and management purposes within a GitLab group.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the API request.
Authentication Specifies the authentication method to use, hidden if Skip Authentication is true.
baseUrl The base URL of the GitLab instance to send the request to.
Method The HTTP method to use for the request (GET, POST, PUT, DELETE, HEAD, PATCH).
Query Parameters Collection of query parameters for the request, specifically the group_id to find clusters in the hierarchy.

Output

JSON

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

Dependencies

  • GitLab API authentication

Troubleshooting

  • Ensure the group_id query parameter is provided and is a valid integer; otherwise, the API request will fail.
  • If Skip Authentication is false, ensure valid GitLab API credentials are configured to avoid authentication errors.
  • Check the baseUrl to confirm it points to a valid GitLab instance; incorrect URLs will cause request failures.

Links

Discussion