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.
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
¶int
The amount of resource VCPU requested.
resources{group}:MEMORY_MB
¶int
The amount of resource MEMORY_MB requested.
resources{group}:DISK_GB
¶int
The amount of resource DISK_GB requested.
resources{group}:PCI_DEVICE
¶int
The amount of resource PCI_DEVICE requested.
resources{group}:SRIOV_NET_VF
¶int
The amount of resource SRIOV_NET_VF requested.
resources{group}:NUMA_SOCKET
¶int
The amount of resource NUMA_SOCKET requested.
resources{group}:NUMA_CORE
¶int
The amount of resource NUMA_CORE requested.
resources{group}:NUMA_THREAD
¶int
The amount of resource NUMA_THREAD requested.
resources{group}:NUMA_MEMORY_MB
¶int
The amount of resource NUMA_MEMORY_MB requested.
resources{group}:IPV4_ADDRESS
¶int
The amount of resource IPV4_ADDRESS requested.
resources{group}:VGPU
¶int
The amount of resource VGPU requested.
resources{group}:VGPU_DISPLAY_HEAD
¶int
The amount of resource VGPU_DISPLAY_HEAD requested.
resources{group}:NET_BW_EGR_KILOBIT_PER_SEC
¶int
The amount of resource NET_BW_EGR_KILOBIT_PER_SEC requested.
resources{group}:NET_BW_IGR_KILOBIT_PER_SEC
¶int
The amount of resource NET_BW_IGR_KILOBIT_PER_SEC requested.
resources{group}:PCPU
¶int
The amount of resource PCPU requested.
resources{group}:MEM_ENCRYPTION_CONTEXT
¶int
The amount of resource MEM_ENCRYPTION_CONTEXT requested.
resources{group}:FPGA
¶int
The amount of resource FPGA requested.
resources{group}:PGPU
¶int
The amount of resource PGPU requested.
resources{group}:CUSTOM_{resource}
¶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
¶str
Require or forbid trait COMPUTE_DEVICE_TAGGING.
trait{group}:COMPUTE_NODE
¶str
Require or forbid trait COMPUTE_NODE.
trait{group}:COMPUTE_TRUSTED_CERTS
¶str
Require or forbid trait COMPUTE_TRUSTED_CERTS.
trait{group}:COMPUTE_SAME_HOST_COLD_MIGRATE
¶str
Require or forbid trait COMPUTE_SAME_HOST_COLD_MIGRATE.
trait{group}:COMPUTE_RESCUE_BFV
¶str
Require or forbid trait COMPUTE_RESCUE_BFV.
trait{group}:COMPUTE_ACCELERATORS
¶str
Require or forbid trait COMPUTE_ACCELERATORS.
trait{group}:COMPUTE_GRAPHICS_MODEL_CIRRUS
¶str
Require or forbid trait COMPUTE_GRAPHICS_MODEL_CIRRUS.
trait{group}:COMPUTE_GRAPHICS_MODEL_GOP
¶str
Require or forbid trait COMPUTE_GRAPHICS_MODEL_GOP.
trait{group}:COMPUTE_GRAPHICS_MODEL_NONE
¶str
Require or forbid trait COMPUTE_GRAPHICS_MODEL_NONE.
trait{group}:COMPUTE_GRAPHICS_MODEL_QXL
¶str
Require or forbid trait COMPUTE_GRAPHICS_MODEL_QXL.
trait{group}:COMPUTE_GRAPHICS_MODEL_VGA
¶str
Require or forbid trait COMPUTE_GRAPHICS_MODEL_VGA.
trait{group}:COMPUTE_GRAPHICS_MODEL_VIRTIO
¶str
Require or forbid trait COMPUTE_GRAPHICS_MODEL_VIRTIO.
trait{group}:COMPUTE_GRAPHICS_MODEL_VMVGA
¶str
Require or forbid trait COMPUTE_GRAPHICS_MODEL_VMVGA.
trait{group}:COMPUTE_GRAPHICS_MODEL_XEN
¶str
Require or forbid trait COMPUTE_GRAPHICS_MODEL_XEN.
trait{group}:COMPUTE_IMAGE_TYPE_AKI
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_AKI.
trait{group}:COMPUTE_IMAGE_TYPE_AMI
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_AMI.
trait{group}:COMPUTE_IMAGE_TYPE_ARI
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_ARI.
trait{group}:COMPUTE_IMAGE_TYPE_ISO
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_ISO.
trait{group}:COMPUTE_IMAGE_TYPE_QCOW2
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_QCOW2.
trait{group}:COMPUTE_IMAGE_TYPE_RAW
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_RAW.
trait{group}:COMPUTE_IMAGE_TYPE_VDI
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_VDI.
trait{group}:COMPUTE_IMAGE_TYPE_VHD
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_VHD.
trait{group}:COMPUTE_IMAGE_TYPE_VHDX
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_VHDX.
trait{group}:COMPUTE_IMAGE_TYPE_VMDK
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_VMDK.
trait{group}:COMPUTE_IMAGE_TYPE_PLOOP
¶str
Require or forbid trait COMPUTE_IMAGE_TYPE_PLOOP.
trait{group}:COMPUTE_MIGRATE_AUTO_CONVERGE
¶str
Require or forbid trait COMPUTE_MIGRATE_AUTO_CONVERGE.
trait{group}:COMPUTE_MIGRATE_POST_COPY
¶str
Require or forbid trait COMPUTE_MIGRATE_POST_COPY.
trait{group}:COMPUTE_NET_ATTACH_INTERFACE
¶str
Require or forbid trait COMPUTE_NET_ATTACH_INTERFACE.
trait{group}:COMPUTE_NET_ATTACH_INTERFACE_WITH_TAG
¶str
Require or forbid trait COMPUTE_NET_ATTACH_INTERFACE_WITH_TAG.
trait{group}:COMPUTE_NET_VIF_MODEL_E1000
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_E1000.
trait{group}:COMPUTE_NET_VIF_MODEL_E1000E
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_E1000E.
trait{group}:COMPUTE_NET_VIF_MODEL_LAN9118
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_LAN9118.
trait{group}:COMPUTE_NET_VIF_MODEL_NETFRONT
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_NETFRONT.
trait{group}:COMPUTE_NET_VIF_MODEL_NE2K_PCI
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_NE2K_PCI.
trait{group}:COMPUTE_NET_VIF_MODEL_PCNET
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_PCNET.
trait{group}:COMPUTE_NET_VIF_MODEL_RTL8139
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_RTL8139.
trait{group}:COMPUTE_NET_VIF_MODEL_SPAPR_VLAN
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_SPAPR_VLAN.
trait{group}:COMPUTE_NET_VIF_MODEL_SRIOV
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_SRIOV.
trait{group}:COMPUTE_NET_VIF_MODEL_VIRTIO
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_VIRTIO.
trait{group}:COMPUTE_NET_VIF_MODEL_VMXNET
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_VMXNET.
trait{group}:COMPUTE_NET_VIF_MODEL_VMXNET3
¶str
Require or forbid trait COMPUTE_NET_VIF_MODEL_VMXNET3.
trait{group}:COMPUTE_SECURITY_TPM_1_2
¶str
Require or forbid trait COMPUTE_SECURITY_TPM_1_2.
trait{group}:COMPUTE_SECURITY_TPM_2_0
¶str
Require or forbid trait COMPUTE_SECURITY_TPM_2_0.
trait{group}:COMPUTE_STATUS_DISABLED
¶str
Require or forbid trait COMPUTE_STATUS_DISABLED.
trait{group}:COMPUTE_STORAGE_BUS_FDC
¶str
Require or forbid trait COMPUTE_STORAGE_BUS_FDC.
trait{group}:COMPUTE_STORAGE_BUS_IDE
¶str
Require or forbid trait COMPUTE_STORAGE_BUS_IDE.
trait{group}:COMPUTE_STORAGE_BUS_LXC
¶str
Require or forbid trait COMPUTE_STORAGE_BUS_LXC.
trait{group}:COMPUTE_STORAGE_BUS_SATA
¶str
Require or forbid trait COMPUTE_STORAGE_BUS_SATA.
trait{group}:COMPUTE_STORAGE_BUS_SCSI
¶str
Require or forbid trait COMPUTE_STORAGE_BUS_SCSI.
trait{group}:COMPUTE_STORAGE_BUS_USB
¶str
Require or forbid trait COMPUTE_STORAGE_BUS_USB.
trait{group}:COMPUTE_STORAGE_BUS_VIRTIO
¶str
Require or forbid trait COMPUTE_STORAGE_BUS_VIRTIO.
trait{group}:COMPUTE_STORAGE_BUS_UML
¶str
Require or forbid trait COMPUTE_STORAGE_BUS_UML.
trait{group}:COMPUTE_STORAGE_BUS_XEN
¶str
Require or forbid trait COMPUTE_STORAGE_BUS_XEN.
trait{group}:COMPUTE_VOLUME_ATTACH
¶str
Require or forbid trait COMPUTE_VOLUME_ATTACH.
trait{group}:COMPUTE_VOLUME_ATTACH_WITH_TAG
¶str
Require or forbid trait COMPUTE_VOLUME_ATTACH_WITH_TAG.
trait{group}:COMPUTE_VOLUME_EXTEND
¶str
Require or forbid trait COMPUTE_VOLUME_EXTEND.
trait{group}:COMPUTE_VOLUME_MULTI_ATTACH
¶str
Require or forbid trait COMPUTE_VOLUME_MULTI_ATTACH.
trait{group}:HW_CPU_HYPERTHREADING
¶str
Require or forbid trait HW_CPU_HYPERTHREADING.
trait{group}:HW_CPU_AARCH64_FP
¶str
Require or forbid trait HW_CPU_AARCH64_FP.
trait{group}:HW_CPU_AARCH64_ASIMD
¶str
Require or forbid trait HW_CPU_AARCH64_ASIMD.
trait{group}:HW_CPU_AARCH64_EVTSTRM
¶str
Require or forbid trait HW_CPU_AARCH64_EVTSTRM.
trait{group}:HW_CPU_AARCH64_AES
¶str
Require or forbid trait HW_CPU_AARCH64_AES.
trait{group}:HW_CPU_AARCH64_PMULL
¶str
Require or forbid trait HW_CPU_AARCH64_PMULL.
trait{group}:HW_CPU_AARCH64_SHA1
¶str
Require or forbid trait HW_CPU_AARCH64_SHA1.
trait{group}:HW_CPU_AARCH64_SHA2
¶str
Require or forbid trait HW_CPU_AARCH64_SHA2.
trait{group}:HW_CPU_AARCH64_CRC32
¶str
Require or forbid trait HW_CPU_AARCH64_CRC32.
trait{group}:HW_CPU_AARCH64_FPHP
¶str
Require or forbid trait HW_CPU_AARCH64_FPHP.
trait{group}:HW_CPU_AARCH64_ASIMDHP
¶str
Require or forbid trait HW_CPU_AARCH64_ASIMDHP.
trait{group}:HW_CPU_AARCH64_ASIMDRDM
¶str
Require or forbid trait HW_CPU_AARCH64_ASIMDRDM.
trait{group}:HW_CPU_AARCH64_ATOMICS
¶str
Require or forbid trait HW_CPU_AARCH64_ATOMICS.
trait{group}:HW_CPU_AARCH64_JSCVT
¶str
Require or forbid trait HW_CPU_AARCH64_JSCVT.
trait{group}:HW_CPU_AARCH64_FCMA
¶str
Require or forbid trait HW_CPU_AARCH64_FCMA.
trait{group}:HW_CPU_AARCH64_LRCPC
¶str
Require or forbid trait HW_CPU_AARCH64_LRCPC.
trait{group}:HW_CPU_AARCH64_DCPOP
¶str
Require or forbid trait HW_CPU_AARCH64_DCPOP.
trait{group}:HW_CPU_AARCH64_SHA3
¶str
Require or forbid trait HW_CPU_AARCH64_SHA3.
trait{group}:HW_CPU_AARCH64_SM3
¶str
Require or forbid trait HW_CPU_AARCH64_SM3.
trait{group}:HW_CPU_AARCH64_SM4
¶str
Require or forbid trait HW_CPU_AARCH64_SM4.
trait{group}:HW_CPU_AARCH64_ASIMDDP
¶str
Require or forbid trait HW_CPU_AARCH64_ASIMDDP.
trait{group}:HW_CPU_AARCH64_SHA512
¶str
Require or forbid trait HW_CPU_AARCH64_SHA512.
trait{group}:HW_CPU_AARCH64_SVE
¶str
Require or forbid trait HW_CPU_AARCH64_SVE.
trait{group}:HW_CPU_AARCH64_CPUID
¶str
Require or forbid trait HW_CPU_AARCH64_CPUID.
trait{group}:HW_CPU_AMD_SEV
¶str
Require or forbid trait HW_CPU_AMD_SEV.
trait{group}:HW_CPU_PPC64LE_POWER8
¶str
Require or forbid trait HW_CPU_PPC64LE_POWER8.
trait{group}:HW_CPU_PPC64LE_POWER9
¶str
Require or forbid trait HW_CPU_PPC64LE_POWER9.
trait{group}:HW_CPU_X86_AVX
¶str
Require or forbid trait HW_CPU_X86_AVX.
trait{group}:HW_CPU_X86_AVX2
¶str
Require or forbid trait HW_CPU_X86_AVX2.
trait{group}:HW_CPU_X86_CLMUL
¶str
Require or forbid trait HW_CPU_X86_CLMUL.
trait{group}:HW_CPU_X86_FMA3
¶str
Require or forbid trait HW_CPU_X86_FMA3.
trait{group}:HW_CPU_X86_FMA4
¶str
Require or forbid trait HW_CPU_X86_FMA4.
trait{group}:HW_CPU_X86_F16C
¶str
Require or forbid trait HW_CPU_X86_F16C.
trait{group}:HW_CPU_X86_MMX
¶str
Require or forbid trait HW_CPU_X86_MMX.
trait{group}:HW_CPU_X86_SSE
¶str
Require or forbid trait HW_CPU_X86_SSE.
trait{group}:HW_CPU_X86_SSE2
¶str
Require or forbid trait HW_CPU_X86_SSE2.
trait{group}:HW_CPU_X86_SSE3
¶str
Require or forbid trait HW_CPU_X86_SSE3.
trait{group}:HW_CPU_X86_SSSE3
¶str
Require or forbid trait HW_CPU_X86_SSSE3.
trait{group}:HW_CPU_X86_SSE41
¶str
Require or forbid trait HW_CPU_X86_SSE41.
trait{group}:HW_CPU_X86_SSE42
¶str
Require or forbid trait HW_CPU_X86_SSE42.
trait{group}:HW_CPU_X86_SSE4A
¶str
Require or forbid trait HW_CPU_X86_SSE4A.
trait{group}:HW_CPU_X86_XOP
¶str
Require or forbid trait HW_CPU_X86_XOP.
trait{group}:HW_CPU_X86_3DNOW
¶str
Require or forbid trait HW_CPU_X86_3DNOW.
trait{group}:HW_CPU_X86_AVX512F
¶str
Require or forbid trait HW_CPU_X86_AVX512F.
trait{group}:HW_CPU_X86_AVX512CD
¶str
Require or forbid trait HW_CPU_X86_AVX512CD.
trait{group}:HW_CPU_X86_AVX512PF
¶str
Require or forbid trait HW_CPU_X86_AVX512PF.
trait{group}:HW_CPU_X86_AVX512ER
¶str
Require or forbid trait HW_CPU_X86_AVX512ER.
trait{group}:HW_CPU_X86_AVX512VL
¶str
Require or forbid trait HW_CPU_X86_AVX512VL.
trait{group}:HW_CPU_X86_AVX512BW
¶str
Require or forbid trait HW_CPU_X86_AVX512BW.
trait{group}:HW_CPU_X86_AVX512DQ
¶str
Require or forbid trait HW_CPU_X86_AVX512DQ.
trait{group}:HW_CPU_X86_AVX512VNNI
¶str
Require or forbid trait HW_CPU_X86_AVX512VNNI.
trait{group}:HW_CPU_X86_ABM
¶str
Require or forbid trait HW_CPU_X86_ABM.
trait{group}:HW_CPU_X86_BMI
¶str
Require or forbid trait HW_CPU_X86_BMI.
trait{group}:HW_CPU_X86_BMI2
¶str
Require or forbid trait HW_CPU_X86_BMI2.
trait{group}:HW_CPU_X86_TBM
¶str
Require or forbid trait HW_CPU_X86_TBM.
trait{group}:HW_CPU_X86_AESNI
¶str
Require or forbid trait HW_CPU_X86_AESNI.
trait{group}:HW_CPU_X86_SHA
¶str
Require or forbid trait HW_CPU_X86_SHA.
trait{group}:HW_CPU_X86_MPX
¶str
Require or forbid trait HW_CPU_X86_MPX.
trait{group}:HW_CPU_X86_SGX
¶str
Require or forbid trait HW_CPU_X86_SGX.
trait{group}:HW_CPU_X86_TSX
¶str
Require or forbid trait HW_CPU_X86_TSX.
trait{group}:HW_CPU_X86_ASF
¶str
Require or forbid trait HW_CPU_X86_ASF.
trait{group}:HW_CPU_X86_VMX
¶str
Require or forbid trait HW_CPU_X86_VMX.
trait{group}:HW_CPU_X86_SVM
¶str
Require or forbid trait HW_CPU_X86_SVM.
trait{group}:HW_CPU_X86_PDPE1GB
¶str
Require or forbid trait HW_CPU_X86_PDPE1GB.
trait{group}:HW_CPU_X86_STIBP
¶str
Require or forbid trait HW_CPU_X86_STIBP.
trait{group}:HW_CPU_X86_AMD_SEV
¶str
Require or forbid trait HW_CPU_X86_AMD_SEV.
trait{group}:HW_CPU_X86_AMD_SVM
¶str
Require or forbid trait HW_CPU_X86_AMD_SVM.
trait{group}:HW_CPU_X86_AMD_IBPB
¶str
Require or forbid trait HW_CPU_X86_AMD_IBPB.
trait{group}:HW_CPU_X86_AMD_NO_SSB
¶str
Require or forbid trait HW_CPU_X86_AMD_NO_SSB.
trait{group}:HW_CPU_X86_AMD_SSBD
¶str
Require or forbid trait HW_CPU_X86_AMD_SSBD.
trait{group}:HW_CPU_X86_AMD_VIRT_SSBD
¶str
Require or forbid trait HW_CPU_X86_AMD_VIRT_SSBD.
trait{group}:HW_CPU_X86_INTEL_MD_CLEAR
¶str
Require or forbid trait HW_CPU_X86_INTEL_MD_CLEAR.
trait{group}:HW_CPU_X86_INTEL_PCID
¶str
Require or forbid trait HW_CPU_X86_INTEL_PCID.
trait{group}:HW_CPU_X86_INTEL_SPEC_CTRL
¶str
Require or forbid trait HW_CPU_X86_INTEL_SPEC_CTRL.
trait{group}:HW_CPU_X86_INTEL_SSBD
¶str
Require or forbid trait HW_CPU_X86_INTEL_SSBD.
trait{group}:HW_CPU_X86_INTEL_VMX
¶str
Require or forbid trait HW_CPU_X86_INTEL_VMX.
trait{group}:HW_GPU_API_DIRECTX_V10
¶str
Require or forbid trait HW_GPU_API_DIRECTX_V10.
trait{group}:HW_GPU_API_DIRECTX_V11
¶str
Require or forbid trait HW_GPU_API_DIRECTX_V11.
trait{group}:HW_GPU_API_DIRECTX_V12
¶str
Require or forbid trait HW_GPU_API_DIRECTX_V12.
trait{group}:HW_GPU_API_DIRECT2D
¶str
Require or forbid trait HW_GPU_API_DIRECT2D.
trait{group}:HW_GPU_API_DIRECT3D_V6_0
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V6_0.
trait{group}:HW_GPU_API_DIRECT3D_V7_0
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V7_0.
trait{group}:HW_GPU_API_DIRECT3D_V8_0
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V8_0.
trait{group}:HW_GPU_API_DIRECT3D_V8_1
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V8_1.
trait{group}:HW_GPU_API_DIRECT3D_V9_0
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V9_0.
trait{group}:HW_GPU_API_DIRECT3D_V9_0B
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V9_0B.
trait{group}:HW_GPU_API_DIRECT3D_V9_0C
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V9_0C.
trait{group}:HW_GPU_API_DIRECT3D_V9_0L
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V9_0L.
trait{group}:HW_GPU_API_DIRECT3D_V10_0
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V10_0.
trait{group}:HW_GPU_API_DIRECT3D_V10_1
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V10_1.
trait{group}:HW_GPU_API_DIRECT3D_V11_0
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V11_0.
trait{group}:HW_GPU_API_DIRECT3D_V11_1
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V11_1.
trait{group}:HW_GPU_API_DIRECT3D_V11_2
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V11_2.
trait{group}:HW_GPU_API_DIRECT3D_V11_3
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V11_3.
trait{group}:HW_GPU_API_DIRECT3D_V12_0
¶str
Require or forbid trait HW_GPU_API_DIRECT3D_V12_0.
trait{group}:HW_GPU_API_VULKAN
¶str
Require or forbid trait HW_GPU_API_VULKAN.
trait{group}:HW_GPU_API_DXVA
¶str
Require or forbid trait HW_GPU_API_DXVA.
trait{group}:HW_GPU_API_OPENCL_V1_0
¶str
Require or forbid trait HW_GPU_API_OPENCL_V1_0.
trait{group}:HW_GPU_API_OPENCL_V1_1
¶str
Require or forbid trait HW_GPU_API_OPENCL_V1_1.
trait{group}:HW_GPU_API_OPENCL_V1_2
¶str
Require or forbid trait HW_GPU_API_OPENCL_V1_2.
trait{group}:HW_GPU_API_OPENCL_V2_0
¶str
Require or forbid trait HW_GPU_API_OPENCL_V2_0.
trait{group}:HW_GPU_API_OPENCL_V2_1
¶str
Require or forbid trait HW_GPU_API_OPENCL_V2_1.
trait{group}:HW_GPU_API_OPENCL_V2_2
¶str
Require or forbid trait HW_GPU_API_OPENCL_V2_2.
trait{group}:HW_GPU_API_OPENGL_V1_1
¶str
Require or forbid trait HW_GPU_API_OPENGL_V1_1.
trait{group}:HW_GPU_API_OPENGL_V1_2
¶str
Require or forbid trait HW_GPU_API_OPENGL_V1_2.
trait{group}:HW_GPU_API_OPENGL_V1_3
¶str
Require or forbid trait HW_GPU_API_OPENGL_V1_3.
trait{group}:HW_GPU_API_OPENGL_V1_4
¶str
Require or forbid trait HW_GPU_API_OPENGL_V1_4.
trait{group}:HW_GPU_API_OPENGL_V1_5
¶str
Require or forbid trait HW_GPU_API_OPENGL_V1_5.
trait{group}:HW_GPU_API_OPENGL_V2_0
¶str
Require or forbid trait HW_GPU_API_OPENGL_V2_0.
trait{group}:HW_GPU_API_OPENGL_V2_1
¶str
Require or forbid trait HW_GPU_API_OPENGL_V2_1.
trait{group}:HW_GPU_API_OPENGL_V3_0
¶str
Require or forbid trait HW_GPU_API_OPENGL_V3_0.
trait{group}:HW_GPU_API_OPENGL_V3_1
¶str
Require or forbid trait HW_GPU_API_OPENGL_V3_1.
trait{group}:HW_GPU_API_OPENGL_V3_2
¶str
Require or forbid trait HW_GPU_API_OPENGL_V3_2.
trait{group}:HW_GPU_API_OPENGL_V3_3
¶str
Require or forbid trait HW_GPU_API_OPENGL_V3_3.
trait{group}:HW_GPU_API_OPENGL_V4_0
¶str
Require or forbid trait HW_GPU_API_OPENGL_V4_0.
trait{group}:HW_GPU_API_OPENGL_V4_1
¶str
Require or forbid trait HW_GPU_API_OPENGL_V4_1.
trait{group}:HW_GPU_API_OPENGL_V4_2
¶str
Require or forbid trait HW_GPU_API_OPENGL_V4_2.
trait{group}:HW_GPU_API_OPENGL_V4_3
¶str
Require or forbid trait HW_GPU_API_OPENGL_V4_3.
trait{group}:HW_GPU_API_OPENGL_V4_4
¶str
Require or forbid trait HW_GPU_API_OPENGL_V4_4.
trait{group}:HW_GPU_API_OPENGL_V4_5
¶str
Require or forbid trait HW_GPU_API_OPENGL_V4_5.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_0
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_0.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_1
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_1.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_2
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_2.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_3
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V1_3.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_0
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_0.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_1
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V2_1.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_0
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_0.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_2
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_2.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_5
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_5.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_7
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V3_7.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_0
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_0.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_2
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_2.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_3
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V5_3.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_0
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_0.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_1
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_1.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_2
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V6_2.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_0
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_0.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_1
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_1.
trait{group}:HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_2
¶str
Require or forbid trait HW_GPU_CUDA_COMPUTE_CAPABILITY_V7_2.
trait{group}:HW_GPU_CUDA_SDK_V6_5
¶str
Require or forbid trait HW_GPU_CUDA_SDK_V6_5.
trait{group}:HW_GPU_CUDA_SDK_V7_5
¶str
Require or forbid trait HW_GPU_CUDA_SDK_V7_5.
trait{group}:HW_GPU_CUDA_SDK_V8_0
¶str
Require or forbid trait HW_GPU_CUDA_SDK_V8_0.
trait{group}:HW_GPU_CUDA_SDK_V9_0
¶str
Require or forbid trait HW_GPU_CUDA_SDK_V9_0.
trait{group}:HW_GPU_CUDA_SDK_V9_1
¶str
Require or forbid trait HW_GPU_CUDA_SDK_V9_1.
trait{group}:HW_GPU_CUDA_SDK_V9_2
¶str
Require or forbid trait HW_GPU_CUDA_SDK_V9_2.
trait{group}:HW_GPU_CUDA_SDK_V10_0
¶str
Require or forbid trait HW_GPU_CUDA_SDK_V10_0.
trait{group}:HW_GPU_MAX_DISPLAY_HEADS_1
¶str
Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_1.
trait{group}:HW_GPU_MAX_DISPLAY_HEADS_2
¶str
Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_2.
trait{group}:HW_GPU_MAX_DISPLAY_HEADS_4
¶str
Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_4.
trait{group}:HW_GPU_MAX_DISPLAY_HEADS_6
¶str
Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_6.
trait{group}:HW_GPU_MAX_DISPLAY_HEADS_8
¶str
Require or forbid trait HW_GPU_MAX_DISPLAY_HEADS_8.
trait{group}:HW_GPU_RESOLUTION_W320H240
¶str
Require or forbid trait HW_GPU_RESOLUTION_W320H240.
trait{group}:HW_GPU_RESOLUTION_W640H480
¶str
Require or forbid trait HW_GPU_RESOLUTION_W640H480.
trait{group}:HW_GPU_RESOLUTION_W800H600
¶str
Require or forbid trait HW_GPU_RESOLUTION_W800H600.
trait{group}:HW_GPU_RESOLUTION_W1024H600
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1024H600.
trait{group}:HW_GPU_RESOLUTION_W1024H768
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1024H768.
trait{group}:HW_GPU_RESOLUTION_W1152H864
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1152H864.
trait{group}:HW_GPU_RESOLUTION_W1280H720
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1280H720.
trait{group}:HW_GPU_RESOLUTION_W1280H768
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1280H768.
trait{group}:HW_GPU_RESOLUTION_W1280H800
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1280H800.
trait{group}:HW_GPU_RESOLUTION_W1280H1024
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1280H1024.
trait{group}:HW_GPU_RESOLUTION_W1360H768
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1360H768.
trait{group}:HW_GPU_RESOLUTION_W1366H768
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1366H768.
trait{group}:HW_GPU_RESOLUTION_W1440H900
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1440H900.
trait{group}:HW_GPU_RESOLUTION_W1600H900
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1600H900.
trait{group}:HW_GPU_RESOLUTION_W1600H1200
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1600H1200.
trait{group}:HW_GPU_RESOLUTION_W1680H1050
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1680H1050.
trait{group}:HW_GPU_RESOLUTION_W1920H1080
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1920H1080.
trait{group}:HW_GPU_RESOLUTION_W1920H1200
¶str
Require or forbid trait HW_GPU_RESOLUTION_W1920H1200.
trait{group}:HW_GPU_RESOLUTION_W2560H1440
¶str
Require or forbid trait HW_GPU_RESOLUTION_W2560H1440.
trait{group}:HW_GPU_RESOLUTION_W2560H1600
¶str
Require or forbid trait HW_GPU_RESOLUTION_W2560H1600.
trait{group}:HW_GPU_RESOLUTION_W3840H2160
¶str
Require or forbid trait HW_GPU_RESOLUTION_W3840H2160.
trait{group}:HW_GPU_RESOLUTION_W7680H4320
¶str
Require or forbid trait HW_GPU_RESOLUTION_W7680H4320.
trait{group}:HW_NIC_SRIOV
¶str
Require or forbid trait HW_NIC_SRIOV.
trait{group}:HW_NIC_MULTIQUEUE
¶str
Require or forbid trait HW_NIC_MULTIQUEUE.
trait{group}:HW_NIC_VMDQ
¶str
Require or forbid trait HW_NIC_VMDQ.
trait{group}:HW_NIC_PROGRAMMABLE_PIPELINE
¶str
Require or forbid trait HW_NIC_PROGRAMMABLE_PIPELINE.
trait{group}:HW_NIC_ACCEL_SSL
¶str
Require or forbid trait HW_NIC_ACCEL_SSL.
trait{group}:HW_NIC_ACCEL_IPSEC
¶str
Require or forbid trait HW_NIC_ACCEL_IPSEC.
trait{group}:HW_NIC_ACCEL_TLS
¶str
Require or forbid trait HW_NIC_ACCEL_TLS.
trait{group}:HW_NIC_ACCEL_DIFFIEH
¶str
Require or forbid trait HW_NIC_ACCEL_DIFFIEH.
trait{group}:HW_NIC_ACCEL_RSA
¶str
Require or forbid trait HW_NIC_ACCEL_RSA.
trait{group}:HW_NIC_ACCEL_ECC
¶str
Require or forbid trait HW_NIC_ACCEL_ECC.
trait{group}:HW_NIC_ACCEL_LZS
¶str
Require or forbid trait HW_NIC_ACCEL_LZS.
trait{group}:HW_NIC_ACCEL_DEFLATE
¶str
Require or forbid trait HW_NIC_ACCEL_DEFLATE.
trait{group}:HW_NIC_DCB_PFC
¶str
Require or forbid trait HW_NIC_DCB_PFC.
trait{group}:HW_NIC_DCB_ETS
¶str
Require or forbid trait HW_NIC_DCB_ETS.
trait{group}:HW_NIC_DCB_QCN
¶str
Require or forbid trait HW_NIC_DCB_QCN.
trait{group}:HW_NIC_OFFLOAD_TSO
¶str
Require or forbid trait HW_NIC_OFFLOAD_TSO.
trait{group}:HW_NIC_OFFLOAD_GRO
¶str
Require or forbid trait HW_NIC_OFFLOAD_GRO.
trait{group}:HW_NIC_OFFLOAD_GSO
¶str
Require or forbid trait HW_NIC_OFFLOAD_GSO.
trait{group}:HW_NIC_OFFLOAD_UFO
¶str
Require or forbid trait HW_NIC_OFFLOAD_UFO.
trait{group}:HW_NIC_OFFLOAD_LRO
¶str
Require or forbid trait HW_NIC_OFFLOAD_LRO.
trait{group}:HW_NIC_OFFLOAD_LSO
¶str
Require or forbid trait HW_NIC_OFFLOAD_LSO.
trait{group}:HW_NIC_OFFLOAD_TCS
¶str
Require or forbid trait HW_NIC_OFFLOAD_TCS.
trait{group}:HW_NIC_OFFLOAD_UCS
¶str
Require or forbid trait HW_NIC_OFFLOAD_UCS.
trait{group}:HW_NIC_OFFLOAD_SCS
¶str
Require or forbid trait HW_NIC_OFFLOAD_SCS.
trait{group}:HW_NIC_OFFLOAD_L2CRC
¶str
Require or forbid trait HW_NIC_OFFLOAD_L2CRC.
trait{group}:HW_NIC_OFFLOAD_FDF
¶str
Require or forbid trait HW_NIC_OFFLOAD_FDF.
trait{group}:HW_NIC_OFFLOAD_RXVLAN
¶str
Require or forbid trait HW_NIC_OFFLOAD_RXVLAN.
trait{group}:HW_NIC_OFFLOAD_TXVLAN
¶str
Require or forbid trait HW_NIC_OFFLOAD_TXVLAN.
trait{group}:HW_NIC_OFFLOAD_VXLAN
¶str
Require or forbid trait HW_NIC_OFFLOAD_VXLAN.
trait{group}:HW_NIC_OFFLOAD_GRE
¶str
Require or forbid trait HW_NIC_OFFLOAD_GRE.
trait{group}:HW_NIC_OFFLOAD_GENEVE
¶str
Require or forbid trait HW_NIC_OFFLOAD_GENEVE.
trait{group}:HW_NIC_OFFLOAD_TXUDP
¶str
Require or forbid trait HW_NIC_OFFLOAD_TXUDP.
trait{group}:HW_NIC_OFFLOAD_QINQ
¶str
Require or forbid trait HW_NIC_OFFLOAD_QINQ.
trait{group}:HW_NIC_OFFLOAD_RDMA
¶str
Require or forbid trait HW_NIC_OFFLOAD_RDMA.
trait{group}:HW_NIC_OFFLOAD_RXHASH
¶str
Require or forbid trait HW_NIC_OFFLOAD_RXHASH.
trait{group}:HW_NIC_OFFLOAD_RX
¶str
Require or forbid trait HW_NIC_OFFLOAD_RX.
trait{group}:HW_NIC_OFFLOAD_TX
¶str
Require or forbid trait HW_NIC_OFFLOAD_TX.
trait{group}:HW_NIC_OFFLOAD_SG
¶str
Require or forbid trait HW_NIC_OFFLOAD_SG.
trait{group}:HW_NIC_OFFLOAD_SWITCHDEV
¶str
Require or forbid trait HW_NIC_OFFLOAD_SWITCHDEV.
trait{group}:HW_NIC_SRIOV_QOS_TX
¶str
Require or forbid trait HW_NIC_SRIOV_QOS_TX.
trait{group}:HW_NIC_SRIOV_QOS_RX
¶str
Require or forbid trait HW_NIC_SRIOV_QOS_RX.
trait{group}:HW_NIC_SRIOV_MULTIQUEUE
¶str
Require or forbid trait HW_NIC_SRIOV_MULTIQUEUE.
trait{group}:HW_NIC_SRIOV_TRUSTED
¶str
Require or forbid trait HW_NIC_SRIOV_TRUSTED.
trait{group}:HW_NUMA_ROOT
¶str
Require or forbid trait HW_NUMA_ROOT.
trait{group}:MISC_SHARES_VIA_AGGREGATE
¶str
Require or forbid trait MISC_SHARES_VIA_AGGREGATE.
trait{group}:STORAGE_DISK_HDD
¶str
Require or forbid trait STORAGE_DISK_HDD.
trait{group}:STORAGE_DISK_SSD
¶str
Require or forbid trait STORAGE_DISK_SSD.
trait{group}:CUSTOM_{trait}
¶str
Require or forbid trait CUSTOM_{trait}.
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}
¶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
¶str
Specify that the ‘id’ capability provided by the host compute service
satisfy the provided filter value. Requires the ComputeCapabilitiesFilter
scheduler filter.
capabilities:uuid
¶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
¶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
¶str
Specify that the ‘host’ capability provided by the host compute service
satisfy the provided filter value. Requires the ComputeCapabilitiesFilter
scheduler filter.
capabilities:vcpus
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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
¶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}
¶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}
¶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}
¶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}
¶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}
¶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}
¶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}
¶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}
¶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}
¶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}
¶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}
¶str
Specify that the ‘instances’ capability provided by the host compute service
satisfy the provided filter value. Requires the ComputeCapabilitiesFilter
scheduler filter.
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.
They are only supported by the libvirt virt driver.
quota:cpu_limit
¶int
The limit for cpu. Only supported by the VMWare virt driver.
quota:cpu_reservation
¶int
The reservation for cpu. Only supported by the VMWare virt driver.
str
The shares level for cpu. Only supported by the VMWare virt driver.
int
The shares share for cpu. Only supported by the VMWare virt driver.
quota:memory_limit
¶int
The limit for memory. Only supported by the VMWare virt driver.
quota:memory_reservation
¶int
The reservation for memory. Only supported by the VMWare virt driver.
str
The shares level for memory. Only supported by the VMWare virt driver.
int
The shares share for memory. Only supported by the VMWare virt driver.
quota:disk_io_limit
¶int
The limit for disk_io. Only supported by the VMWare virt driver.
quota:disk_io_reservation
¶int
The reservation for disk_io. Only supported by the VMWare virt driver.
str
The shares level for disk_io. Only supported by the VMWare virt driver.
int
The shares share for disk_io. Only supported by the VMWare virt driver.
quota:vif_limit
¶int
The limit for vif. Only supported by the VMWare virt driver.
quota:vif_reservation
¶int
The reservation for vif. Only supported by the VMWare virt driver.
str
The shares level for vif. Only supported by the VMWare virt driver.
int
The shares share for vif. Only supported by the VMWare virt driver.
int
0
The quota shares for CPU. Only supported by the libvirt virt driver.
quota:cpu_period
¶int
0
The quota period for CPU. Only supported by the libvirt virt driver.
quota:cpu_quota
¶int
0
The quota quota for CPU. Only supported by the libvirt virt driver.
quota:disk_read_bytes_sec
¶int
0
The quota read bytes for disk. Only supported by the libvirt virt driver.
quota:disk_read_iops_sec
¶int
0
The quota read iops for disk. Only supported by the libvirt virt driver.
quota:disk_write_bytes_sec
¶int
0
The quota write bytes for disk. Only supported by the libvirt virt driver.
quota:disk_write_iops_sec
¶int
0
The quota write iops for disk. Only supported by the libvirt virt driver.
quota:disk_total_bytes_sec
¶int
0
The quota total bytes for disk. Only supported by the libvirt virt driver.
quota:disk_total_iops_sec
¶int
0
The quota total iops for disk. Only supported by the libvirt virt driver.
quota:vif_inbound_average
¶int
0
The quota inbound average for VIF. Only supported by the libvirt virt driver.
quota:vif_inbound_peak
¶int
0
The quota inbound peak for VIF. Only supported by the libvirt virt driver.
quota:vif_inbound_burst
¶int
0
The quota inbound burst for VIF. Only supported by the libvirt virt driver.
quota:vif_outbound_average
¶int
0
The quota outbound average for VIF. Only supported by the libvirt virt driver.
quota:vif_outbound_peak
¶int
0
The quota outbound peak for VIF. Only supported by the libvirt virt driver.
quota:vif_outbound_burst
¶int
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
¶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
¶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
¶bool
Determine whether realtime mode should be enabled for the instance or not. Only supported by the libvirt driver.
hw:cpu_realtime_mask
¶str
A exclusion mask of CPUs that should not be enabled for realtime.
hw:cpu_policy
¶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.
hw:cpu_thread_policy
¶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
¶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:mem_page_size
¶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
¶int
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}
¶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}
¶int
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
¶str
The NUMA affinity policy of any PCI passthrough devices or SR-IOV network interfaces attached to the instance.
hw:cpu_sockets
¶int
1
The number of virtual CPU threads to emulate in the guest CPU topology.
hw:cpu_cores
¶int
1
The number of virtual CPU cores to emulate per socket in the guest CPU topology.
hw:cpu_threads
¶int
1
The number of virtual CPU threads to emulate per core in the guest CPU topology.
hw:max_cpu_sockets
¶int
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
¶int
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
¶int
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.
bool
Whether to show a boot menu when booting the guest.
hw:mem_encryption
¶bool
Whether to enable memory encryption for the guest. Only supported by the libvirt driver on hosts with AMD SEV support.
hw:pmem
¶str
A comma-separated list of $LABEL
s defined in config for vPMEM devices.
hw:pmu
¶bool
Whether to enable the Performance Monitory Unit (PMU) for the guest. Only supported by the libvirt driver.
hw:serial_port_count
¶int
0
The number of serial ports to allocate to the guest. Only supported by the libvirt virt driver.
hw:watchdog_action
¶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
¶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
¶int
0
The allowed amount of bytes for the guest to read from the host’s entropy per period.
hw_rng:rate_period
¶int
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
¶int
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
¶str
Determine whether secure boot is enabled or not. Currently only supported by the HyperV driver.
os:resolution
¶str
Guest VM screen resolution size. Only supported by the HyperV driver.
os:monitors
¶int
1
8
Guest VM number of monitors. Only supported by the HyperV driver.
os:vram
¶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
¶int
256
Minimum memory (MB). If you do not specify the value, the value is defaulted to the value for memory_mb
.
powervm:max_mem
¶int
256
Maximum memory (MB). If you do not specify the value, the value is defaulted to the value for memory_mb
.
powervm:min_vcpu
¶int
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
¶int
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
¶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
¶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
¶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
¶bool
Use dedicated processors. The attribute defaults to false.
int
0
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
¶int
0
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
¶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
¶str
Sharing mode for dedicated processors. The attribute is supported only when powervm:dedicated_proc
is set to true.
powervm:processor_compatibility
¶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.
str
Specifies the shared processor pool to be targeted during deployment of a virtual machine.
powervm:srr_capability
¶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
¶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
¶str
Specify the storage policy used for new instances. If Storage Policy-Based Management (SPBM) is not enabled, this parameter is ignored.
The following extra specs are not part of a group.
hide_hypervisor_id
¶bool
Determine whether the hypervisor ID should be hidden from the guest. Only supported by the libvirt driver.
group_policy
¶str
The group policy to apply when using the granular resource request syntax.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.