GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation performs a POST request to the GitLab API endpoint `/api/v4/bulk_imports` to initiate bulk imports of entities such as groups or projects from a source GitLab instance to a destination namespace. It is useful for automating the migration or import of multiple entities in bulk, for example, when consolidating GitLab instances or migrating projects and groups programmatically.

Use Case Examples

  1. Automate migration of multiple GitLab groups and projects from one instance to another.
  2. Bulk import projects and groups into a new GitLab namespace using access tokens for authentication.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for testing or when authentication is handled externally.
baseUrl The base URL of the GitLab instance to which the bulk import request is sent, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is POST for this operation.
Parameter Schema Defines the form data parameters required for the bulk import request, including source GitLab URL, access token, and details about entities to import such as source type, source path, destination namespace, and migration options.

Output

JSON

  • id - The unique identifier of the bulk import job.
  • status - Current status of the bulk import process.
  • created_at - Timestamp when the bulk import was created.
  • updated_at - Timestamp of the last update to the bulk import.
  • entities - Details about the entities being imported, including their source and destination information.

Dependencies

  • GitLab API authentication token or API key credential

Troubleshooting

  • Ensure the access token provided has sufficient permissions to perform bulk imports on the source GitLab instance.
  • Verify that the source URL and entity paths are correctly formatted and accessible.
  • Check that the destination namespace exists and the user has rights to import entities there.
  • Common errors include authentication failures, invalid parameters in the form data, or network connectivity issues to the GitLab instance.

Links

Discussion