Extra Specs

The following is an overview of all extra specs recognized by nova in its default configuration.

Note

Other services and virt drivers may provide additional extra specs not listed here. In addition, it is possible to register your own extra specs. For more information on the latter, refer to Filter Scheduler.

Placement

The following extra specs are used during scheduling to modify the request sent to placement.

resources

The following extra specs are used to request an amount of the specified resource from placement when scheduling. All extra specs expect an integer value.

Note

Not all of the resource types listed below are supported by all virt drivers.

resources{group}:VCPU
Type

int

The amount of resource VCPU requested.

resources{group}:MEMORY_MB
Type

int

The amount of resource MEMORY_MB requested.

resources{group}:DISK_GB
Type

int

The amount of resource DISK_GB requested.

resources{group}:PCI_DEVICE
Type

int

The amount of resource PCI_DEVICE requested.

resources{group}:SRIOV_NET_VF
Type

int

The amount of resource SRIOV_NET_VF requested.

resources{group}:NUMA_SOCKET
Type

int

The amount of resource NUMA_SOCKET requested.

resources{group}:NUMA_CORE
Type

int

The amount of resource NUMA_CORE requested.

resources{group}:NUMA_THREAD
Type

int

The amount of resource NUMA_THREAD requested.

resources{group}:NUMA_MEMORY_MB
Type

int

The amount of resource NUMA_MEMORY_MB requested.

resources{group}:IPV4_ADDRESS
Type

int

The amount of resource IPV4_ADDRESS requested.

resources{group}:VGPU
Type

int

The amount of resource VGPU requested.

resources{group}:VGPU_DISPLAY_HEAD
Type

int

The amount of resource VGPU_DISPLAY_HEAD requested.

resources{group}:NET_BW_EGR_KILOBIT_PER_SEC
Type

int

The amount of resource NET_BW_EGR_KILOBIT_PER_SEC requested.

resources{group}:NET_BW_IGR_KILOBIT_PER_SEC
Type

int

The amount of resource NET_BW_IGR_KILOBIT_PER_SEC requested.

resources{group}:PCPU
Type

int

The amount of resource PCPU requested.

resources{group}:MEM_ENCRYPTION_CONTEXT
Type

int

The amount of resource MEM_ENCRYPTION_CONTEXT requested.

resources{group}:FPGA
Type

int

The amount of resource FPGA requested.

resources{group}:PGPU
Type

int

The amount of resource PGPU requested.

resources{group}:NET_PACKET_RATE_KILOPACKET_PER_SEC
Type

int

The amount of resource NET_PACKET_RATE_KILOPACKET_PER_SEC requested.

resources{group}:NET_PACKET_RATE_EGR_KILOPACKET_PER_SEC
Type

int

The amount of resource NET_PACKET_RATE_EGR_KILOPACKET_PER_SEC requested.

resources{group}:NET_PACKET_RATE_IGR_KILOPACKET_PER_SEC
Type

int

The amount of resource NET_PACKET_RATE_IGR_KILOPACKET_PER_SEC requested.

resources{group}:CUSTOM_{resource}
Type

int

The amount of resource CUSTOM_{resource} requested.

trait

The following extra specs are used to request a specified trait from placement when scheduling. All extra specs expect one of the following values:

  • required

  • forbidden

Note

Not all of the traits listed below are supported by all virt drivers.

trait{group}:COMPUTE_DEVICE_TAGGING
Type

str

Require or forbid trait COMPUTE_DEVICE_TAGGING.

trait{group}:COMPUTE_NODE
Type

str

Require or forbid trait COMPUTE_NODE.

trait{group}:COMPUTE_TRUSTED_CERTS
Type

str

Require or forbid trait COMPUTE_TRUSTED_CERTS.

trait{group}:COMPUTE_SAME_HOST_COLD_MIGRATE
Type

str

Require or forbid trait COMPUTE_SAME_HOST_COLD_MIGRATE.

trait{group}:COMPUTE_RESCUE_BFV
Type

str

Require or forbid trait COMPUTE_RESCUE_BFV.

trait{group}:COMPUTE_ACCELERATORS
Type

str

Require or forbid trait COMPUTE_ACCELERATORS.

trait{group}:COMPUTE_SOCKET_PCI_NUMA_AFFINITY
Type

str

Require or forbid trait COMPUTE_SOCKET_PCI_NUMA_AFFINITY.

trait{group}:COMPUTE_EPHEMERAL_ENCRYPTION
Type

str

Require or forbid trait COMPUTE_EPHEMERAL_ENCRYPTION.

trait{group}:COMPUTE_EPHEMERAL_ENCRYPTION_PLAIN
Type

str

Require or forbid trait COMPUTE_EPHEMERAL_ENCRYPTION_PLAIN.

trait{group}:COMPUTE_EPHEMERAL_ENCRYPTION_LUKS
Type

str

Require or forbid trait COMPUTE_EPHEMERAL_ENCRYPTION_LUKS.

trait{group}:COMPUTE_EPHEMERAL_ENCRYPTION_LUKSV2
Type

str

Require or forbid trait COMPUTE_EPHEMERAL_ENCRYPTION_LUKSV2.

trait{group}:COMPUTE_GRAPHICS_MODEL_CIRRUS
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_CIRRUS.

trait{group}:COMPUTE_GRAPHICS_MODEL_GOP
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_GOP.

trait{group}:COMPUTE_GRAPHICS_MODEL_NONE
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_NONE.

trait{group}:COMPUTE_GRAPHICS_MODEL_QXL
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_QXL.

trait{group}:COMPUTE_GRAPHICS_MODEL_VGA
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_VGA.

trait{group}:COMPUTE_GRAPHICS_MODEL_VIRTIO
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_VIRTIO.

trait{group}:COMPUTE_GRAPHICS_MODEL_VMVGA
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_VMVGA.

trait{group}:COMPUTE_GRAPHICS_MODEL_XEN
Type

str

Require or forbid trait COMPUTE_GRAPHICS_MODEL_XEN.

trait{group}:COMPUTE_IMAGE_TYPE_AKI
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_AKI.

trait{group}:COMPUTE_IMAGE_TYPE_AMI
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_AMI.

trait{group}:COMPUTE_IMAGE_TYPE_ARI
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_ARI.

trait{group}:COMPUTE_IMAGE_TYPE_ISO
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_ISO.

trait{group}:COMPUTE_IMAGE_TYPE_QCOW2
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_QCOW2.

trait{group}:COMPUTE_IMAGE_TYPE_RAW
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_RAW.

trait{group}:COMPUTE_IMAGE_TYPE_VDI
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_VDI.

trait{group}:COMPUTE_IMAGE_TYPE_VHD
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_VHD.

trait{group}:COMPUTE_IMAGE_TYPE_VHDX
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_VHDX.

trait{group}:COMPUTE_IMAGE_TYPE_VMDK
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_VMDK.

trait{group}:COMPUTE_IMAGE_TYPE_PLOOP
Type

str

Require or forbid trait COMPUTE_IMAGE_TYPE_PLOOP.

trait{group}:COMPUTE_MIGRATE_AUTO_CONVERGE
Type

str

Require or forbid trait COMPUTE_MIGRATE_AUTO_CONVERGE.

trait{group}:COMPUTE_MIGRATE_POST_COPY
Type

