GitLab Extended icon

GitLab Extended

Extended GitLab node
Join our community

Actions66

Overview

This node interacts with GitLab to manage tags within a project repository. Specifically, the "Get Many" operation under the "Tag" resource retrieves multiple tags from a specified GitLab project. It supports fetching either all tags or a limited number based on user input.

Common scenarios where this node is beneficial include:

  • Automating retrieval of all tags in a project for reporting or auditing purposes.
  • Integrating tag data into workflows that require versioning information.
  • Filtering and processing tags programmatically without manual GitLab UI interaction.

For example, you might use this node to fetch the latest 10 tags of a project to trigger deployment pipelines or generate release notes.

Properties

Name Meaning
Authentication Choose between using saved credentials ("Credential") or specifying custom connection details ("Custom").
GitLab Server Base URL of your GitLab instance (e.g., https://gitlab.com). Used only if "Custom" authentication is selected.
Access Token Personal access token with API permissions. Used only if "Custom" authentication is selected.
Project Owner Namespace or owner of the project. Ignored if "Project ID" is set. Used only if "Custom" authentication is selected.
Project Name Project slug or name. Ignored if "Project ID" is set. Used only if "Custom" authentication is selected.
Project ID Numeric project ID. Takes precedence over owner and name if provided. Used only if "Custom" authentication is selected.
Return All Whether to return all available tags (true) or limit the number of results (false).
Limit Maximum number of tags to return when "Return All" is false. Defaults to 50.

Output

The output is an array of JSON objects representing GitLab tags retrieved from the project repository. Each object typically includes properties such as:

  • name or tag_name: The name of the tag.
  • message: Optional message associated with the tag.
  • commit: Information about the commit the tag points to.
  • Other metadata related to the tag.

No binary data is output by this operation.

Dependencies

  • Requires access to a GitLab instance, either the public https://gitlab.com or a self-hosted GitLab server.
  • Requires an API access token with appropriate permissions to read repository tags.
  • Supports two authentication modes: using stored credentials or custom parameters.
  • No additional external dependencies beyond standard HTTP requests to GitLab's REST API.

Troubleshooting

  • Invalid or missing project identification: If neither a valid project ID nor both project owner and name are provided (when using custom authentication), the request may fail. Ensure correct project identifiers are supplied.
  • Authentication errors: Using an invalid or expired access token will cause authorization failures. Verify the token has sufficient API scope.
  • Rate limiting: Fetching all tags (Return All = true) on very large repositories may hit GitLab API rate limits or timeouts. Use the Limit property to restrict results if needed.
  • Invalid JSON in optional fields: Although not applicable for "Get Many" tags, other operations involving JSON inputs may throw errors if malformed JSON is provided.
  • Network issues: Connectivity problems to the GitLab server will cause request failures. Confirm network access and server availability.

Links and References

Discussion