Unraid icon

Unraid

Interact with the Unraid API — manage Docker containers, VMs, array health, disks, notifications, and system metrics

VM → Get Many

AI-generated

Summary

Lists all virtual machines on the Unraid server via its GraphQL API, returning one item per VM with its ID, name, UUID and state.

Inputs

  • maxControlLevel — Caps what this node may do (Use Credential Default, Read, Control, Full). It can only narrow the credential's limit, never raise it. Get Many is a read-only operation, so it runs at any level.

Output shape

One output item per VM, with fields id, name, uuid and state. Each item is paired with the input item that produced it.

The operation needs no VM ID and has no filter or pagination options. It runs once per input item, so multiple input items return the VM list multiple times. If the server has no VMs, no items are emitted for that input. With Continue On Fail enabled, an error is returned as an item with an 'error' message. The returned id (e.g. vm:abc123) is the value other VM operations take as VM ID.

Examples

Example 1: Find VM IDs before starting or stopping a specific VM

Resource: VM, Operation: Get Many. Feed the returned id into a later VM Start/Stop node.

Example 2: Report on VMs that are not running

Resource: VM, Operation: Get Many, then an IF or Filter node on state.

Example 3: Let an AI Agent inspect VMs without being able to change them

Resource: VM, Operation: Get Many, Maximum Control Level: Read.

Links

Discussion