AvantGuard - CIPP icon

AvantGuard - CIPP

AvantGuard - CIPP

Actions136

Overview

This node interacts with the AvantGuard CIPP API to retrieve detailed information about a specific device from a list. It is designed to fetch device details by specifying identifying parameters such as device ID, name, serial number, and tenant filter. This functionality is useful in scenarios where users need to programmatically access device metadata or status within an automation workflow, for example, to monitor devices, audit device configurations, or integrate device data into other systems.

Properties

Name Meaning
Deviceid The unique identifier of the device to retrieve details for.
Devicename The name of the device to retrieve details for.
Deviceserial The serial number of the device to retrieve details for.
Tenantfilter A filter parameter to specify the tenant context under which the device exists.

All these properties are required string inputs and are sent as query parameters in the API request.

Output

The node outputs JSON data containing the detailed information of the requested device. The exact structure depends on the API response but typically includes device attributes such as identifiers, configuration details, status, and possibly metadata related to the tenant context.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard CIPP API.
  • Needs the base URL of the resource API configured in the node credentials.
  • Depends on the @avantguardllc/n8n-openapi-node package for building request properties from the OpenAPI specification.

Troubleshooting

  • Missing or invalid credentials: Ensure that the API key and base URL are correctly set in the node credentials.
  • Required parameters not provided: All four input properties (deviceid, devicename, deviceserial, tenantfilter) must be supplied; missing any will likely cause the API call to fail.
  • API errors: If the API returns errors (e.g., device not found), verify that the device identifiers and tenant filter are correct.
  • Network issues: Confirm network connectivity to the API endpoint.

Links and References

Discussion