Get Instances By Status
get_instances_by_statusFilter OpenStack Nova instances by status to find servers in states like ACTIVE, ERROR, or SHUTOFF, with optional cross-project listing when policy allows.
Instructions
Get instances filtered by status.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"status": "<status>"
},
"name": "get_instances_by_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Nova server status to filter by, case-insensitive (ACTIVE, BUILD, DELETED, ERROR, HARD_REBOOT, MIGRATING, PASSWORD, PAUSED, REBOOT, REBUILD, RESCUE, RESIZE, REVERT_RESIZE, SHELVED, SHELVED_OFFLOADED, SHUTOFF, SOFT_DELETED, SUSPENDED, UNKNOWN, VERIFY_RESIZE) | |
| all_projects | No | If True, include every project the credential's OpenStack policy allows (like 'openstack server list --status --all-projects'). Requires ALLOW_CROSS_PROJECT_READ=true on the server; a disabled or denied request is reported as an error, never as current-project results. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |