ovirt_networks - Модуль для управления логическими сетями в oVirt/RHV

Новая версия с 2.3.

Обзор
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Значения возврата
Примечания
- Статус

Обзор

Модуль для управления логическими сетями в oVirt/RHV

Требования (к хосту, на котором выполняется модуль)

python >= 2.7
ovirt-engine-sdk-python >= 4.0.0

Параметры

параметр	обязательный	значение по умолчанию	варианты	комментарии
auth	да			Словарь со значениями, необходимыми для создания HTTP/HTTPS-соединения с oVirt: `username`[обязательно] - Имя пользователя, например admin@internal. Значение по умолчанию устанавливается переменной окружения OVIRT_USERNAME. `password`[обязательно] - Пароль пользователя. Значение по умолчанию устанавливается переменной окружения OVIRT_PASSWORD. `url`[обязательно] - Строка, содержащая базовый URL сервера, обычно что-то вроде `https://server.example.com/ovirt-engine/api`. Значение по умолчанию устанавливается переменной окружения OVIRT_URL. `token` - Токен для использования вместо входа с именем пользователя/паролем. Значение по умолчанию устанавливается переменной окружения OVIRT_TOKEN. `insecure` - Флажок булевого типа, указывающий, следует ли проверять сертификат TLS сервера и имя хоста. `ca_file` - Файл PEM, содержащий доверенные сертификаты CA. Представленный сервером сертификат будет проверен с помощью этих сертификатов CA. Если параметр ``ca_file`` не задан, используется системное хранилище сертификатов CA. Значение по умолчанию устанавливается переменной окружения OVIRT_CAFILE. `kerberos` - Флажок булевого типа, указывающий, следует ли использовать аутентификацию Kerberos вместо стандартной аутентификации. `headers` - Словарь HTTP-заголовков, которые необходимо добавить к каждому API-запросу.
clusters	нет			Список словарей, описывающих, как сеть управляется в конкретном кластере. `name` - Имя кластера. `assigned` - true, если сеть должна быть назначена кластеру. По умолчанию true. `required` - true, если сеть должна оставаться работоспособной для всех хостов, связанных с этой сетью. `display` - true, если сеть должна быть помечена как сеть отображения. `migration` - true, если сеть должна быть помечена как сеть миграции. `gluster` - true, если сеть должна быть помечена как сеть gluster.
comment	нет			Комментарий к сети.
data_center	нет			Имя дата-центра, в котором находится сеть.
description	нет			Описание сети.
fetch_nested (добавлено в 2.3)	нет			Если True, модуль извлечет дополнительные данные из API. Он извлечет идентификаторы дисков ВМ, снимков и т. д. Пользователь может настроить извлечение других атрибутов вложенных сущностей, указав `nested_attributes`.
mtu	нет			Максимальный размер транспортного блока (MTU) сети.
name	да			Имя сети для управления.
nested_attributes (добавлено в 2.3)	нет			Указывает список атрибутов, которые должны быть извлечены из API. Этот параметр применяется только когда `fetch_nested` равен true.
poll_interval	нет	3		Количество секунд, которое модуль ожидает, прежде чем отправить другой запрос опроса состояния сущности.
state	нет	present	present absent	Сеть должна быть присутствующей или отсутствующей
timeout	нет	180		Количество секунд, которое модуль должен ждать, пока экземпляр не перейдет в нужное состояние.
vlan_tag	нет			Укажите тег VLAN.
vm_network	нет			Если True, сеть будет помечена как сеть для ВМ. Сеть ВМ передает трафик, относящийся к виртуальной машине.
wait	нет			True, если модуль должен ждать, пока сущность не перейдет в нужное состояние.

Примеры

# Examples don't contain auth parameter for simplicity,
# look at ovirt_auth module to see how to reuse authentication:

# Create network
- ovirt_networks:
    data_center: mydatacenter
    name: mynetwork
    vlan_tag: 1
    vm_network: true

# Remove network
- ovirt_networks:
    state: absent
    name: mynetwork

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

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

имя	описание	возвращаемое значение	тип	пример
id	Идентификатор управляемой сети	При успехе, если сеть найдена.	str	7de90f31-222c-436c-a1ca-7e655bd5b60c
network	Словарь со всеми атрибутами сети. Атрибуты сети можно найти на вашем экземпляре oVirt/RHV по следующему URL: http://ovirt.github.io/ovirt-engine-api-model/master/#types/network.	При успехе, если сеть найдена.	dict

Примечания

Примечание

Для использования этого модуля необходимо установить oVirt Python SDK. Чтобы убедиться, что он установлен с правильной версией, вы можете создать следующую задачу: pip: name=ovirt-engine-sdk-python version=4.0.0

Статус

Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.

Для получения помощи в разработке модулей, если вы так желаете, пожалуйста, прочитайте Информацию о сообществе и сотрудничество, Тестирование Ansible и Разработка модулей.

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