GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves audit events for a specific group in GitLab using the GitLab API v4. It is useful for monitoring and auditing changes or activities within a GitLab group, such as tracking user actions or security-related events. For example, an administrator can use this node to fetch audit logs filtered by date or paginate through large sets of audit events.

Use Case Examples

  1. Fetch audit events for a GitLab group with ID 123, filtering events created after a specific date.
  2. Paginate through audit events for a group to review all changes made within a certain timeframe.

Properties

Name Meaning
Skip Authentication Whether to skip authentication for the API request.
baseUrl The base URL of the GitLab instance to connect to, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Query Parameters Optional query parameters to filter and paginate audit events.
Path Parameters Path parameters for the API request, specifically the group ID.

Output

JSON

  • id - The unique identifier of the audit event.
  • author_id - The ID of the user who performed the action.
  • entity_id - The ID of the entity affected by the audit event.
  • entity_type - The type of entity affected by the audit event.
  • details - Details about the audit event.
  • ip_address - IP address from which the action was performed.
  • created_at - Timestamp when the audit event was created.

Dependencies

  • GitLab API authentication

Troubleshooting

  • Ensure the group ID path parameter is correctly set and is a valid integer.
  • Verify that the authentication credentials for GitLab API are correctly configured and have sufficient permissions to access group audit events.
  • Check the base URL if connecting to a self-hosted GitLab instance to ensure it is correct.
  • If pagination parameters are used, ensure they are valid integers and within acceptable ranges.

Links

Discussion