Skip to main content

dtctl virtual-machine action

Usage​

dtctl virtual-machine action <action_name> [flags]

Aliases​

ac

Description​

Perform a power or lifecycle action on a virtual machine. The action name is a positional argument. Available actions: reboot, hard-reboot, start, stop, shelve, unshelve, rescue, unrescue, console-log, hard-stop, resize. The resize action requires --flavor-id, and the rescue action requires --image-id.

Example​

# Stop a VM, then resize it to a new flavor
dtctl virtual-machine action stop --vm-id <vm-id>
dtctl virtual-machine action resize --vm-id <vm-id> --flavor-id <flavor-id>

Flags​

OptionDescription
--file, -lWrite the log to this file instead of standard output. Only for the console-log action.
--flavor-id, -fNew flavor ID to resize to. Required for the resize action.
--image-id, -mImage ID to boot into. Required for the rescue action.
--vm-id, -iID of the virtual machine to perform action on (required)
CommandDescription
dtctl virtual-machine listList virtual machines
dtctl virtual-machine showShow a virtual machine
dtctl virtual-machine createCreate a virtual machine
dtctl virtual-machine update-nameRename a virtual machine
dtctl virtual-machine update-networkUpdate a network interface
dtctl virtual-machine deleteDelete a virtual machine
dtctl virtual-machine attach-networkAttach a network interface
dtctl virtual-machine attach-new-volumeCreate and attach a new volume
dtctl virtual-machine attach-volumeAttach an existing volume
dtctl virtual-machine consoleGet a VM's remote console URL
dtctl virtual-machine detach-networkDetach a network interface
dtctl virtual-machine detach-volumeDetach a volume
dtctl virtual-machine historyShow a VM's action history
dtctl virtual-machine history-detailsShow one history entry
dtctl virtual-machine hot-plugEnable or disable hot-plug
dtctl virtual-machine networksList a VM's network interfaces
dtctl virtual-machine volumesList a VM's attached volumes

Global Flags​

OptionDescription
--api-urlSend this command to a different API endpoint, e.g. a test environment (default "https://console.dt.net.tr/api/v1")
--config, -cSpecify a custom config file
Default: ~/.config/dtctl/config.yaml
--no-headersOmit the column headers, for scripting
Default: false
--output, -oOutput format: text, wide, vertical, json. text fits the terminal, wide never truncates, vertical prints one field per line
Default: text