GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation retrieves the container registry repositories for a specific project in GitLab using the GitLab API v4. It is useful for DevOps and development teams who want to programmatically access and manage container images stored in GitLab's container registry associated with their projects. For example, it can be used to list all container repositories for a project, including pagination and filtering options such as including tags or tag counts.

Use Case Examples

  1. A DevOps engineer wants to automate the retrieval of container repositories for a project to monitor image usage.
  2. A developer needs to list all container repositories with tags for a project to integrate with a CI/CD pipeline.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request (boolean). Defaults to false.
Authentication The authentication method used, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to connect to, default is https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Query Parameters Optional query parameters for the API call, including pagination and filtering options.
Path Parameters Path parameters for the API call, specifically the project ID or URL-encoded path.

Output

JSON

  • repositories - List of container registry repositories for the specified project.
  • pagination
    • page - Current page number of the results.
    • per_page - Number of items per page in the results.
    • total - Total number of container registry repositories available.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the project ID or URL-encoded path is correct to avoid 404 errors.
  • Verify that the API key has sufficient permissions to access the container registry repositories.
  • Check the base URL if using a self-hosted GitLab instance to avoid connection errors.
  • Pagination parameters should be valid integers; otherwise, the API may return errors or unexpected results.

Links

Discussion