AvantGuard - SentinelOne icon

AvantGuard - SentinelOne

AvantGuard - SentinelOne

Actions682

Overview

This node operation fetches inventory tags related to assets from a web API using a POST request. It allows users to specify a wide range of optional query parameters and body fields to filter, sort, and paginate the results. This is useful for retrieving detailed tag information about assets in environments such as cloud providers or on-premises infrastructure, enabling asset management, compliance checks, or security auditing.

Properties

Name Meaning
Additional Query Parameters A collection of optional query parameters to filter, sort, and paginate the asset tags data. These include filters on cloud provider details, asset status, categories, tags, regions, and many other asset attributes. Also includes pagination controls like limit, skip, and cursor.
Additional Body Fields Optional fields sent in the POST request body to further filter the assets by lists of entity IDs to include or exclude.

Output

JSON

  • tags - The main JSON response containing the fetched inventory tags and associated asset information.
  • count - If 'countOnly' is true, the total number of matching items.
  • cursor - Cursor string for pagination to fetch subsequent pages of results.

Dependencies

  • Requires an API key credential for authentication to the AvantGuard SentinelOne API.
  • Relies on the '@avantguardllc/n8n-openapi-node' package for OpenAPI integration.

Troubleshooting

  • If the API returns authentication errors, verify that the API key credential is correctly configured and has necessary permissions.
  • Large result sets may require use of 'cursor' and pagination parameters to retrieve all data.
  • Incorrect filter values or malformed JSON in query parameters may cause API errors; ensure JSON inputs are valid.
  • Setting 'countOnly' to true returns only the count, so no tag data will be present in the output.
  • The 'limit' parameter must be between 1 and 1000; values outside this range may cause errors.

Links

Discussion