AvantGuard - CIPP icon

AvantGuard - CIPP

AvantGuard - CIPP

Actions136

Overview

This node integrates with the AvantGuard CIPP API to retrieve statistical data about list functions. Specifically, for the "List" resource and the "Retrieve List Function Stats" operation, it fetches function statistics based on parameters such as function type, interval, tenant filter, and time. This node is useful in scenarios where users want to monitor or analyze performance metrics or usage statistics of specific list functions over defined periods.

Practical examples include:

  • Monitoring how a particular function type performs across different tenants.
  • Retrieving usage statistics within a specified time interval to generate reports.
  • Filtering stats by tenant to isolate data relevant to specific organizational units.

Properties

Name Meaning
Functiontype The type of function for which statistics are requested.
Interval The time interval over which to aggregate or retrieve statistics (e.g., hourly, daily).
Tenantfilter A filter specifying which tenant(s) to include in the statistics retrieval.
Time The specific time or time range for which to retrieve the statistics.

Output

The node outputs JSON data containing the retrieved list function statistics from the AvantGuard CIPP API. The structure of the JSON output corresponds directly to the API response for the requested function stats, typically including metrics aggregated according to the provided parameters.

If the API supports binary data output, this node does not explicitly handle or output binary data; all outputs are JSON-formatted.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard CIPP API.
  • The base URL for the API is configured via credentials and used as the request base URL.
  • Depends on the @avantguardllc/n8n-openapi-node package for building properties and handling OpenAPI integration.
  • Requires network access to the AvantGuard CIPP API endpoint.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect parameter values (e.g., unsupported function types or intervals) may result in API errors or empty responses.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:

    • Authentication errors typically indicate invalid or expired API keys; verify and update credentials.
    • Parameter validation errors suggest that one or more input properties have invalid values; check property definitions and ensure correct inputs.
    • Timeout or connection errors imply network issues; confirm API endpoint accessibility.

Links and References

Discussion