str

Require or forbid trait COMPUTE_MIGRATE_POST_COPY.

trait{group}:COMPUTE_NET_ATTACH_INTERFACE
Type

str

Require or forbid trait COMPUTE_NET_ATTACH_INTERFACE.

trait{group}:COMPUTE_NET_ATTACH_INTERFACE_WITH_TAG
Type

str

Require or forbid trait COMPUTE_NET_ATTACH_INTERFACE_WITH_TAG.

trait{group}:COMPUTE_NET_VIF_MODEL_E1000
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_E1000.

trait{group}:COMPUTE_NET_VIF_MODEL_E1000E
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_E1000E.

trait{group}:COMPUTE_NET_VIF_MODEL_LAN9118
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_LAN9118.

trait{group}:COMPUTE_NET_VIF_MODEL_NETFRONT
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_NETFRONT.

trait{group}:COMPUTE_NET_VIF_MODEL_NE2K_PCI
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_NE2K_PCI.

trait{group}:COMPUTE_NET_VIF_MODEL_PCNET
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_PCNET.

trait{group}:COMPUTE_NET_VIF_MODEL_RTL8139
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_RTL8139.

trait{group}:COMPUTE_NET_VIF_MODEL_SPAPR_VLAN
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_SPAPR_VLAN.

trait{group}:COMPUTE_NET_VIF_MODEL_SRIOV
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_SRIOV.

trait{group}:COMPUTE_NET_VIF_MODEL_VIRTIO
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_VIRTIO.

trait{group}:COMPUTE_NET_VIF_MODEL_VMXNET
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_VMXNET.

trait{group}:COMPUTE_NET_VIF_MODEL_VMXNET3
Type

str

Require or forbid trait COMPUTE_NET_VIF_MODEL_VMXNET3.

trait{group}:COMPUTE_SECURITY_TPM_1_2
Type

str

Require or forbid trait COMPUTE_SECURITY_TPM_1_2.

trait{group}:COMPUTE_SECURITY_TPM_2_0
Type

str

Require or forbid trait COMPUTE_SECURITY_TPM_2_0.

trait{group}:COMPUTE_SECURITY_UEFI_SECURE_BOOT
Type

str

Require or forbid trait COMPUTE_SECURITY_UEFI_SECURE_BOOT.

trait{group}:COMPUTE_STATUS_DISABLED
Type

str

Require or forbid trait COMPUTE_STATUS_DISABLED.

trait{group}:COMPUTE_STORAGE_BUS_FDC
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_FDC.

trait{group}:COMPUTE_STORAGE_BUS_IDE
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_IDE.

trait{group}:COMPUTE_STORAGE_BUS_LXC
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_LXC.

trait{group}:COMPUTE_STORAGE_BUS_SATA
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_SATA.

trait{group}:COMPUTE_STORAGE_BUS_SCSI
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_SCSI.

trait{group}:COMPUTE_STORAGE_BUS_USB
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_USB.

trait{group}:COMPUTE_STORAGE_BUS_VIRTIO
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_VIRTIO.

trait{group}:COMPUTE_STORAGE_BUS_UML
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_UML.

trait{group}:COMPUTE_STORAGE_BUS_XEN
Type

str

Require or forbid trait COMPUTE_STORAGE_BUS_XEN.

trait{group}:COMPUTE_VOLUME_ATTACH
Type

str

Require or forbid trait COMPUTE_VOLUME_ATTACH.

trait{group}:COMPUTE_VOLUME_ATTACH_WITH_TAG
Type

str

Require or forbid trait COMPUTE_VOLUME_ATTACH_WITH_TAG.

trait{group}:COMPUTE_VOLUME_EXTEND
Type

str

Require or forbid trait COMPUTE_VOLUME_EXTEND.

trait{group}:COMPUTE_VOLUME_MULTI_ATTACH
Type

str

Require or forbid trait COMPUTE_VOLUME_MULTI_ATTACH.

trait{group}:HW_CPU_HYPERTHREADING
Type

str

Require or forbid trait HW_CPU_HYPERTHREADING.

trait{group}:HW_CPU_AARCH64_FP
Type

str

Require or forbid trait HW_CPU_AARCH64_FP.

trait{group}:HW_CPU_AARCH64_ASIMD
Type

str

Require or forbid trait HW_CPU_AARCH64_ASIMD.

trait{group}:HW_CPU_AARCH64_EVTSTRM
Type

str

Require or forbid trait HW_CPU_AARCH64_EVTSTRM.

trait{group}:HW_CPU_AARCH64_AES
Type

str

Require or forbid trait HW_CPU_AARCH64_AES.

trait{group}:HW_CPU_AARCH64_PMULL
Type

str

Require or forbid trait HW_CPU_AARCH64_PMULL.

trait{group}:HW_CPU_AARCH64_SHA1
Type

str

Require or forbid trait HW_CPU_AARCH64_SHA1.

trait{group}:HW_CPU_AARCH64_SHA2
Type

str

Require or forbid trait HW_CPU_AARCH64_SHA2.

trait{group}:HW_CPU_AARCH64_CRC32
Type

str

Require or forbid trait HW_CPU_AARCH64_CRC32.

trait{group}:HW_CPU_AARCH64_FPHP
Type

str

Require or forbid trait HW_CPU_AARCH64_FPHP.

trait{group}:HW_CPU_AARCH64_ASIMDHP
Type

str

Require or forbid trait HW_CPU_AARCH64_ASIMDHP.

trait{group}:HW_CPU_AARCH64_ASIMDRDM
Type

str

Require or forbid trait HW_CPU_AARCH64_ASIMDRDM.

trait{group}:HW_CPU_AARCH64_ATOMICS
Type

str

Require or forbid trait HW_CPU_AARCH64_ATOMICS.

trait{group}:HW_CPU_AARCH64_JSCVT
Type

str

Require or forbid trait HW_CPU_AARCH64_JSCVT.

trait{group}:HW_CPU_AARCH64_FCMA
Type

str

Require or forbid trait HW_CPU_AARCH64_FCMA.

trait{group}:HW_CPU_AARCH64_LRCPC
Type

str

Require or forbid trait HW_CPU_AARCH64_LRCPC.

trait{group}:HW_CPU_AARCH64_DCPOP
Type

str

Require or forbid trait HW_CPU_AARCH64_DCPOP.

trait{group}:HW_CPU_AARCH64_SHA3
Type

str

Require or forbid trait HW_CPU_AARCH64_SHA3.

trait{group}:HW_CPU_AARCH64_SM3
Type

str

Require or forbid trait HW_CPU_AARCH64_SM3.

trait{group}:HW_CPU_AARCH64_SM4
Type

str

Require or forbid trait HW_CPU_AARCH64_SM4.

trait{group}:HW_CPU_AARCH64_ASIMDDP
Type

str

Require or forbid trait HW_CPU_AARCH64_ASIMDDP.

trait{group}:HW_CPU_AARCH64_SHA512
Type

str

Require or forbid trait HW_CPU_AARCH64_SHA512.

trait{group}:HW_CPU_AARCH64_SVE
Type

str

Require or forbid trait HW_CPU_AARCH64_SVE.

trait{group}:HW_CPU_AARCH64_CPUID
Type

str

Require or forbid trait HW_CPU_AARCH64_CPUID.

