9.3. 类别元数据

quota:cpu_shares

指定域的 CPU 时间的比例加权共享。默认为提供的默认值。计算调度程序相对于同一域中其他实例上的此属性设置的值。例如，使用 quota:cpu_shares=2048 配置的实例被分配为使用 quota:cpu_shares=1024 配置的实例加倍。

quota:cpu_period

指定以微秒为单位强制 cpu_quota 的时间周期。在 cpu_period 中，每个 vCPU 无法消耗超过运行时的 cpu_quota。设置为范围 1000 - 1000000 中的值。设置为 0 以禁用。

quota:cpu_quota

指定每个 cpu_period 中 vCPU 允许的最大带宽，以微秒为单位：

您可以使用 cpu_quota 和 cpu_period 来确保所有 vCPU 都以相同的速度运行。例如，您可以使用以下类别来启动最多 50% 物理 CPU 能力的实例：

$ openstack flavor set cpu_limits_flavor \
  --property quota:cpu_quota=10000 \
  --property quota:cpu_period=20000

quota:disk_read_bytes_sec

指定实例可使用的最大磁盘读取，以每秒为单位。

quota:disk_read_iops_sec

指定 IOPS 中可供实例使用的最大磁盘读取。

quota:disk_write_bytes_sec

指定实例可使用的最大磁盘写入，以每秒为单位。

quota:disk_write_iops_sec

指定 IOPS 中可供实例使用的最大磁盘写入。

quota:disk_total_bytes_sec

指定可供实例使用的最大 I/O 操作，以字节为单位。

quota:disk_total_iops_sec

指定可供实例使用的最大 I/O 操作（以 IOPS 为单位）。

quota:vif_inbound_average

（已弃用）指定进入实例的流量所需的平均位率（单位为 kbps）。

quota:vif_inbound_burst

（已弃用）指定以 KB 为单位的峰值速度的最大传入流量量。

quota:vif_inbound_peak

（已弃用）指定实例可以接收传入流量的最大速率，以 kbps 为单位。

quota:vif_outbound_average

（已弃用）指定从实例传出的流量所需的平均位率（单位为 kbps）。

quota:vif_outbound_burst

（已弃用）指定可在峰值速度(KB)中突发的最大传出流量。

quota:vif_outbound_peak

（已弃用）指定实例可以发送传出流量（以 kbps 为单位）的最大速率。

hw_video:ram_max_mb

指定用于视频设备的最大 RAM，以 MB 为单位。与 hw_video_ram 镜像属性一起使用。hw_video_ram 必须小于或等于 hw_video:ram_max_mb。

hw:watchdog_action

指定启用虚拟硬件 watchdog 设备并设置其行为。如果实例挂起或失败，则 watchdog 设备执行配置的操作。watchdog 使用 i6300esb 设备，模拟 PCI Intel 6300ESB。如果没有指定 hw:watchdog_action，则禁用 watchdog。

设置为以下有效值之一：

hw_rng:allowed

设置为 False，以禁用通过其镜像属性添加到实例的 RNG 设备。

Default: True

hw_rng:rate_bytes

指定实例可以从主机熵中读取的最大字节数。

hw_rng:rate_period

以毫秒为单位指定读取周期的持续时间。

hw:pmu

设置为 True，为实例启用 vPMU。

perf 等工具使用实例上的 vPMU 来更准确地分析和监控实例性能。对于实时工作负载，vPMU 的模拟可能会带来额外的延迟，这些延迟可能并不正常。如果不需要提供的遥测，请设置 hw:pmu=False。

hw:cpu_sockets

指定实例的首选插槽数。

默认：请求的 vCPU 数量

hw:cpu_cores

指定实例的每个插槽的首选内核数。

默认： 1

hw:cpu_threads

指定实例每个内核的首选线程数量。

默认： 1

hw:cpu_max_sockets

使用镜像属性指定用户可以为其实例选择的最大插槽数。

示例： hw:cpu_max_sockets=2

hw:cpu_max_cores

指定用户可以使用镜像属性为每个插槽选择的最大内核数。

