@@ -414,53 +414,69 @@ ImagePropertiesFilter
414
414
Filters hosts based on properties defined on the instance's image. It passes
415
415
hosts that can support the specified image properties contained in the
416
416
instance. Properties include the architecture, hypervisor type, hypervisor
417
- version (for Xen hypervisor type only) , and virtual machine mode.
417
+ version, and virtual machine mode.
418
418
419
419
For example, an instance might require a host that runs an ARM-based processor,
420
420
and QEMU as the hypervisor. You can decorate an image with these properties by
421
421
using:
422
422
423
423
.. code-block :: console
424
424
425
- $ openstack image set --architecture arm --property hypervisor_type =qemu \
425
+ $ openstack image set --architecture arm --property img_hv_type =qemu \
426
426
img-uuid
427
427
428
428
The image properties that the filter checks for are:
429
429
430
- ``architecture ``
431
- describes the machine architecture required by the image. Examples are
430
+ ``hw_architecture ``
431
+ Describes the machine architecture required by the image. Examples are
432
432
``i686 ``, ``x86_64 ``, ``arm ``, and ``ppc64 ``.
433
433
434
- ``hypervisor_type ``
435
- describes the hypervisor required by the image. Examples are ``xen ``,
436
- ``qemu ``, and ``xenapi ``.
434
+ .. versionchanged :: 12.0.0 (Liberty)
435
+
436
+ This was previously called ``architecture ``.
437
+
438
+ ``img_hv_type ``
439
+ Describes the hypervisor required by the image. Examples are ``qemu ``,
440
+ ``xenapi ``, and ``hyperv ``.
437
441
438
442
.. note ::
439
443
440
444
``qemu `` is used for both QEMU and KVM hypervisor types.
441
445
442
- ``hypervisor_version_requires ``
443
- describes the hypervisor version required by the image. The property is
444
- supported for Xen hypervisor type only. It can be used to enable support for
445
- multiple hypervisor versions, and to prevent instances with newer Xen tools
446
+ .. versionchanged :: 12.0.0 (Liberty)
447
+
448
+ This was previously called ``hypervisor_type ``.
449
+
450
+ ``img_hv_requested_version ``
451
+ Describes the hypervisor version required by the image. The property is
452
+ supported for HyperV hypervisor type only. It can be used to enable support for
453
+ multiple hypervisor versions, and to prevent instances with newer HyperV tools
446
454
from being provisioned on an older version of a hypervisor. If available, the
447
455
property value is compared to the hypervisor version of the compute host.
448
456
449
457
To filter the hosts by the hypervisor version, add the
450
- ``hypervisor_version_requires `` property on the image as metadata and pass an
458
+ ``img_hv_requested_version `` property on the image as metadata and pass an
451
459
operator and a required hypervisor version as its value:
452
460
453
461
.. code-block :: console
454
462
455
- $ openstack image set --property hypervisor_type=xen --property \
456
- hypervisor_version_requires=">=4.3 " img-uuid
463
+ $ openstack image set --property hypervisor_type=hyperv --property \
464
+ hypervisor_version_requires=">=6000 " img-uuid
457
465
458
- ``vm_mode ``
466
+ .. versionchanged :: 12.0.0 (Liberty)
467
+
468
+ This was previously called ``hypervisor_version_requires ``.
469
+
470
+ ``hw_vm_mode ``
459
471
describes the hypervisor application binary interface (ABI) required by the
460
472
image. Examples are ``xen `` for Xen 3.0 paravirtual ABI, ``hvm `` for native
461
473
ABI, ``uml `` for User Mode Linux paravirtual ABI, ``exe `` for container virt
462
474
executable ABI.
463
475
476
+ .. versionchanged :: 12.0.0 (Liberty)
477
+
478
+ This was previously called ``vm_mode ``.
479
+
464
480
IsolatedHostsFilter
465
481
-------------------
466
482
0 commit comments