trait{group}:HW_CPU_AMD_SEV
Type

str

Require or forbid trait HW_CPU_AMD_SEV.

trait{group}:HW_CPU_PPC64LE_POWER8
Type

str

Require or forbid trait HW_CPU_PPC64LE_POWER8.

trait{group}:HW_CPU_PPC64LE_POWER9
Type

str

Require or forbid trait HW_CPU_PPC64LE_POWER9.

trait{group}:HW_CPU_X86_AVX
Type

str

Require or forbid trait HW_CPU_X86_AVX.

trait{group}:HW_CPU_X86_AVX2
Type

str

Require or forbid trait HW_CPU_X86_AVX2.

trait{group}:HW_CPU_X86_CLMUL
Type

str

Require or forbid trait HW_CPU_X86_CLMUL.

trait{group}:HW_CPU_X86_FMA3
Type

str

Require or forbid trait HW_CPU_X86_FMA3.

trait{group}:HW_CPU_X86_FMA4
Type

str

Require or forbid trait HW_CPU_X86_FMA4.

trait{group}:HW_CPU_X86_F16C
Type

str

Require or forbid trait HW_CPU_X86_F16C.

trait{group}:HW_CPU_X86_MMX
Type

str

Require or forbid trait HW_CPU_X86_MMX.

trait{group}:HW_CPU_X86_SSE
Type

str

Require or forbid trait HW_CPU_X86_SSE.

trait{group}:HW_CPU_X86_SSE2
Type

str

Require or forbid trait HW_CPU_X86_SSE2.

trait{group}:HW_CPU_X86_SSE3
Type

str

Require or forbid trait HW_CPU_X86_SSE3.

trait{group}:HW_CPU_X86_SSSE3
Type

str

Require or forbid trait HW_CPU_X86_SSSE3.

trait{group}:HW_CPU_X86_SSE41
Type

str

Require or forbid trait HW_CPU_X86_SSE41.

trait{group}:HW_CPU_X86_SSE42
Type

str

Require or forbid trait HW_CPU_X86_SSE42.

trait{group}:HW_CPU_X86_SSE4A
Type

str

Require or forbid trait HW_CPU_X86_SSE4A.

trait{group}:HW_CPU_X86_XOP
Type

str

Require or forbid trait HW_CPU_X86_XOP.

trait{group}:HW_CPU_X86_3DNOW
Type

str

Require or forbid trait HW_CPU_X86_3DNOW.

trait{group}:HW_CPU_X86_AVX512F
Type

str

Require or forbid trait HW_CPU_X86_AVX512F.

trait{group}:HW_CPU_X86_AVX512CD
Type

str

Require or forbid trait HW_CPU_X86_AVX512CD.

trait{group}:HW_CPU_X86_AVX512PF
Type

str

Require or forbid trait HW_CPU_X86_AVX512PF.

trait{group}:HW_CPU_X86_AVX512ER
Type

str

Require or forbid trait HW_CPU_X86_AVX512ER.

trait{group}:HW_CPU_X86_AVX512VL
Type

str

Require or forbid trait HW_CPU_X86_AVX512VL.

trait{group}:HW_CPU_X86_AVX512BW
Type

str

Require or forbid trait HW_CPU_X86_AVX512BW.

trait{group}:HW_CPU_X86_AVX512DQ
Type

str

Require or forbid trait HW_CPU_X86_AVX512DQ.

trait{group}:HW_CPU_X86_AVX512VNNI
Type

str

Require or forbid trait HW_CPU_X86_AVX512VNNI.

trait{group}:HW_CPU_X86_AVX512VBMI
Type

str

Require or forbid trait HW_CPU_X86_AVX512VBMI.

trait{group}:HW_CPU_X86_AVX512IFMA
Type

str

Require or forbid trait HW_CPU_X86_AVX512IFMA.

trait{group}:HW_CPU_X86_AVX512VBMI2
Type

str

Require or forbid trait HW_CPU_X86_AVX512VBMI2.

trait{group}:HW_CPU_X86_AVX512BITALG
Type

str

Require or forbid trait HW_CPU_X86_AVX512BITALG.

trait{group}:HW_CPU_X86_AVX512VAES
Type

str

Require or forbid trait HW_CPU_X86_AVX512VAES.

trait{group}:HW_CPU_X86_AVX512GFNI
Type

str

Require or forbid trait HW_CPU_X86_AVX512GFNI.

trait{group}:HW_CPU_X86_AVX512VPCLMULQDQ
Type

str

Require or forbid trait HW_CPU_X86_AVX512VPCLMULQDQ.

trait{group}:HW_CPU_X86_AVX512VPOPCNTDQ
Type

str

Require or forbid trait HW_CPU_X86_AVX512VPOPCNTDQ.

trait{group}:HW_CPU_X86_ABM
Type

str

Require or forbid trait HW_CPU_X86_ABM.

trait{group}:HW_CPU_X86_BMI
Type

str

Require or forbid trait HW_CPU_X86_BMI.

trait{group}:HW_CPU_X86_BMI2
Type

str

Require or forbid trait HW_CPU_X86_BMI2.

trait{group}:HW_CPU_X86_TBM
Type

str

Require or forbid trait HW_CPU_X86_TBM.

trait{group}:HW_CPU_X86_AESNI
Type

str

Require or forbid trait HW_CPU_X86_AESNI.

trait{group}:HW_CPU_X86_SHA
Type

str

Require or forbid trait HW_CPU_X86_SHA.

trait{group}:HW_CPU_X86_MPX
Type

str

Require or forbid trait HW_CPU_X86_MPX.

trait{group}:HW_CPU_X86_SGX
Type

str

Require or forbid trait HW_CPU_X86_SGX.

trait{group}:HW_CPU_X86_TSX
Type

str

Require or forbid trait HW_CPU_X86_TSX.

trait{group}:HW_CPU_X86_ASF
Type

str

Require or forbid trait HW_CPU_X86_ASF.

trait{group}:HW_CPU_X86_VMX
Type

str

Require or forbid trait HW_CPU_X86_VMX.

trait{group}:HW_CPU_X86_SVM
Type

str

Require or forbid trait HW_CPU_X86_SVM.

trait{group}:HW_CPU_X86_PDPE1GB
Type

str

Require or forbid trait HW_CPU_X86_PDPE1GB.

trait{group}:HW_CPU_X86_STIBP
Type

str

Require or forbid trait HW_CPU_X86_STIBP.

trait{group}:HW_CPU_X86_AMD_SEV
Type

str

Require or forbid trait HW_CPU_X86_AMD_SEV.

trait{group}:HW_CPU_X86_AMD_SVM
Type

str

Require or forbid trait HW_CPU_X86_AMD_SVM.

trait{group}:HW_CPU_X86_AMD_IBPB
Type

str

Require or forbid trait HW_CPU_X86_AMD_IBPB.

trait{group}:HW_CPU_X86_AMD_NO_SSB
Type

str

Require or forbid trait HW_CPU_X86_AMD_NO_SSB.

trait{group}:HW_CPU_X86_AMD_SSBD
Type

str

Require or forbid trait HW_CPU_X86_AMD_SSBD.

trait{group}:HW_CPU_X86_AMD_VIRT_SSBD
Type

str

