openstack.cloud.compute_flavor_info – Получение информации об одном или нескольких флейворах

Примечание

Этот плагин входит в коллекцию openstack.cloud (версия 1.2.1).

Для его установки используйте: ansible-galaxy collection install openstack.cloud.

Для использования в книге задач укажите: openstack.cloud.compute_flavor_info.

Описание
Требования
Параметры
Примечания
Примеры
Значения возврата

Описание

Получение информации о доступных флейворах экземпляров OpenStack. По умолчанию информация о ВСЕХ флейворах извлекается. Можно применить фильтры, чтобы получить информацию только о соответствующих флейворах. Например, можно отфильтровать по объему доступной оперативной памяти флейвора или количеству виртуальных процессоров, или по обоим параметрам. При указании нескольких фильтров все фильтры должны соответствовать флейвору, прежде чем этот флейвор будет возвращён в качестве факта.
Этот модуль назывался openstack.cloud.compute_flavor_facts до Ansible 2.9, возвращая ansible_facts. Обратите внимание, что модуль openstack.cloud.compute_flavor_info больше не возвращает ansible_facts!

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

openstacksdk
openstacksdk >= 0.12.0
python >= 3.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_timeout целое число		Сколько времени должен ждать уровень сокета, прежде чем истечёт время ожидания для вызовов API. Если это опущено, ничего не будет передано в библиотеку запросов.
auth словарь		Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля авторизации облака. Для подключаемого модуля по умолчанию password, он будет содержать auth_url, username, password, project_name и любую информацию о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других подключаемых модулей этот параметр должен содержать параметры, необходимые этому подключаемому модулю авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные среды OpenStack OS_*.
auth_type строка		Имя подключаемого модуля авторизации для использования. Если облако использует что-то кроме парольной аутентификации, здесь должно быть указано имя подключаемого модуля, и содержимое параметра auth должно быть соответствующим образом обновлено.
availability_zone строка		Игнорируется. Присутствует для обратной совместимости
ca_cert строка		Путь к пакету CA-сертификатов, который можно использовать для проверки запросов API SSL. псевдонимы: cacert
client_cert строка		Путь к клиенту сертификату для использования в рамках транзакции SSL. псевдонимы: cert
client_key строка		Путь к ключу клиента для использования в рамках транзакции SSL. псевдонимы: key
cloud сырой		Именованное облако или конфигурация облака для работы. Если cloud — строка, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан параметр auth или присутствуют переменные среды OpenStack OS_. Если cloud* — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml.
ephemeral строка		Строка, используемая для фильтрации флейворов на основе количества временного хранилища. Формат такой же, как параметр ram
interface строка	Варианты: admin internal public ←	Тип URL конечной точки для извлечения из каталога сервиса. псевдонимы: endpoint_type
limit целое число		Ограничивает количество возвращаемых флейворов. По умолчанию возвращаются все соответствующие флейворы.
name строка		Имя флейвора. Не может использоваться с ram или vcpus или ephemeral.
ram строка		Строка, используемая для фильтрации флейворов на основе объёма ОЗУ (в МБ). Эта строка принимает следующие специальные значения: 'MIN' (возвращает флейворы с минимальным объёмом ОЗУ), и 'MAX' (возвращает флейворы с максимальным объёмом ОЗУ). Также можно указать конкретный объём ОЗУ. Будут возвращены все флейворы с этим точным объёмом ОЗУ. Можно указать диапазон допустимого объёма ОЗУ, используя специальный синтаксис. Просто добавьте одно из следующих значений диапазона перед объёмом ОЗУ: '<', '>', '<=', '>= Наи. Эти значения представляют меньше чем, больше чем, меньше или равно, и больше или равно, соответственно.
region_name строка		Имя региона.
timeout целое число	По умолчанию: 180	Сколько времени Ansible должен ждать запрашиваемый ресурс.
validate_certs логическое значение	Варианты: нет ← да	Нужно ли проверять запросы API SSL. До Ansible 2.3 значение по умолчанию было `yes`. псевдонимы: verify
vcpus строка		Строка, используемая для фильтрации флейворов на основе количества виртуальных процессоров. Формат аналогичен параметру ram.
wait логическое значение	Варианты: нет да ←	Ansible должен ждать завершения запрошенного ресурса?

Примечания

Примечание

Результат содержит список несортированных флейворов.
Можно использовать стандартные переменные среды OpenStack, такие как OS_USERNAME, вместо явного указания значений.
Информация об аутентификации управляется openstacksdk, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, и, наконец, из явных параметров в задачах. Дополнительную информацию можно найти по адресу https://docs.openstack.org/openstacksdk/

Примеры

# Gather information about all available flavors
- openstack.cloud.compute_flavor_info:
    cloud: mycloud
  register: result

- debug:
    msg: "{{ result.openstack_flavors }}"

# Gather information for the flavor named "xlarge-flavor"
- openstack.cloud.compute_flavor_info:
    cloud: mycloud
    name: "xlarge-flavor"

# Get all flavors that have exactly 512 MB of RAM.
- openstack.cloud.compute_flavor_info:
    cloud: mycloud
    ram: "512"

# Get all flavors that have 1024 MB or more of RAM.
- openstack.cloud.compute_flavor_info:
    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.
- openstack.cloud.compute_flavor_info:
    cloud: mycloud
    ram: "MIN"
    limit: 1

# Get all flavors with 1024 MB of RAM or more, AND exactly 2 virtual CPUs.
- openstack.cloud.compute_flavor_info:
    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.
- openstack.cloud.compute_flavor_info:
    cloud: mycloud
    ram: ">=1024"
    vcpus: "2"
    ephemeral: "<30"

Значения возврата

Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:

Ключ		Возвращаемое значение	Описание
openstack_flavors сложный		При успехе.	Словарь, описывающий флейворы.
	disk целое число	успех	Размер локального диска в ГБ. Пример: 10
	ephemeral целое число	успех	Размер временного хранилища в ГБ. Пример: 10
	id строка	успех	Идентификатор флейвора. Пример: 515256b8-7027-4d73-aa54-4e30a4a4a339
	is_public логическое значение	успех	Доступность флейвора для публичного использования. Пример: True
	name строка	успех	Имя флейвора. Пример: tiny
	ram целое число	успех	Объем оперативной памяти в МБ. Пример: 1024
	swap целое число	успех	Размер подкачки в МБ. Пример: 100
	vcpus целое число	успех	Количество виртуальных процессоров. Пример: 2

Авторы

OpenStack Ansible SIG

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/openstack/cloud/compute_flavor_info_module.html