GitLab API

GitlabTool

Actions1000

Overview

This node operation retrieves the job token scope allowlist for a specific project in GitLab. It is useful for users who want to manage or review the list of allowed job token scopes associated with a project, which can help in controlling CI/CD job permissions and security.

Use Case Examples

  1. A DevOps engineer uses this node to fetch the job token scope allowlist of a project to audit which job tokens are permitted to access certain resources.
  2. A project manager integrates this node in an automation workflow to monitor and report on job token scopes for compliance purposes.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Query Parameters Optional query parameters for pagination, including page number and items per page.
Path Parameters Path parameters required for the request, specifically the project ID.

Output

JSON

  • allowlist - The list of job token scopes allowed for the specified project.
  • pagination
    • page - Current page number of the paginated response.
    • per_page - Number of items per page in the paginated response.
    • total_pages - Total number of pages available.
    • total_items - Total number of items available.

Dependencies

  • GitLab API authentication token

Troubleshooting

  • Ensure the project ID is correctly provided in the path parameters to avoid 404 errors.
  • Verify that the GitLab API authentication token is valid and has sufficient permissions to access the project's job token scope allowlist.
  • Check the base URL if using a self-hosted GitLab instance to ensure it is correct.
  • Pagination parameters should be valid integers; otherwise, the API may return errors or unexpected results.

Links

Discussion