Require or forbid trait HW_CPU_X86_AMD_VIRT_SSBD.

trait{group}:HW_CPU_X86_INTEL_MD_CLEAR
Type

str

Require or forbid trait HW_CPU_X86_INTEL_MD_CLEAR.

trait{group}:HW_CPU_X86_INTEL_PCID
Type

str

Require or forbid trait HW_CPU_X86_INTEL_PCID.

trait{group}:HW_CPU_X86_INTEL_SPEC_CTRL
Type

str

Require or forbid trait HW_CPU_X86_INTEL_SPEC_CTRL.

trait{group}:HW_CPU_X86_INTEL_SSBD
Type

str

Require or forbid trait HW_CPU_X86_INTEL_SSBD.

trait{group}:HW_CPU_X86_INTEL_VMX
Type

str

Require or forbid trait HW_CPU_X86_INTEL_VMX.

trait{group}:HW_GPU_API_DIRECTX_V10
Type

str

Require or forbid trait HW_GPU_API_DIRECTX_V10.

trait{group}:HW_GPU_API_DIRECTX_V11
Type

str

Require or forbid trait HW_GPU_API_DIRECTX_V11.

trait{group}:HW_GPU_API_DIRECTX_V12
Type

str

Require or forbid trait HW_GPU_API_DIRECTX_V12.

trait{group}:HW_GPU_API_DIRECT2D
Type

str

Require or forbid trait HW_GPU_API_DIRECT2D.

trait{group}:HW_GPU_API_DIRECT3D_V6_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V6_0.

trait{group}:HW_GPU_API_DIRECT3D_V7_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V7_0.

trait{group}:HW_GPU_API_DIRECT3D_V8_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V8_0.

trait{group}:HW_GPU_API_DIRECT3D_V8_1
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V8_1.

trait{group}:HW_GPU_API_DIRECT3D_V9_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V9_0.

trait{group}:HW_GPU_API_DIRECT3D_V9_0B
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V9_0B.

trait{group}:HW_GPU_API_DIRECT3D_V9_0C
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V9_0C.

trait{group}:HW_GPU_API_DIRECT3D_V9_0L
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V9_0L.

trait{group}:HW_GPU_API_DIRECT3D_V10_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V10_0.

trait{group}:HW_GPU_API_DIRECT3D_V10_1
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V10_1.

trait{group}:HW_GPU_API_DIRECT3D_V11_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V11_0.

trait{group}:HW_GPU_API_DIRECT3D_V11_1
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V11_1.

trait{group}:HW_GPU_API_DIRECT3D_V11_2
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V11_2.

trait{group}:HW_GPU_API_DIRECT3D_V11_3
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V11_3.

trait{group}:HW_GPU_API_DIRECT3D_V12_0
Type

str

Require or forbid trait HW_GPU_API_DIRECT3D_V12_0.

trait{group}:HW_GPU_API_VULKAN
Type

str

Require or forbid trait HW_GPU_API_VULKAN.

trait{group}:HW_GPU_API_DXVA
Type

str

Require or forbid trait HW_GPU_API_DXVA.

trait{group}:HW_GPU_API_OPENCL_V1_0
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V1_0.

trait{group}:HW_GPU_API_OPENCL_V1_1
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V1_1.

trait{group}:HW_GPU_API_OPENCL_V1_2
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V1_2.

trait{group}:HW_GPU_API_OPENCL_V2_0
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V2_0.

trait{group}:HW_GPU_API_OPENCL_V2_1
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V2_1.

trait{group}:HW_GPU_API_OPENCL_V2_2
Type

str

Require or forbid trait HW_GPU_API_OPENCL_V2_2.

trait{group}:HW_GPU_API_OPENGL_V1_1
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V1_1.

trait{group}:HW_GPU_API_OPENGL_V1_2
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V1_2.

trait{group}:HW_GPU_API_OPENGL_V1_3
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V1_3.

trait{group}:HW_GPU_API_OPENGL_V1_4
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V1_4.

trait{group}:HW_GPU_API_OPENGL_V1_5
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V1_5.

trait{group}:HW_GPU_API_OPENGL_V2_0
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V2_0.

trait{group}:HW_GPU_API_OPENGL_V2_1
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V2_1.

trait{group}:HW_GPU_API_OPENGL_V3_0
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V3_0.

trait{group}:HW_GPU_API_OPENGL_V3_1
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V3_1.

trait{group}:HW_GPU_API_OPENGL_V3_2
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V3_2.

trait{group}:HW_GPU_API_OPENGL_V3_3
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V3_3.

trait{group}:HW_GPU_API_OPENGL_V4_0
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_0.

trait{group}:HW_GPU_API_OPENGL_V4_1
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_1.

trait{group}:HW_GPU_API_OPENGL_V4_2
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_2.

trait{group}:HW_GPU_API_OPENGL_V4_3
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_3.

trait{group}:HW_GPU_API_OPENGL_V4_4
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_4.

trait{group}:HW_GPU_API_OPENGL_V4_5
Type

str

Require or forbid trait HW_GPU_API_OPENGL_V4_5.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_1
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_1.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_2
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_2.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_3
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_3.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_1
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_1.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_2
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_2.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_5
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_5.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_7
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_7.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_2
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_2.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_3
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_3.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_1
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_1.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_2
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_2.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_0
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_0.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_1
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_1.

trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_2
Type

str

Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_2.

trait{group}:HW_GPU_CUDA_SDK_V6_5
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V6_5.

trait{group}:HW_GPU_CUDA_SDK_V7_5
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V7_5.

trait{group}:HW_GPU_CUDA_SDK_V8_0
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V8_0.

trait{group}:HW_GPU_CUDA_SDK_V9_0
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V9_0.

trait{group}:HW_GPU_CUDA_SDK_V9_1
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V9_1.

trait{group}:HW_GPU_CUDA_SDK_V9_2
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V9_2.

trait{group}:HW_GPU_CUDA_SDK_V10_0
Type

str

Require or forbid trait HW_GPU_CUDA_SDK_V10_0.

trait{group}:HW_GPU_MAX_DISPLAY_HEADS_1
Type

str

Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_1.

trait{group}:HW_GPU_MAX_DISPLAY_HEADS_2
Type

str

Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_2.

trait{group}:HW_GPU_MAX_DISPLAY_HEADS_4
Type

str

Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_4.

trait{group}:HW_GPU_MAX_DISPLAY_HEADS_6
Type

str

Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_6.

trait{group}:HW_GPU_MAX_DISPLAY_HEADS_8
Type

str

Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_8.

trait{group}:HW_GPU_RESOLUTION_W320H240
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W320H240.

trait{group}:HW_GPU_RESOLUTION_W640H480
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W640H480.

trait{group}:HW_GPU_RESOLUTION_W800H600
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W800H600.

trait{group}:HW_GPU_RESOLUTION_W1024H600
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1024H600.

trait{group}:HW_GPU_RESOLUTION_W1024H768
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1024H768.

trait{group}:HW_GPU_RESOLUTION_W1152H864
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1152H864.

trait{group}:HW_GPU_RESOLUTION_W1280H720
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1280H720.

trait{group}:HW_GPU_RESOLUTION_W1280H768
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1280H768.

trait{group}:HW_GPU_RESOLUTION_W1280H800
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1280H800.

