search_devices
Search for managed devices in FortiManager using filters such as name, platform, OS version, or connection status to quickly locate specific devices.
Instructions
Search for devices with filters.
Args: adom: ADOM name (default: from DEFAULT_ADOM env var, or "root") name_filter: Filter by device name (partial match) platform_filter: Filter by platform type (e.g., "FortiGate-VM") os_version_filter: Filter by OS version (e.g., "7.4") connection_status: Filter by status ("up" or "down")
Returns: dict: Search results with keys: - status: "success" or "error" - count: Number of matching devices - devices: List of matching device objects - message: Error message if failed
Example: >>> # Find all FortiGate VMs >>> result = await search_devices(platform_filter="FortiGate-VM")
>>> # Find offline devices
>>> result = await search_devices(connection_status="down")
>>> # Find devices by name pattern
>>> result = await search_devices(name_filter="Branch")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adom | No | ||
| name_filter | No | ||
| platform_filter | No | ||
| os_version_filter | No | ||
| connection_status | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||