hw:cpu_max_threads

指定每个内核可使用镜像属性为实例选择的最大线程数。

hw:serial_port_count

每个实例的最大串行端口。

hw:cpu_policy

指定要使用的 CPU 策略。设置为以下有效值之一：

hw:cpu_thread_policy

指定在 hw:cpu_policy=dedicated 时使用的 CPU 线程策略。设置为以下有效值之一：

hw:pci_numa_affinity_policy

指定 PCI 透传设备和 SR-IOV 接口的 NUMA 关联性策略。设置为以下有效值之一：

hw:numa_nodes

指定将实例 vCPU 线程的执行限制为的主机 NUMA 节点数量。如果没有指定，vCPU 线程可以在任意数量的可用主机 NUMA 节点上运行。

hw:numa_cpus.N

映射到实例 NUMA 节点 N 的实例 vCPU 列表。如果没有指定此密钥，则 vCPU 会平均划分到可用的 NUMA 节点。

N 从 0 开始。请谨慎使用 3.0.N 值，只有在至少有两个 NUMA 节点时才使用。

只有在设置了 hw:numa_nodes 并且只有实例的 NUMA 节点有非对称分配 CPU 和 RAM （对于某些 NFV 工作负载很重要）时才需要此属性有效。

hw:numa_mem.N

映射到实例 NUMA 节点 N 的实例内存数量。如果没有指定这个键，则会在可用的 NUMA 节点之间平均划分内存。

N 从 0 开始。请谨慎使用 3.0.N 值，只有在至少有两个 NUMA 节点时才使用。

只有在设置了 hw:numa_nodes 并且只有实例的 NUMA 节点有非对称分配 CPU 和 RAM （对于某些 NFV 工作负载很重要）时才需要此属性有效。

hw:cpu_realtime

设置为 yes，以创建将实时策略分配给实例 vCPU 的类别。

默认： no

hw:cpu_realtime_mask

指定不为其分配实时策略的 vCPU。您必须使用符号(^)添加掩码值。以下示例显示除 vCPU 0 和 1 外的所有 vCPU 都有实时策略：

$ openstack flavor set <flavor> \
 --property hw:cpu_realtime="yes" \
 --property hw:cpu_realtime_mask=^0-1

hw:emulator_threads_policy

指定用于实例的仿真程序线程策略。设置为以下有效值之一：

hw:mem_page_size

指定用于支持实例的大页大小。使用此选项会创建 1 NUMA 节点的隐式 NUMA 拓扑，除非被 hw:numa_nodes 指定。设置为以下有效值之一：

pci_passthrough:alias

使用以下格式指定要分配给实例的 PCI 设备：

<alias>:<count>

hide_hypervisor_id

设置为 True 以隐藏实例的虚拟机监控程序签名，以允许所有驱动程序在实例上加载和工作。

os:secure_boot

设置为 required，以便为使用此类别启动的实例启用安全引导。默认禁用此选项。

trait:<trait_name>

指定 Compute 节点特征。将 trait 设置为以下有效值之一：

例如：

$ openstack flavor set --property trait:HW_CPU_X86_AVX512BW=required avx512-flavor

resources:<resource_class_name>

使用此属性指定标准裸机资源类来覆盖实例所需的自定义裸机资源类。

您可以覆盖的标准资源类是 VCPU、MEMORY_MB 和 DISK_GB。为防止计算调度程序使用裸机类别属性来调度实例，请将标准资源类的值设为 0。

自定义资源类的名称必须以 CUSTOM_ 开头。要确定与 Bare Metal 服务节点的资源类型对应的自定义资源类的名称，请将资源类转换为大写，请将所有标点替换为下划线，并将 prefix 替换为 CUSTOM_。

例如，要在具有 -resource-class baremetal.SMALL 的节点上调度实例，请创建以下类别：

$ openstack flavor set \
 --property resources:CUSTOM_BAREMETAL_SMALL=1 \
 --property resources:VCPU=0 --property resources:MEMORY_MB=0 \
 --property resources:DISK_GB=0 compute-small