Spec-Zone.ru › Ansible

Модуль openstack.cloud.compute_flavor_info — получение типов виртуальных машин из облака OpenStack

Примечание

Этот модуль входит в коллекцию openstack.cloud (версия 2.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install openstack.cloud. Для работы с этим модулем требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: openstack.cloud.compute_flavor_info.

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Получение типов виртуальных машин OpenStack.

Требования

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

  • python >= 3.6
  • openstacksdk >= 1.0.0

Параметры

Параметр

Комментарии

api_timeout

integer

Время ожидания сокетного уровня перед истечением срока ожидания вызовов API. Если параметр не указан, библиотеке requests не передаётся никакое значение.

auth

dictionary

Словарь с данными аутентификации, необходимыми для используемой облаком стратегии плагина аутентификации. Для стандартного плагина password здесь должны быть указаны auth_url, username, password, project_name и сведения о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов параметр должен содержать необходимые им данные. Этот параметр не требуется, если указано именованное облако или заданы переменные окружения OpenStack OS_*.

auth_type

string

Имя используемого плагина аутентификации. Если облако использует не парольную аутентификацию, укажите здесь имя плагина и соответствующим образом измените содержимое параметра auth.

ca_cert

псевдонимы: cacert

string

Путь к пакету сертификатов CA, который можно использовать для проверки запросов API SSL.

client_cert

псевдонимы: cert

string

Путь к сертификату клиента, используемому при SSL-соединении.

client_key

псевдонимы: key

string

Путь к ключу клиента, используемому при SSL-соединении.

cloud

any

Именованное облако или конфигурация облака, с которыми нужно работать. Если cloud — строка, она указывает на именованную конфигурацию облака, определённую в файле OpenStack clouds.yaml. Задаёт значения по умолчанию для auth и auth_type. Этот параметр не требуется, если указан auth или заданы переменные окружения OpenStack OS_*. Если cloud — словарь, он содержит полную конфигурацию облака, аналогичную разделу файла clouds.yaml.

ephemeral

string

Фильтровать типы виртуальных машин по объёму эфемерного хранилища.

Для ephemeral поддерживается тот же формат, что и для параметра ram.

interface

псевдонимы: endpoint_type

string

Тип URL конечной точки, используемой для получения данных из каталога служб.

Варианты:

  • "admin"
  • "internal"
  • "public" ← (по умолчанию)

limit

integer

Ограничивает количество типов виртуальных машин числом limit.

По умолчанию возвращаются все подходящие типы виртуальных машин.

name

string

Имя типа виртуальной машины.

ram

string

Строка для фильтрации типов виртуальных машин по требуемому объёму ОЗУ (в МБ). Допустимы специальные значения: ‘MIN’ (вернуть типы виртуальных машин с минимальным объёмом ОЗУ) и ‘MAX’ (вернуть типы виртуальных машин с максимальным объёмом ОЗУ).

Можно также указать конкретный объём ОЗУ. Будут возвращены типы виртуальных машин с точно таким объёмом ОЗУ.

Допустимый диапазон ОЗУ можно задать с помощью специального синтаксиса. Для этого добавьте перед объёмом ОЗУ один из следующих операторов: ‘<’, ‘>’, ‘<=’, ‘>=’. Они означают «меньше», «больше», «меньше или равно» и «больше или равно» соответственно.

region_name

string

Имя региона.

sdk_log_level

string

Уровень журналирования OpenStackSDK

Варианты:

  • "INFO" ← (по умолчанию)
  • "DEBUG"

sdk_log_path

string

Путь к файлу журнала OpenStackSDK. Если значение пустое, журнал не записывается.

timeout

integer

Время ожидания запрошенного ресурса Ansible.

По умолчанию: 180

validate_certs

псевдонимы: verify

boolean

Определяет, нужно ли проверять запросы API SSL.

До Ansible 2.3 значением по умолчанию было true.

Варианты:

  • false
  • true

vcpus

string

Фильтровать типы виртуальных машин по количеству виртуальных процессоров.

Для vcpus поддерживается тот же формат, что и для параметра ram.

wait

boolean

Должен ли Ansible ожидать завершения операции с запрошенным ресурсом.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Gather information about all available flavors
  openstack.cloud.compute_flavor_info:
    cloud: mycloud

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

- name: Get all flavors with 512 MB of RAM
  openstack.cloud.compute_flavor_info:
    cloud: mycloud
    ram: "512"

- name: Get all flavors with >= 1024 MB RAM
  openstack.cloud.compute_flavor_info:
    cloud: mycloud
    ram: ">=1024"

- name: Get a single flavor with minimum amount of RAM
  openstack.cloud.compute_flavor_info:
    cloud: mycloud
    ram: "MIN"
    limit: 1

- name: Get all flavors with >=1024 MB RAM and 2 vCPUs
  openstack.cloud.compute_flavor_info:
    cloud: mycloud
    ram: ">=1024"
    vcpus: "2"

- name: Get flavors with >= 1024 MB RAM 2 vCPUs and < 30gb ephemeral storage
  openstack.cloud.compute_flavor_info:
    cloud: mycloud
    ram: ">=1024"
    vcpus: "2"
    ephemeral: "<30"

Возвращаемые значения

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

Ключ

Описание

flavors

list / элементы=dictionary

Список словарей с описаниями типов виртуальных машин.

Возвращается: всегда

description

string

Описание типа виртуальной машины

Возвращается: при успехе

Пример: "Small flavor"

disk

integer

Размер локального диска в ГБ.

Возвращается: при успехе

Пример: 10

ephemeral

integer

Размер эфемерного пространства в ГБ.

Возвращается: при успехе

Пример: 10

extra_specs

dictionary

Необязательные параметры для настройки различных параметров типа виртуальной машины.

Возвращается: при успехе

Пример: {"hw_rng:allowed": true}

id

string

Идентификатор типа виртуальной машины.

Возвращается: при успехе

Пример: "515256b8-7027-4d73-aa54-4e30a4a4a339"

is_disabled

boolean

Определяет, включён ли тип виртуальной машины.

Возвращается: при успехе

Пример: false

is_public

boolean

Делает тип виртуальной машины общедоступным.

Возвращается: при успехе

Пример: true

name

string

Имя типа виртуальной машины.

Возвращается: при успехе

Пример: "tiny"

original_name

string

Исходное имя типа виртуальной машины

Возвращается: при успехе

Пример: "tiny"

ram

integer

Объём памяти в МБ.

Возвращается: при успехе

Пример: 1024

rxtx_factor

float

Коэффициент, на который умножается свойство rxtx_base подключённой сети для изменения ограничения пропускной способности.

Возвращается: при успехе

Пример: 1.0

swap

integer

Размер пространства подкачки в МБ.

Возвращается: при успехе

Пример: 100

vcpus

integer

Количество виртуальных процессоров.

Возвращается: при успехе

Пример: 2

Авторы

  • Специальная группа OpenStack Ansible

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API