GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node operation retrieves details of a specific remote mirror for a GitLab project using the GitLab API. It is useful for scenarios where you need to monitor or manage remote mirrors of a project, such as verifying mirror status or configuration. For example, a user can fetch the remote mirror information by providing the project ID and the mirror ID.

Use Case Examples

  1. Fetch remote mirror details for a project to check synchronization status.
  2. Retrieve configuration of a specific remote mirror to audit or update settings.

Properties

Name Meaning
Skip Authentication If set to true, the node will skip using 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 to which the API request is sent, default is https://gitlab.com.
Method The HTTP method used for the API request, default is GET.
Path Parameters Parameters required in the API request path to identify the project and the remote mirror.

Output

JSON

  • id - The unique identifier of the remote mirror.
  • url - The URL of the remote mirror.
  • enabled - Indicates if the remote mirror is enabled.
  • only_protected_branches - Indicates if only protected branches are mirrored.
  • keep_divergent_refs - Indicates if divergent refs are kept.
  • mirror_trigger_builds - Indicates if mirror triggers builds.
  • last_update_at - Timestamp of the last update of the mirror.
  • last_successful_update_at - Timestamp of the last successful update.
  • last_error - Details of the last error encountered by the mirror.

Dependencies

  • Requires GitLab API key authentication unless Skip Authentication is enabled.

Troubleshooting

  • Ensure the project ID and mirror ID are correctly provided and URL-encoded if necessary.
  • Check that the GitLab API key has sufficient permissions to access project remote mirrors.
  • If skipping authentication, verify that the GitLab instance allows unauthenticated access to this endpoint.
  • Common errors include 404 Not Found if the project or mirror ID does not exist, and 401 Unauthorized if authentication fails.

Links

Discussion