trait{group}:HW_GPU_RESOLUTION_W1280H1024
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1280H1024.

trait{group}:HW_GPU_RESOLUTION_W1360H768
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1360H768.

trait{group}:HW_GPU_RESOLUTION_W1366H768
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1366H768.

trait{group}:HW_GPU_RESOLUTION_W1440H900
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1440H900.

trait{group}:HW_GPU_RESOLUTION_W1600H900
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1600H900.

trait{group}:HW_GPU_RESOLUTION_W1600H1200
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1600H1200.

trait{group}:HW_GPU_RESOLUTION_W1680H1050
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1680H1050.

trait{group}:HW_GPU_RESOLUTION_W1920H1080
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1920H1080.

trait{group}:HW_GPU_RESOLUTION_W1920H1200
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W1920H1200.

trait{group}:HW_GPU_RESOLUTION_W2560H1440
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W2560H1440.

trait{group}:HW_GPU_RESOLUTION_W2560H1600
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W2560H1600.

trait{group}:HW_GPU_RESOLUTION_W3840H2160
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W3840H2160.

trait{group}:HW_GPU_RESOLUTION_W7680H4320
Type

str

Require or forbid trait HW_GPU_RESOLUTION_W7680H4320.

trait{group}:HW_NIC_SRIOV
Type

str

Require or forbid trait HW_NIC_SRIOV.

trait{group}:HW_NIC_MULTIQUEUE
Type

str

Require or forbid trait HW_NIC_MULTIQUEUE.

trait{group}:HW_NIC_VMDQ
Type

str

Require or forbid trait HW_NIC_VMDQ.

trait{group}:HW_NIC_PROGRAMMABLE_PIPELINE
Type

str

Require or forbid trait HW_NIC_PROGRAMMABLE_PIPELINE.

trait{group}:HW_NIC_ACCEL_SSL
Type

str

Require or forbid trait HW_NIC_ACCEL_SSL.

trait{group}:HW_NIC_ACCEL_IPSEC
Type

str

Require or forbid trait HW_NIC_ACCEL_IPSEC.

trait{group}:HW_NIC_ACCEL_TLS
Type

str

Require or forbid trait HW_NIC_ACCEL_TLS.

trait{group}:HW_NIC_ACCEL_DIFFIEH
Type

str

Require or forbid trait HW_NIC_ACCEL_DIFFIEH.

trait{group}:HW_NIC_ACCEL_RSA
Type

str

Require or forbid trait HW_NIC_ACCEL_RSA.

trait{group}:HW_NIC_ACCEL_ECC
Type

str

Require or forbid trait HW_NIC_ACCEL_ECC.

trait{group}:HW_NIC_ACCEL_LZS
Type

str

Require or forbid trait HW_NIC_ACCEL_LZS.

trait{group}:HW_NIC_ACCEL_DEFLATE
Type

str

Require or forbid trait HW_NIC_ACCEL_DEFLATE.

trait{group}:HW_NIC_DCB_PFC
Type

str

Require or forbid trait HW_NIC_DCB_PFC.

trait{group}:HW_NIC_DCB_ETS
Type

str

Require or forbid trait HW_NIC_DCB_ETS.

trait{group}:HW_NIC_DCB_QCN
Type

str

Require or forbid trait HW_NIC_DCB_QCN.

trait{group}:HW_NIC_OFFLOAD_TSO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_TSO.

trait{group}:HW_NIC_OFFLOAD_GRO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_GRO.

trait{group}:HW_NIC_OFFLOAD_GSO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_GSO.

trait{group}:HW_NIC_OFFLOAD_UFO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_UFO.

trait{group}:HW_NIC_OFFLOAD_LRO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_LRO.

trait{group}:HW_NIC_OFFLOAD_LSO
Type

str

Require or forbid trait HW_NIC_OFFLOAD_LSO.

trait{group}:HW_NIC_OFFLOAD_TCS
Type

str

Require or forbid trait HW_NIC_OFFLOAD_TCS.

trait{group}:HW_NIC_OFFLOAD_UCS
Type

str

Require or forbid trait HW_NIC_OFFLOAD_UCS.

trait{group}:HW_NIC_OFFLOAD_SCS
Type

str

Require or forbid trait HW_NIC_OFFLOAD_SCS.

trait{group}:HW_NIC_OFFLOAD_L2CRC
Type

str

Require or forbid trait HW_NIC_OFFLOAD_L2CRC.

trait{group}:HW_NIC_OFFLOAD_FDF
Type

str

Require or forbid trait HW_NIC_OFFLOAD_FDF.

trait{group}:HW_NIC_OFFLOAD_RXVLAN
Type

str

Require or forbid trait HW_NIC_OFFLOAD_RXVLAN.

trait{group}:HW_NIC_OFFLOAD_TXVLAN
Type

str

Require or forbid trait HW_NIC_OFFLOAD_TXVLAN.

trait{group}:HW_NIC_OFFLOAD_VXLAN
Type

str

Require or forbid trait HW_NIC_OFFLOAD_VXLAN.

trait{group}:HW_NIC_OFFLOAD_GRE
Type

str

Require or forbid trait HW_NIC_OFFLOAD_GRE.

trait{group}:HW_NIC_OFFLOAD_GENEVE
Type

str

Require or forbid trait HW_NIC_OFFLOAD_GENEVE.

trait{group}:HW_NIC_OFFLOAD_TXUDP
Type

str

Require or forbid trait HW_NIC_OFFLOAD_TXUDP.

trait{group}:HW_NIC_OFFLOAD_QINQ
Type

str

Require or forbid trait HW_NIC_OFFLOAD_QINQ.

trait{group}:HW_NIC_OFFLOAD_RDMA
Type

str

Require or forbid trait HW_NIC_OFFLOAD_RDMA.

trait{group}:HW_NIC_OFFLOAD_RXHASH
Type

str

Require or forbid trait HW_NIC_OFFLOAD_RXHASH.

trait{group}:HW_NIC_OFFLOAD_RX
Type

str

Require or forbid trait HW_NIC_OFFLOAD_RX.

trait{group}:HW_NIC_OFFLOAD_TX
Type

str

Require or forbid trait HW_NIC_OFFLOAD_TX.

trait{group}:HW_NIC_OFFLOAD_SG
Type

str

Require or forbid trait HW_NIC_OFFLOAD_SG.

trait{group}:HW_NIC_OFFLOAD_SWITCHDEV
Type

str

Require or forbid trait HW_NIC_OFFLOAD_SWITCHDEV.

trait{group}:HW_NIC_SRIOV_QOS_TX
Type

str

Require or forbid trait HW_NIC_SRIOV_QOS_TX.

trait{group}:HW_NIC_SRIOV_QOS_RX
Type

str

Require or forbid trait HW_NIC_SRIOV_QOS_RX.

trait{group}:HW_NIC_SRIOV_MULTIQUEUE
Type

str

Require or forbid trait HW_NIC_SRIOV_MULTIQUEUE.

trait{group}:HW_NIC_SRIOV_TRUSTED
Type

str

Require or forbid trait HW_NIC_SRIOV_TRUSTED.

trait{group}:HW_NUMA_ROOT
Type

str

Require or forbid trait HW_NUMA_ROOT.

trait{group}:MISC_SHARES_VIA_AGGREGATE
Type

str

