dtctl virtual-machine list
Usage
dtctl virtual-machine list [flags]
Aliases
l
Description
Retrieve all virtual machines in the active project, optionally filtered by status or task state.
Example
# List all VMs, or only the active ones
dtctl virtual-machine list
dtctl virtual-machine list --status ACTIVE
Response
In text output (the default), this command returns the following columns: ID, Name, Status, IP Addresses, VCPUs, RAM, Storage, Volume Size, Task State.
Pass --output json to get the full response object instead.
Flags
| Option | Description |
|---|---|
--status, -s | Filter by status, e.g. ACTIVE, SHUTOFF, ERROR |
--task, -t | Filter by in-progress task state, e.g. spawning, deleting |
Related Commands
| Command | Description |
|---|---|
| dtctl virtual-machine show | Show a virtual machine |
| dtctl virtual-machine create | Create a virtual machine |
| dtctl virtual-machine update-name | Rename a virtual machine |
| dtctl virtual-machine update-network | Update a network interface |
| dtctl virtual-machine delete | Delete a virtual machine |
| dtctl virtual-machine action | Perform a power/lifecycle action |
| dtctl virtual-machine attach-network | Attach a network interface |
| dtctl virtual-machine attach-new-volume | Create and attach a new volume |
| dtctl virtual-machine attach-volume | Attach an existing volume |
| dtctl virtual-machine console | Get a VM's remote console URL |
| dtctl virtual-machine detach-network | Detach a network interface |
| dtctl virtual-machine detach-volume | Detach a volume |
| dtctl virtual-machine history | Show a VM's action history |
| dtctl virtual-machine history-details | Show one history entry |
| dtctl virtual-machine hot-plug | Enable or disable hot-plug |
| dtctl virtual-machine networks | List a VM's network interfaces |
| dtctl virtual-machine volumes | List a VM's attached volumes |
Global Flags
| Option | Description |
|---|---|
--api-url | Send this command to a different API endpoint, e.g. a test environment (default "https://console.dt.net.tr/api/v1") |
--config, -c | Specify a custom config file Default: ~/.config/dtctl/config.yaml |
--no-headers | Omit the column headers, for scripting Default: false |
--output, -o | Output format: text, wide, vertical, json. text fits the terminal, wide never truncates, vertical prints one field per line Default: text |