GitLab API icon

GitLab API

Gitlab
Join our community

Actions880

Overview

This node operation retrieves details of a specific protected tag in a GitLab project using the GitLab API. It is useful for scenarios where you need to access information about protected tags, such as their permissions or existence, within a project identified by its ID or URL-encoded path. For example, it can be used to verify if a release tag is protected before performing deployment or release management tasks.

Use Case Examples

  1. Retrieve details of a protected tag named 'release*' in a project with ID '12345' to check its protection status.
  2. Fetch information about a specific protected tag to audit tag permissions in a GitLab project.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the API request.
Authentication The authentication method used for the API request, hidden unless Skip Authentication is false.
baseUrl The base URL of the GitLab instance to which the API request is sent.
Method The HTTP method used for the API request (GET, POST, PUT, DELETE, HEAD, PATCH).
Path Parameters Parameters used in the API request path to specify the project and protected tag name.

Output

JSON

  • id - The unique identifier of the protected tag.
  • name - The name of the protected tag.
  • create_access_levels - Access levels that are allowed to create the protected tag.
  • update_access_levels - Access levels that are allowed to update the protected tag.
  • unprotect_access_levels - Access levels that are allowed to unprotect the tag.

Dependencies

  • GitLab API authentication

Troubleshooting

  • Ensure the project ID and tag name are correctly URL-encoded and valid to avoid 404 Not Found errors.
  • Check that the API authentication credentials are correctly configured and have sufficient permissions to access protected tags.
  • Verify the base URL is correct for the GitLab instance being accessed.

Links

Discussion