Require or forbid trait MISC_SHARES_VIA_AGGREGATE.

trait{group}:STORAGE_DISK_HDD
Type

str

Require or forbid trait STORAGE_DISK_HDD.

trait{group}:STORAGE_DISK_SSD
Type

str

Require or forbid trait STORAGE_DISK_SSD.

trait{group}:CUSTOM_{trait}
Type

str

Require or forbid trait CUSTOM_{trait}.

Scheduler Filters

The following extra specs are specific to various in-tree scheduler filters.

aggregate_instance_extra_specs

The following extra specs are used to specify metadata that must be present on the aggregate of a host. If this metadata is not present or does not match the expected value, the aggregate and all hosts within in will be rejected.

Requires the AggregateInstanceExtraSpecsFilter scheduler filter.

aggregate_instance_extra_specs:{key}
Type

str

Specify metadata that must be present on the aggregate of a host. If this metadata is not present, the host will be rejected. Requires the AggregateInstanceExtraSpecsFilter scheduler filter.

The value can be one of the following:

  • = (equal to or greater than as a number; same as vcpus case)

  • == (equal to as a number)

  • != (not equal to as a number)

  • >= (greater than or equal to as a number)

  • <= (less than or equal to as a number)

  • s== (equal to as a string)

  • s!= (not equal to as a string)

  • s>= (greater than or equal to as a string)

  • s> (greater than as a string)

  • s<= (less than or equal to as a string)

  • s< (less than as a string)

  • <in> (substring)

  • <all-in> (all elements contained in collection)

  • <or> (find one of these)

  • A specific value, e.g. true, 123, testing

capabilities

The following extra specs are used to specify a host capability that must be provided by the host compute service. If this capability is not present or does not match the expected value, the host will be rejected.

Requires the ComputeCapabilitiesFilter scheduler filter.

All extra specs expect similar types of values:

  • = (equal to or greater than as a number; same as vcpus case)

  • == (equal to as a number)

  • != (not equal to as a number)

  • >= (greater than or equal to as a number)

  • <= (less than or equal to as a number)

  • s== (equal to as a string)

  • s!= (not equal to as a string)

  • s>= (greater than or equal to as a string)

  • s> (greater than as a string)

  • s<= (less than or equal to as a string)

  • s< (less than as a string)

  • <in> (substring)

  • <all-in> (all elements contained in collection)

  • <or> (find one of these)

  • A specific value, e.g. true, 123, testing

Examples are: >= 5, s== 2.1.0, <in> gcc, <all-in> aes mmx, and <or> fpu <or> gpu

Note

Not all operators will apply to all types of values. For example, the == operator should not be used for a string value - use s== instead.

capabilities:id
Type

str

Specify that the ‘id’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:uuid
Type

str

Specify that the ‘uuid’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:service_id
Type

str

Specify that the ‘service_id’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:host
Type

str

Specify that the ‘host’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:vcpus
Type

str

Specify that the ‘vcpus’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:memory_mb
Type

str

Specify that the ‘memory_mb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:local_gb
Type

str

Specify that the ‘local_gb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:vcpus_used
Type

str

Specify that the ‘vcpus_used’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:memory_mb_used
Type

str

Specify that the ‘memory_mb_used’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:local_gb_used
Type

str

Specify that the ‘local_gb_used’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:hypervisor_type
Type

str

Specify that the ‘hypervisor_type’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:hypervisor_version
Type

str

Specify that the ‘hypervisor_version’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:hypervisor_hostname
Type

str

Specify that the ‘hypervisor_hostname’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:free_ram_mb
Type

str

Specify that the ‘free_ram_mb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:free_disk_gb
Type

str

Specify that the ‘free_disk_gb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:current_workload
Type

str

Specify that the ‘current_workload’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:running_vms
Type

str

Specify that the ‘running_vms’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:disk_available_least
Type

str

Specify that the ‘disk_available_least’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:host_ip
Type

str

Specify that the ‘host_ip’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:mapped
Type

str

Specify that the ‘mapped’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:cpu_allocation_ratio
Type

str

Specify that the ‘cpu_allocation_ratio’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:ram_allocation_ratio
Type

str

Specify that the ‘ram_allocation_ratio’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:disk_allocation_ratio
Type

str

Specify that the ‘disk_allocation_ratio’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:total_usable_ram_mb
Type

str

Specify that the ‘total_usable_ram_mb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:total_usable_disk_gb
Type

str

Specify that the ‘total_usable_disk_gb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:disk_mb_used
Type

str

Specify that the ‘disk_mb_used’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:free_disk_mb
Type

str

Specify that the ‘free_disk_mb’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:vcpus_total
Type

str

Specify that the ‘vcpus_total’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:num_instances
Type

str

Specify that the ‘num_instances’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:num_io_ops
Type

str

Specify that the ‘num_io_ops’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:failed_builds
Type

str

Specify that the ‘failed_builds’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:aggregates
Type

str

Specify that the ‘aggregates’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:cell_uuid
Type

str

Specify that the ‘cell_uuid’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:updated
Type

str

Specify that the ‘updated’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:cpu_info{filter}
Type

str

Specify that the ‘cpu_info’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:metrics{filter}
Type

str

Specify that the ‘metrics’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:stats{filter}
Type

str

Specify that the ‘stats’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:numa_topology{filter}
Type

str

Specify that the ‘numa_topology’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:supported_hv_specs{filter}
Type

str

Specify that the ‘supported_hv_specs’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:pci_device_pools{filter}
Type

str

Specify that the ‘pci_device_pools’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:nodename{filter}
Type

str

Specify that the ‘nodename’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:pci_stats{filter}
Type

str

Specify that the ‘pci_stats’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:supported_instances{filter}
Type

str

Specify that the ‘supported_instances’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:limits{filter}
Type

str

Specify that the ‘limits’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

capabilities:instances{filter}
Type

str

Specify that the ‘instances’ capability provided by the host compute service satisfy the provided filter value. Requires the ComputeCapabilitiesFilter scheduler filter.

Virt driver

The following extra specs are used as hints to configure internals of a instance, from the bus used for paravirtualized devices to the amount of a physical device to passthrough to the instance. Most of these are virt driver-specific.

quota

The following extra specs are used to configure quotas for various paravirtualized devices. Different quotas are supported by different virt drivers, as noted below.

quota:cpu_limit
Type

int

The limit for cpu. Only supported by the VMWare virt driver.

quota:cpu_reservation
Type

int

The reservation for cpu. Only supported by the VMWare virt driver.

quota:cpu_shares_level
Type

str

The shares level for cpu. Only supported by the VMWare virt driver.

quota:cpu_shares_share
Type

int

The shares share for cpu. Only supported by the VMWare virt driver.

quota:memory_limit
Type

int

The limit for memory. Only supported by the VMWare virt driver.

quota:memory_reservation
Type

int

The reservation for memory. Only supported by the VMWare virt driver.

quota:memory_shares_level
Type

str

The shares level for memory. Only supported by the VMWare virt driver.

quota:memory_shares_share
Type

int

The shares share for memory. Only supported by the VMWare virt driver.

quota:disk_io_limit
Type

int

The limit for disk_io. Only supported by the VMWare virt driver.

quota:disk_io_reservation
Type

int

The reservation for disk_io. Only supported by the VMWare virt driver.

