virt.instance.device_update =========================== Update a device in an instance. .. raw:: html
ID of the virtual instance to update device for.
Updated device configuration.
Optional human-readable name for the virtualization device.
Must be at least 1 characters long
Optional description explaining the purpose or configuration of this device.
Must be at least 1 characters long
Whether the device should be mounted in read-only mode.
Device type identifier for virtual disk devices.
Specific value:"DISK"
For CONTAINER instances, this would be a valid pool path. For VM instances, it can be a valid zvol path or an incus storage volume name.
Must be at least 1 characters long
Target path where the disk appears inside the virtualized instance.
Boot priority for this disk device. Lower numbers boot first. null means non-bootable.
Value must be greater or equal to 0
Storage bus type for optimal performance and compatibility.
Storage pool in which the device is located. This must be one of the storage pools listed in virt.global.config output.
If this is set to None during device creation, then the default storage pool defined in virt.global.config will be used.
Must be at least 1 characters long
Optional human-readable name for the virtualization device.
Must be at least 1 characters long
Optional description explaining the purpose or configuration of this device.
Must be at least 1 characters long
Whether the device should be mounted in read-only mode.
Device type identifier for graphics processing units.
Specific value:"GPU"
Type of GPU virtualization (physical passthrough, mediated device, etc.).
Unique identifier for the GPU device.
Group ID for device permissions inside the container.
Value must be greater or equal to 0 and lesser or equal to 90000000
User ID for device permissions inside the container.
Value must be greater or equal to 0 and lesser or equal to 90000000
Permission mode for device access (e.g., '660').
Mediated device identifier for GPU virtualization.
Must be at least 1 characters long
Multi-Instance GPU UUID for NVIDIA GPU partitioning.
Must be at least 1 characters long
PCI address of the GPU device on the host system.
Must be at least 1 characters long
Product identifier for GPU device matching.
Must be at least 1 characters long
Vendor identifier for GPU device matching.
Must be at least 1 characters long
Optional human-readable name for the virtualization device.
Must be at least 1 characters long
Optional description explaining the purpose or configuration of this device.
Must be at least 1 characters long
Whether the device should be mounted in read-only mode.
Device type identifier for network port forwarding.
Specific value:"PROXY"
Network protocol (TCP or UDP) for the source connection.
Source port number on the host system to forward from.
Value must be greater or equal to 1 and lesser or equal to 65535
Network protocol (TCP or UDP) for the destination connection.
Destination port number inside the virtualized instance.
Value must be greater or equal to 1 and lesser or equal to 65535
Optional human-readable name for the virtualization device.
Must be at least 1 characters long
Optional description explaining the purpose or configuration of this device.
Must be at least 1 characters long
Whether the device should be mounted in read-only mode.
Device type identifier for Trusted Platform Module devices.
Specific value:"TPM"
Path to the TPM device on the host system.
Resource manager path for TPM device access.
Optional human-readable name for the virtualization device.
Must be at least 1 characters long
Optional description explaining the purpose or configuration of this device.
Must be at least 1 characters long
Whether the device should be mounted in read-only mode.
Device type identifier for USB devices.
Specific value:"USB"
USB bus number on the host system.
USB device number on the specified bus.
USB product identifier for device matching.
USB vendor identifier for device matching.
Optional human-readable name for the virtualization device.
Must be at least 1 characters long
Optional description explaining the purpose or configuration of this device.
Must be at least 1 characters long
Whether the device should be mounted in read-only mode.
Device type identifier for network interface cards.
Specific value:"NIC"
Name of the network to connect this NIC to.
Must be at least 1 characters long
Type of network interface (bridged or macvlan).
Parent network interface on the host system.
Must be at least 1 characters long
MAC address for the virtual network interface. null for auto-generated.
Optional human-readable name for the virtualization device.
Must be at least 1 characters long
Optional description explaining the purpose or configuration of this device.
Must be at least 1 characters long
Whether the device should be mounted in read-only mode.
Device type identifier for PCI device passthrough.
Specific value:"PCI"
PCI bus address of the device to pass through to the virtualized instance.
Must be at least 1 characters long
Optional human-readable name for the virtualization device.
Must be at least 1 characters long
Optional description explaining the purpose or configuration of this device.
Must be at least 1 characters long
Whether the device should be mounted in read-only mode.
Device type identifier for CD-ROM/DVD optical drives.
Specific value:"CDROM"
Path to the ISO image file or physical optical drive to mount.
Must be at least 1 characters long
Boot priority for this optical device. Lower numbers boot first. null means non-bootable.
Value must be greater or equal to 0
Returns true when the device is successfully updated.
true