Connect Secure icon

Connect Secure

Consume Connect Secure API

Actions222

Overview

This node operation, Retrieve Ad Computers View, is designed to query and retrieve a list or view of computer objects from an Active Directory environment. It allows users to specify filtering conditions, pagination controls (skip and limit), and sorting order to customize the data retrieval.

Typical use cases include:

  • Fetching computer inventory details for asset management.
  • Filtering computers based on specific attributes or conditions.
  • Integrating Active Directory computer data into workflows for monitoring or reporting.

For example, a user might retrieve all computers with a certain operating system or within a particular organizational unit by specifying appropriate query conditions.

Properties

Name Meaning
X USER ID User identifier required for authentication or API access headers.
Condition Query condition string to filter the Active Directory computers returned.
Skip Number of records to skip, useful for pagination.
Limit Maximum number of records to return, controlling the size of the result set.
Order By Field(s) to sort the results by, defining the order in which computers are listed.

Output

The node outputs JSON data representing the retrieved Active Directory computers matching the specified query parameters. The structure typically includes an array of computer objects with their attributes as returned by the Active Directory API.

No binary data output is indicated for this operation.

Dependencies

  • Requires connection to an Active Directory API endpoint that supports querying computer objects.
  • Needs an API key or token credential configured in n8n for authentication (referred generically as "an API key credential").
  • The X USER ID header must be provided as part of the request headers for authorization or identification purposes.

Troubleshooting

  • Missing or invalid X USER ID: The API may reject requests without a valid user ID header. Ensure this property is correctly set.
  • Invalid query condition syntax: If the condition string is malformed, the API might return errors or no results. Validate the query format according to the Active Directory API documentation.
  • Pagination issues: Setting skip or limit incorrectly (e.g., negative numbers) could cause unexpected results or errors.
  • Order By field not recognized: Using unsupported fields in the order_by parameter may lead to errors or default ordering.
  • Authentication failures: Ensure the API key credential is valid and has sufficient permissions to query Active Directory.

Links and References

Discussion