GitLab API

GitlabTool
Join our community

Actions905

Overview

This node operation retrieves the list of protected tags for a specific project in GitLab using the GitLab API v4. It is useful for users who want to programmatically access information about protected tags in their GitLab projects, such as for automation, reporting, or integration purposes. For example, a DevOps engineer might use this node to fetch protected tags to enforce deployment policies or audit tag protections.

Use Case Examples

  1. Fetch protected tags for a project to display in a dashboard.
  2. Automate the retrieval of protected tags to verify compliance with tagging policies.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request.
Authentication The authentication method used for the API request, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method The HTTP method to use for the API request, defaulting to GET.
Parameter Schema Defines the parameters for the API request, including the project ID (path parameter) and pagination options (query parameters).
Query Parameters Optional query parameters for pagination: page number and items per page.
Path Parameters Path parameter specifying the project ID or URL-encoded path to identify the project.

Output

JSON

  • id - The ID of the protected tag.
  • name - The name of the protected tag.
  • create_access_levels - Access levels allowed to create the tag.
  • update_access_levels - Access levels allowed to update the tag.
  • delete_access_levels - Access levels allowed to delete the tag.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID provided in the path parameters is correct and accessible with the provided authentication.
  • Check that the GitLab API key has sufficient permissions to read protected tags.
  • Verify the baseUrl is correct if using a self-hosted GitLab instance.
  • Pagination parameters (page and per_page) should be valid integers; otherwise, the API may return errors or unexpected results.

Links

Discussion