Apache CloudStack 4.21.0.0 Root Admin API Reference

createGpuDevice

Creates a GPU device manually on a host

Request parameters

Parameter NameDescriptionRequired
busaddressPCI bus address of the GPU device (e.g., 0000:01:00.0) or UUID for MDEV devices.true
gpucardidID of the GPU card typetrue
hostidID of the host where the GPU device is locatedtrue
vgpuprofileidID of the vGPU profiletrue
numanodeNUMA node of the GPU device (e.g., 0, 1, etc.). This is optional and can be used to specify the NUMA node for the GPU device which is used during allocation. Defaults to -1false
parentgpudeviceidID of the parent GPU device (for virtual GPU devices)false
typeType of GPU device (PCI, MDEV, VGPUOnly). Defaults to PCI.false

Response Tags

Response NameDescription
idthe ID of the GPU device
busaddressbus address of the GPU device or MDEV UUID for vGPU devices
gpucardidthe GPU card ID associated with this GPU device
gpucardnamethe GPU card name associated with this GPU device
gpudevicetypebus address of the GPU device
hostidthe host ID where the GPU device is attached
hostnamethe host name where the GPU device is attached
managedstatethe managed state of the GPU device (Enabled/Disabled)
numanodethe NUMA node where the GPU device is located
parentgpudeviceidthe ID of the parent GPU device, if this is a vGPU
statethe vGPU profile name assigned to this GPU device
vgpuprofileidthe vGPU profile ID assigned to this GPU device
vgpuprofilenamethe vGPU profile name assigned to this GPU device
virtualmachineidthe vGPU profile ID assigned to this GPU device
virtualmachinenamethe vGPU profile name assigned to this GPU device
vmstatethe state of the virtual machine to which this GPU device is allocated