GitLab API

GitlabTool
Join our community

Actions905

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 can automate the cleanup of old container tags to maintain a clean and efficient registry.

Use Case Examples

  1. Deleting a tag named 'v1.0' from a container registry repository with ID 123 in a project with ID 'my-group/my-project'.
  2. Automating the removal of deprecated container 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 used for the request, which is DELETE for this operation.
Path Parameters Parameters required in the request path to identify the project, repository, and tag to delete.

Output

JSON

  • statusCode - HTTP status code of the delete operation response.
  • body - Response body from the GitLab API after attempting to delete the tag.

Dependencies

  • GitLab API authentication credential

Troubleshooting

  • Ensure the project ID, repository ID, and tag name are correctly specified; incorrect values will cause the API call to fail.
  • Authentication errors may occur if the API key credential is missing or invalid; verify the credential configuration.
  • The tag may not exist or may have already been deleted, resulting in a 404 Not Found error from the API.

Links

Discussion