quota:disk_io_shares_level
Type

str

The shares level for disk_io. Only supported by the VMWare virt driver.

quota:disk_io_shares_share
Type

int

The shares share for disk_io. Only supported by the VMWare virt driver.

quota:vif_limit
Type

int

The limit for vif. Only supported by the VMWare virt driver.

quota:vif_reservation
Type

int

The reservation for vif. Only supported by the VMWare virt driver.

quota:vif_shares_level
Type

str

The shares level for vif. Only supported by the VMWare virt driver.

quota:vif_shares_share
Type

int

The shares share for vif. Only supported by the VMWare virt driver.

quota:cpu_shares
Type

int

Min

0

The quota shares for CPU. Only supported by the libvirt virt driver.

quota:cpu_period
Type

int

Min

0

The quota period for CPU. Only supported by the libvirt virt driver.

quota:cpu_quota
Type

int

Min

0

The quota quota for CPU. Only supported by the libvirt virt driver.

quota:disk_read_bytes_sec
Type

int

Min

0

The quota read bytes for disk. Only supported by the libvirt virt driver.

quota:disk_read_iops_sec
Type

int

Min

0

The quota read iops for disk. Only supported by the libvirt virt driver.

quota:disk_write_bytes_sec
Type

int

Min

0

The quota write bytes for disk. Only supported by the libvirt virt driver.

quota:disk_write_iops_sec
Type

int

Min

0

The quota write iops for disk. Only supported by the libvirt virt driver.

quota:disk_total_bytes_sec
Type

int

Min

0

The quota total bytes for disk. Only supported by the libvirt virt driver.

quota:disk_total_iops_sec
Type

int

Min

0

The quota total iops for disk. Only supported by the libvirt virt driver.

quota:vif_inbound_average
Type

int

Min

0

The quota inbound average for VIF. Only supported by the libvirt virt driver.

quota:vif_inbound_peak
Type

int

Min

0

The quota inbound peak for VIF. Only supported by the libvirt virt driver.

quota:vif_inbound_burst
Type

int

Min

0

The quota inbound burst for VIF. Only supported by the libvirt virt driver.

quota:vif_outbound_average
Type

int

Min

0

The quota outbound average for VIF. Only supported by the libvirt virt driver.

quota:vif_outbound_peak
Type

int

Min

0

The quota outbound peak for VIF. Only supported by the libvirt virt driver.

quota:vif_outbound_burst
Type

int

Min

0

The quota outbound burst for VIF. Only supported by the libvirt virt driver.

accel

The following extra specs are used to configure attachment of various accelerators to an instance. For more information, refer to the Cyborg documentation.

They are only supported by the libvirt virt driver.

accel:device_profile
Type

str

The name of a device profile to configure for the instance. A device profile may be viewed as a “flavor for devices”.

pci_passthrough

The following extra specs are used to configure passthrough of a host PCI device to an instance. This requires prior host configuration. For more information, refer to Attaching physical PCI devices to guests.

They are only supported by the libvirt virt driver.

pci_passthrough:alias
Type

str

Specify the number of $alias PCI device(s) to attach to the instance. Must be of format $alias:$number. Use commas to specify multiple values.

hw

The following extra specs are used to configure various attributes of instances. Some of the extra specs act as feature flags, while others tweak for example the guest-visible CPU topology of the instance.

Except where otherwise stated, they are only supported by the libvirt virt driver.

hw:cpu_realtime
Type

bool

Determine whether realtime mode should be enabled for the instance or not. Only supported by the libvirt driver.

hw:cpu_realtime_mask
Type

str

A exclusion mask of CPUs that should not be enabled for realtime.

hw:hide_hypervisor_id
Type

bool

Determine whether the hypervisor ID should be hidden from the guest. Only supported by the libvirt driver.

hw:cpu_policy
Type

str

The policy to apply when determining what host CPUs the guest CPUs can run on. If shared (default), guest CPUs can be overallocated but cannot float across host cores. If dedicated, guest CPUs cannot be overallocated but are individually pinned to their own host core. mixed is a policy with which the guest is mixing the overallocated and pinned guest CPUs.

hw:cpu_thread_policy
Type

str

The policy to apply when determining whether the destination host can have hardware threads enabled or not. If prefer (default), hosts with hardware threads will be preferred. If require, hosts with hardware threads will be required. If isolate, hosts with hardware threads will be forbidden.

hw:emulator_threads_policy
Type

str

The policy to apply when determining whether emulator threads should be offloaded to a separate isolated core or to a pool of shared cores. If share, emulator overhead threads will be offloaded to a pool of shared cores. If isolate, emulator overhead threads will be offloaded to their own core.

hw:cpu_dedicated_mask
Type

str

A mapping of guest CPUs to be pinned to host CPUs for an instance with a mixed CPU policy. For guest CPUs which are not in this mapping it will float across host cores.

hw:mem_page_size
Type

str

The size of memory pages to allocate to the guest with. Can be one of the three alias - large, small or any, - or an actual size. Only supported by the libvirt virt driver.

hw:numa_nodes
Type

int

Min

1

The number of virtual NUMA nodes to allocate to configure the guest with. Each virtual NUMA node will be mapped to a unique host NUMA node. Only supported by the libvirt virt driver.

hw:numa_cpus.{id}
Type

str

A mapping of guest CPUs to the guest NUMA node identified by {id}. This can be used to provide asymmetric CPU-NUMA allocation and is necessary where the number of guest NUMA nodes is not a factor of the number of guest CPUs.

hw:numa_mem.{id}
Type

int

Min

1

A mapping of guest memory to the guest NUMA node identified by {id}. This can be used to provide asymmetric memory-NUMA allocation and is necessary where the number of guest NUMA nodes is not a factor of the total guest memory.

hw:pci_numa_affinity_policy
Type

str

The NUMA affinity policy of any PCI passthrough devices or SR-IOV network interfaces attached to the instance.

hw:cpu_sockets
Type

int

Min

1

The number of virtual CPU threads to emulate in the guest CPU topology.

hw:cpu_cores
Type

int

Min

1

The number of virtual CPU cores to emulate per socket in the guest CPU topology.

hw:cpu_threads
Type

int

Min

1

The number of virtual CPU threads to emulate per core in the guest CPU topology.

hw:max_cpu_sockets
Type

int

Min

1

The max number of virtual CPU threads to emulate in the guest CPU topology. This is used to limit the topologies that can be requested by an image and will be used to validate the hw_cpu_sockets image metadata property.

hw:max_cpu_cores
Type

int

Min

1

The max number of virtual CPU cores to emulate per socket in the guest CPU topology. This is used to limit the topologies that can be requested by an image and will be used to validate the hw_cpu_cores image metadata property.

hw:max_cpu_threads
Type

int

Min

1

The max number of virtual CPU threads to emulate per core in the guest CPU topology. This is used to limit the topologies that can be requested by an image and will be used to validate the hw_cpu_threads image metadata property.

hw:boot_menu
Type

bool

Whether to show a boot menu when booting the guest.

hw:mem_encryption
Type

bool

Whether to enable memory encryption for the guest. Only supported by the libvirt driver on hosts with AMD SEV support.

hw:pmem
Type

str

A comma-separated list of $LABELs defined in config for vPMEM devices.

