nova/api-guide/source/extra_specs_and_properties.rst
Matt Riedemann ee41dc9ff9 api-guide: flesh out flavor extra specs and image properties
This adds high level details and links to more detailed docs
in both nova and glance.

This also un-hides the document so it shows up in the table of
contents on the main page. Previously it was being linked from
the general info page and some typos in there are fixed as well.

Change-Id: I495b9ae7855d36cb2597272bcae7ec00360bbed4
2019-11-25 09:19:24 -05:00

1.8 KiB

Flavor Extra Specs and Image Properties

Flavor extra specs and image properties are used to control certain aspects or scheduling behavior for a server.

The flavor of a server can be changed during a resize </user/resize> operation.

The image of a server can be changed during a rebuild </contributor/evacuate-vs-rebuild> operation.

By default, flavor extra specs are controlled by administrators of the cloud. If users are authorized to upload their own images to the image service, they may be able to specify their own image property requirements.

There are many cases of flavor extra specs and image properties that are for the same functionality. In many cases the image property takes precedence over the flavor extra spec if both are used in the same server.

Flavor Extra Specs

Refer to the user guide </user/flavors.html#extra-specs> for a list of official extra specs.

While there are standard extra specs, deployments can define their own extra specs to be used with host aggregates and custom scheduler filters as necessary. See the reference guide </reference/scheduler-hints-vs-flavor-extra-specs> for more details.

Image Properties

Refer to the image service documentation for a list of official image properties </admin/useful-image-properties> and metadata definition concepts </user/metadefs-concepts>.

Unlike flavor extra specs, image properties are standardized in the compute service and thus they must be registered within the compute service before they can be used.