AvantGuard - SentinelOne icon

AvantGuard - SentinelOne

AvantGuard - SentinelOne

Actions682

Overview

This node operation retrieves gateway data from the AvantGuard SentinelOne API using a wide range of optional query parameters to filter, sort, and paginate the results. It is useful for network administrators or security analysts who need to query detailed information about network gateways, such as their IP addresses, agent counts, scan settings, and timestamps. For example, it can be used to fetch gateways created after a certain date, filter by manufacturer, or limit results to those with a specific number of connected agents.

Properties

Name Meaning
Additional Query Parameters A collection of optional filters and settings to customize the API request. These include parameters for pagination (limit, skip, cursor), filtering by counts (total agents, number of rangers), scan settings (icmpScan, snmpScan, smbScan, etc.), date ranges (createdAt, updatedAt), IP and MAC address filters, sorting options (sortBy, sortOrder), and others to precisely control which gateways are returned.

Output

JSON

  • gateways - An array of gateway objects matching the query parameters.
  • totalCount - The total number of gateways matching the query, if countOnly is true or skipCount is false.
  • cursor - Cursor string for pagination to fetch the next set of results.

Dependencies

  • Requires AvantGuard SentinelOne API credentials (API key or token) to authenticate requests.
  • Depends on the '@avantguardllc/n8n-openapi-node' package for OpenAPI integration.

Troubleshooting

  • If authentication fails, verify that the API credentials are correctly configured and have sufficient permissions.
  • If no gateways are returned, check the query parameters for overly restrictive filters or incorrect formats.
  • Pagination issues may occur if 'cursor' or 'skip' parameters are misused; ensure correct usage to iterate over large result sets.
  • Invalid date or range formats in parameters like 'createdAt__between' or 'updatedAt__between' can cause errors; use the specified timestamp formats.
  • If the API returns errors about unknown parameters, verify that the parameter names and types match the expected API specification.

Discussion