hw:pmu
Type

bool

Whether to enable the Performance Monitory Unit (PMU) for the guest. Only supported by the libvirt driver.

hw:serial_port_count
Type

int

Min

0

The number of serial ports to allocate to the guest. Only supported by the libvirt virt driver.

hw:tpm_model
Type

str

The model of the attached TPM device.

hw:tpm_version
Type

str

The TPM version. Required if requesting a vTPM via the ‘hw:tpm_model’ extra spec or equivalent image metadata property.

hw:watchdog_action
Type

str

The action to take when the watchdog timer is kicked. Only supported by the libvirt virt driver.

hw_rng

The following extra specs are used to configure a random number generator for an instance.

They are only supported by the libvirt virt driver.

hw_rng:allowed
Type

bool

Whether to disable configuration of a random number generator in their image. Before 21.0.0 (Ussuri), random number generators were not enabled by default so this was used to determine whether to enable configuration.

hw_rng:rate_bytes
Type

int

Min

0

The allowed amount of bytes for the guest to read from the host’s entropy per period.

hw_rng:rate_period
Type

int

Min

0

The duration of a read period in seconds.

hw_video

The following extra specs are used to configure attributes of the default guest video device.

They are only supported by the libvirt virt driver.

hw_video:ram_max_mb
Type

int

Min

0

The maximum amount of memory the user can request using the hw_video_ram image metadata property, which represents the video memory that the guest OS will see. This has no effect for vGPUs.

os

The following extra specs are used to configure various attributes of instances when using the HyperV virt driver.

They are only supported by the HyperV virt driver.

os:secure_boot
Type

str

Determine whether secure boot is enabled or not. Only supported by the libvirt and HyperV drivers.

os:resolution
Type

str

Guest VM screen resolution size. Only supported by the HyperV driver.

os:monitors
Type

int

Min

1

Max

8

Guest VM number of monitors. Only supported by the HyperV driver.

os:vram
Type

str

Guest VM VRAM amount. Only supported by the HyperV driver.

powervm

The following extra specs are used to configure various attributes of instances when using the PowerVM virt driver.

They are only supported by the PowerVM virt driver.

powervm:min_mem
Type

int

Min

256

Minimum memory (MB). If you do not specify the value, the value is defaulted to the value for memory_mb.

powervm:max_mem
Type

int

Min

256

Maximum memory (MB). If you do not specify the value, the value is defaulted to the value for memory_mb.

powervm:min_vcpu
Type

int

Min

1

Minimum virtual processors. Minimum resource that is required for LPAR to boot is 1. The maximum value can be equal to the value, which is set to vCPUs. If you specify the value of the attribute, you must also specify value of powervm:max_vcpu. Defaults to value set for vCPUs.

powervm:max_vcpu
Type

int

Min

1

Minimum virtual processors. Minimum resource that is required for LPAR to boot is 1. The maximum value can be equal to the value, which is set to vCPUs. If you specify the value of the attribute, you must also specify value of powervm:max_vcpu. Defaults to value set for vCPUs.

powervm:proc_units
Type

str

The wanted proc_units. The value for the attribute cannot be less than 1/10 of the value that is specified for Virtual CPUs (vCPUs) for hosts with firmware level 7.5 or earlier and 1/20 of the value that is specified for vCPUs for hosts with firmware level 7.6 or later. If the value is not specified during deployment, it is defaulted to vCPUs * 0.5.

powervm:min_proc_units
Type

str

Minimum proc_units. The minimum value for the attribute is 0.1 for hosts with firmware level 7.5 or earlier and 0.05 for hosts with firmware level 7.6 or later. The maximum value must be equal to the maximum value of powervm:proc_units. If you specify the attribute, you must also specify powervm:proc_units, powervm:max_proc_units, powervm:min_vcpu, powervm:max_vcpu`, and powervm:dedicated_proc. Set the powervm:dedicated_proc to false. The value for the attribute cannot be less than 1/10 of the value that is specified for powervm:min_vcpu for hosts with firmware level 7.5 or earlier and 1/20 of the value that is specified for powervm:min_vcpu for hosts with firmware level 7.6 or later. If you do not specify the value of the attribute during deployment, it is defaulted to equal the value of powervm:proc_units.

powervm:max_proc_units
Type

str

Maximum proc_units. The minimum value can be equal to `` powervm:proc_units. The maximum value for the attribute cannot be more than the value of the host for maximum allowed processors per partition. If you specify this attribute, you must also specify powervm:proc_units, powervm:min_proc_units, powervm:min_vcpu, powervm:max_vcpu, and powervm:dedicated_proc. Set the powervm:dedicated_proc to false. The value for the attribute cannot be less than 1/10 of the value that is specified for powervm:max_vcpu for hosts with firmware level 7.5 or earlier and 1/20 of the value that is specified for powervm:max_vcpu for hosts with firmware level 7.6 or later. If you do not specify the value of the attribute during deployment, the value is defaulted to equal the value of powervm:proc_units.

powervm:dedicated_proc
Type

bool

Use dedicated processors. The attribute defaults to false.

powervm:shared_weight
Type

int

Min

0

Max

255

Shared processor weight. When powervm:dedicated_proc is set to true and powervm:uncapped is also set to true, the value of the attribute defaults to 128.

powervm:availability_priority
Type

int

Min

0

Max

255

Availability priority. The attribute priority of the server if there is a processor failure and there are not enough resources for all servers. VIOS and i5 need to remain high priority default of 191. The value of the attribute defaults to 128.

powervm:uncapped
Type

bool

LPAR can use unused processor cycles that are beyond or exceed the wanted setting of the attribute. This attribute is supported only when powervm:dedicated_proc is set to false. When powervm:dedicated_proc is set to false, powervm:uncapped defaults to true.

powervm:dedicated_sharing_mode
Type

str

Sharing mode for dedicated processors. The attribute is supported only when powervm:dedicated_proc is set to true.

powervm:processor_compatibility
Type

str

A processor compatibility mode is a value that is assigned to a logical partition by the hypervisor that specifies the processor environment in which the logical partition can successfully operate.

powervm:shared_proc_pool_name
Type

str

Specifies the shared processor pool to be targeted during deployment of a virtual machine.

powervm:srr_capability
Type

bool

If the value of simplified remote restart capability is set to true for the LPAR, you can remote restart the LPAR to supported CEC or host when the source CEC or host is down. The attribute defaults to false.

vmware

The following extra specs are used to configure various attributes of instances when using the VMWare virt driver.

They are only supported by the VMWare virt driver.

vmware:hw_version
Type

str

Specify the hardware version used to create images. In an environment with different host versions, you can use this parameter to place instances on the correct hosts.

vmware:storage_policy
Type

str

Specify the storage policy used for new instances. If Storage Policy-Based Management (SPBM) is not enabled, this parameter is ignored.

Others (uncategorized)

The following extra specs are not part of a group.

hide_hypervisor_id
Type

bool

Determine whether the hypervisor ID should be hidden from the guest. Only supported by the libvirt driver. This extra spec is not compatible with the AggregateInstanceExtraSpecsFilter scheduler filter. The hw:hide_hypervisor_id extra spec should be used instead.

Warning

This extra spec has been deprecated and should not be used.

group_policy
Type

str

The group policy to apply when using the granular resource request syntax.