GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation deletes a specific tag from a container registry repository within a GitLab project. It is useful for managing container images by removing outdated or unwanted tags from the project's container registry. For example, a DevOps engineer might use this node to automate cleanup of old Docker image tags in a CI/CD pipeline.

Use Case Examples

  1. Deleting a tag named 'v1.0' from a container registry repository with ID 123 in a GitLab project with ID 'my-group/my-project'.
  2. Automating the removal of deprecated container image tags to free up storage space in the GitLab container registry.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request.
Authentication The authentication method used for the API request, typically an API key credential.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method The HTTP method for the API request, default is DELETE for this operation.
Path Parameters Parameters required in the API request path to identify the project, repository, and tag to delete.

Output

JSON

  • success - Indicates whether the tag deletion was successful.
  • statusCode - HTTP status code returned by the API.
  • responseBody - The response body from the API call, typically empty for successful deletion.

Dependencies

  • GitLab API authentication token or API key credential

Troubleshooting

  • Ensure the project ID, repository ID, and tag name are correct and exist in the GitLab instance.
  • Verify that the API authentication token has sufficient permissions to delete container registry tags.
  • Check the base URL is correctly set to the GitLab instance URL if using a self-hosted GitLab.
  • Common error messages include 404 Not Found if the project, repository, or tag does not exist, and 403 Forbidden if the authentication token lacks permissions.

Links

Discussion