GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation retrieves details of a specific cluster agent associated with a GitLab project. It is useful for scenarios where you need to fetch information about a particular cluster agent by specifying the project ID or URL-encoded path and the agent ID. For example, it can be used to monitor or manage cluster agents in a CI/CD pipeline or infrastructure automation workflow.

Use Case Examples

  1. Fetch details of a cluster agent for a given project to verify its status or configuration.
  2. Integrate with GitLab to automate cluster agent management based on project-specific requirements.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
Authentication Type of authentication used for the request, hidden unless Skip Authentication is false.
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 for the API path, including the project ID or URL-encoded path and the cluster agent ID.

Output

JSON

  • id - The unique identifier of the cluster agent.
  • name - The name of the cluster agent.
  • config - Configuration details of the cluster agent.
  • created_at - Timestamp when the cluster agent was created.
  • updated_at - Timestamp when the cluster agent was last updated.

Dependencies

  • GitLab API authentication token or credentials

Troubleshooting

  • Ensure the project ID and agent ID are correctly provided and URL-encoded if necessary.
  • Verify that the authentication credentials are valid and have sufficient permissions to access the cluster agent information.
  • Check the base URL if using a self-hosted GitLab instance to ensure it is correct.
  • Common error messages include 404 Not Found if the project or agent does not exist, and 401 Unauthorized if authentication fails.

Links

Discussion