GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation deletes a specific GitLab runner by its ID using the GitLab API. It is useful for managing CI/CD runners in GitLab projects, especially when you need to remove runners that are no longer needed or are being replaced. For example, a DevOps engineer can automate the cleanup of inactive runners to maintain an efficient CI/CD environment.

Use Case Examples

  1. Deleting a runner with a specific ID to free up resources.
  2. Automating runner management by removing runners that are no longer in use.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the API request.
Authentication Specifies the authentication method to use, defaulting to GitLab API authentication.
baseUrl The base URL of the GitLab instance to which the API request is sent.
Method The HTTP method used for the API request, defaulting to DELETE for this operation.
Path Parameters The path parameters for the API request, specifically the ID of the runner to delete.

Output

JSON

  • id - The ID of the runner that was deleted or targeted for deletion.
  • statusCode - The HTTP status code returned by the API indicating the result of the delete operation.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the runner ID provided in the path parameters is valid and exists in the GitLab instance.
  • Check that the API authentication credentials are correctly configured and have sufficient permissions to delete runners.
  • Verify the base URL is correct and accessible.
  • Common error messages include 404 Not Found if the runner ID does not exist, and 401 Unauthorized if authentication fails.

Links

Discussion