GitLab API

GitlabTool

Actions905

Overview

This node operation retrieves Debian distributions associated with a specific GitLab group by calling the GitLab API. It is useful for users who want to fetch detailed information about Debian package distributions managed within a GitLab group, such as for software release management or package repository monitoring. For example, a DevOps engineer might use this node to automate the retrieval of Debian distribution metadata for a group to integrate with CI/CD pipelines or reporting tools.

Use Case Examples

  1. Fetch Debian distributions for a GitLab group by specifying the group ID and optional filters like codename or version.
  2. Paginate through Debian distributions using page and per_page query parameters to handle large result sets.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request (boolean). Defaults to false.
Authentication The authentication method used for the API request, hidden unless Skip Authentication is true. Defaults to GitlabApi.
baseUrl The base URL of the GitLab instance to send the API request to. Defaults to https://gitlab.com.
Method The HTTP method used for the API request. Defaults to GET.
Parameter Schema Defines the parameters accepted by the API endpoint, including path and query parameters such as group ID, pagination, and Debian distribution filters like codename, suite, origin, label, version, description, valid time duration, components, and architectures.
Query Parameters Collection of optional query parameters to filter and paginate the Debian distributions, including page, per_page, codename, suite, origin, label, version, description, valid_time_duration_seconds, components, and architectures.
Path Parameters Collection of path parameters required by the API endpoint, specifically the group ID or URL-encoded path.

Output

JSON

  • id - The ID or URL-encoded path of the GitLab group for which Debian distributions are retrieved.
  • page - The current page number of the paginated results.
  • per_page - The number of items per page in the paginated results.
  • codename - The Debian Codename filter applied to the distributions.
  • suite - The Debian Suite filter applied to the distributions.
  • origin - The Debian Origin filter applied to the distributions.
  • label - The Debian Label filter applied to the distributions.
  • version - The Debian Version filter applied to the distributions.
  • description - The Debian Description filter applied to the distributions.
  • valid_time_duration_seconds - The duration before the Release file should be considered expired by the client.
  • components - The list of Debian Components filter applied to the distributions.
  • architectures - The list of Debian Architectures filter applied to the distributions.

Dependencies

  • GitLab API authentication (an API key credential)

Troubleshooting

  • Ensure the group ID path parameter is correctly provided and URL-encoded if necessary, as missing or incorrect IDs will cause API errors.
  • Verify that the authentication credentials are valid and have sufficient permissions to access the group's Debian distributions.
  • Check that optional query parameters are correctly formatted, especially arrays like components and architectures, to avoid request failures.
  • If pagination parameters (page, per_page) are used, ensure they are positive integers to prevent invalid request errors.

Links

Discussion