os_flavor_facts — Получение фактов о вкусах одного или нескольких экземпляров
Новое в версии 2.1.
Обзор
- Получение фактов о доступных вкусах экземпляров OpenStack. По умолчанию извлекаются факты обо ВСЕХ вкусах. Фильтры могут быть применены для получения фактов только для соответствующих вкусов. Например, вы можете отфильтровать по объёму доступной оперативной памяти для вкуса или по количеству виртуальных процессоров, доступных для вкуса, или по обоим параметрам. При указании нескольких фильтров все фильтры должны соответствовать вкусу, прежде чем этот вкус будет возвращён как факт.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- openstacksdk
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout | Время ожидания сокета в секундах перед временным ограничением для API-вызовов. Если это значение опущено, ничего не будет передано в библиотеку requests. | |
| auth | Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля авторизации облака. Для стандартного плагина password он должен содержать auth_url, username, password, project_name и любые сведения о доменах, если облако их поддерживает. Для других плагинов этот параметр должен содержать все необходимые параметры плагина авторизации. Этот параметр не требуется, если указано имя облака или присутствуют переменные среды OpenStack OS_*. | |
| auth_type | Имя плагина авторизации для использования. Если облако использует что-то кроме парольной авторизации, здесь следует указать имя плагина, и содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone | Игнорируется. Присутствует для обратной совместимости | |
| cacert | Путь к пакету сертификатов CA, который может использоваться для проверки SSL-API-запросов. | |
| cert | Путь к клиенту сертификат для использования в процессе SSL-транзакции. | |
| cloud | Именованное облако или конфигурация облака для работы. Если cloud — строка, она ссылается на конфигурацию именованного облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не требуется, если задан auth или если присутствуют переменные среды OpenStack OS_*.. Если cloud — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| ephemeral bool (добавлено в 2.3) |
| Строка, используемая для фильтрации вкусов на основе объёма временного хранилища. Формат совпадает с параметром ram |
| interface (добавлено в 2.3) |
| Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type |
| key | Путь к ключу клиента для использования в рамках SSL-транзакции. | |
| limit | Ограничивает количество возвращаемых вкусов. По умолчанию возвращаются все соответствующие вкусы. | |
| name | Имя вкуса. Не может использоваться с ram, vcpus или ephemeral. | |
| ram bool |
| Строка, используемая для фильтрации вкусов на основе объёма ОЗУ (в МБ) желаемого объёма. Эта строка принимает следующие специальные значения: 'MIN' (возвращает вкусы с минимальным объёмом ОЗУ), и 'MAX' (возвращает вкусы с максимальным объёмом ОЗУ). Можно также указать конкретный объём ОЗУ. Будут возвращены все вкусы с этим точным объёмом ОЗУ. Можно указать диапазон допустимых значений ОЗУ с помощью специальной синтаксической конструкции. Просто добавьте одно из этих значений диапазона к значению ОЗУ: '<', '>', '<=', '>= ' . Эти значения обозначают меньше, больше, меньше или равно, и больше или равно соответственно. |
| region_name | Имя региона. | |
| timeout | По умолчанию: 180 | Сколько времени Ansible будет ждать запрашиваемый ресурс. |
| vcpus bool |
| Строка, используемая для фильтрации вкусов на основе количества виртуальных процессоров. Формат совпадает с параметром ram. |
| verify bool |
| Требуется ли проверка SSL-API-запросов. До версии 2.3 это значение по умолчанию было True. псевдонимы: validate_certs |
| wait bool |
| Должен ли Ansible ждать завершения запрошенного ресурса. |
Примечания
Примечание
- Этот модуль создаёт новый факт верхнего уровня
openstack_flavors, который содержит список несортированных вкусов. - Можно использовать стандартные переменные среды OpenStack, такие как
OS_USERNAME, вместо явного указания значений. - Информация об авторизации управляется os-client-config, что означает, что значения могут быть взяты из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, и, наконец, из явных параметров в задачах. Более подробную информацию можно найти по адресу http://docs.openstack.org/developer/os-client-config
Примеры
# Gather facts about all available flavors
- os_flavor_facts:
cloud: mycloud
# Gather facts for the flavor named "xlarge-flavor"
- os_flavor_facts:
cloud: mycloud
name: "xlarge-flavor"
# Get all flavors that have exactly 512 MB of RAM.
- os_flavor_facts:
cloud: mycloud
ram: "512"
# Get all flavors that have 1024 MB or more of RAM.
- os_flavor_facts:
cloud: mycloud
ram: ">=1024"
# Get a single flavor that has the minimum amount of RAM. Using the 'limit'
# option will guarantee only a single flavor is returned.
- os_flavor_facts:
cloud: mycloud
ram: "MIN"
limit: 1
# Get all flavors with 1024 MB of RAM or more, AND exactly 2 virtual CPUs.
- os_flavor_facts:
cloud: mycloud
ram: ">=1024"
vcpus: "2"
# Get all flavors with 1024 MB of RAM or more, exactly 2 virtual CPUs, and
# less than 30gb of ephemeral storage.
- os_flavor_facts:
cloud: mycloud
ram: ">=1024"
vcpus: "2"
ephemeral: "<30"
Возвращаемые значения
Общие возвращаемые значения описаны в этом месте, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| openstack_flavors сложный | При успехе. | Словарь, описывающий параметры виртуальных машин. | |
| id строка | успех | Идентификатор виртуальной машины. Пример: 515256b8-7027-4d73-aa54-4e30a4a4a339 | |
| name строка | успех | Название виртуальной машины. Пример: tiny | |
| disk целое число | успех | Размер локального диска в ГБ. Пример: 10 | |
| ephemeral целое число | успех | Размер временного пространства в ГБ. Пример: 10 | |
| ram целое число | успех | Объем памяти в МБ. Пример: 1024 | |
| swap целое число | успех | Размер пространства подкачки в МБ. Пример: 100 | |
| vcpus целое число | успех | Количество виртуальных процессоров. Пример: 2 | |
| is_public булево | успех | Сделать виртуальную машину доступной для всех. Пример: True | |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратной совместимости интерфейса.
Техническое обслуживание
Этот модуль помечен как общественный, что означает, что он поддерживается сообществом Ansible. См. Поддержка и обслуживание модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- David Shrewsbury (@Shrews)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/os_flavor_facts_module.html
