Модуль ovirt.ovirt.ovirt_mac_pool — модуль для управления пулами MAC-адресов в oVirt/RHV
Примечание
Этот модуль входит в коллекцию ovirt.ovirt (версия 3.2.2).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install ovirt.ovirt. Для работы с этим модулем требуются дополнительные компоненты; подробнее см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: ovirt.ovirt.ovirt_mac_pool.
Добавлен в ovirt.ovirt 1.0.0
Краткое описание
- Этот модуль управляет пулами MAC-адресов в oVirt/RHV.
Требования
Следующие компоненты должны быть установлены на хосте, на котором выполняется этот модуль.
- python >= 2.7
- ovirt-engine-sdk-python >= 4.4.0
Параметры
Параметр | Комментарии |
|---|---|
allow_duplicates boolean | Если значение true, один MAC-адрес можно использовать в пуле несколько раз. По умолчанию значение false задаётся движком oVirt/RHV. Варианты:
|
auth dictionary / обязательный | Словарь со значениями, необходимыми для создания HTTP/HTTPS-подключения к oVirt: |
|
ca_file string |
PEM-файл, содержащий доверенные сертификаты CA. Сертификат, предоставленный сервером, будет проверен с использованием этих сертификатов CA. Если параметр Значение по умолчанию задаётся переменной окружения |
|
compress boolean |
Флаг, указывающий, используется ли сжатие при подключении. Варианты:
|
|
headers dictionary |
Словарь HTTP-заголовков, добавляемых к каждому вызову API. |
|
hostname string |
Строка с именем хоста сервера, обычно вида `server.example.com`. Значение по умолчанию задаётся переменной окружения Необходимо указать либо |
|
insecure boolean |
Логический флаг, указывающий, нужно ли проверять TLS-сертификат и имя хоста сервера. Варианты:
|
|
kerberos boolean |
Логический флаг, указывающий, следует ли использовать аутентификацию Kerberos вместо стандартной базовой аутентификации. Варианты:
|
|
password string |
Пароль пользователя. Значение по умолчанию задаётся переменной окружения |
|
timeout integer |
Время ожидания ответа в секундах. По умолчанию: |
|
token string |
Токен, используемый вместо входа с именем пользователя и паролем. Значение по умолчанию задаётся переменной окружения |
|
url string |
Строка с URL API сервера, обычно вида `https://server.example.com/ovirt-engine/api`. Значение по умолчанию задаётся переменной окружения Необходимо указать либо |
|
username string |
Имя пользователя, например admin@internal. Значение по умолчанию задаётся переменной окружения |
description string | Описание пула MAC-адресов. |
fetch_nested boolean | Если значение True, модуль получит дополнительные данные из API. Модуль получит идентификаторы дисков виртуальных машин, снимков и т. д. Пользователь может указать другие атрибуты вложенных сущностей для получения, задав Варианты:
|
id string | Идентификатор управляемого пула MAC-адресов. |
name string / обязательный | Имя управляемого пула MAC-адресов. |
nested_attributes list / элементы=string | Список атрибутов, которые нужно получить из API. Этот параметр применяется только если По умолчанию: |
poll_interval integer | Интервал в секундах перед отправкой следующего запроса на проверку состояния сущности. По умолчанию: |
ranges list / элементы=string | Список диапазонов MAC-адресов. Начальный и конечный адреса должны быть разделены запятой. Например: 00:1a:4a:16:01:51,00:1a:4a:16:01:61 |
state string | Должен ли пул MAC-адресов существовать или отсутствовать. Варианты:
|
timeout integer | Время в секундах, в течение которого модуль должен ожидать перехода экземпляра в требуемое состояние. По умолчанию: |
wait boolean |
Варианты:
|
Примечания
Примечание
- Для использования этого модуля необходимо установить oVirt Python SDK. Чтобы убедиться, что установлена нужная версия, можно создать следующую задачу: pip: name=ovirt-engine-sdk-python version=4.4.0
Примеры
# Examples don't contain auth parameter for simplicity,
# look at ovirt_auth module to see how to reuse authentication:
# Create MAC pool:
- ovirt.ovirt.ovirt_mac_pool:
name: mymacpool
allow_duplicates: false
ranges:
- 00:1a:4a:16:01:51,00:1a:4a:16:01:61
- 00:1a:4a:16:02:51,00:1a:4a:16:02:61
# Remove MAC pool:
- ovirt.ovirt.ovirt_mac_pool:
state: absent
name: mymacpool
# Change MAC pool Name
- ovirt.ovirt.ovirt_nic:
id: 00000000-0000-0000-0000-000000000000
name: "new_mac_pool_name"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
id string | Идентификатор управляемого пула MAC-адресов Возвращается: При успешном выполнении, если пул MAC-адресов найден. Пример: |
template dictionary | Словарь со всеми атрибутами пула MAC-адресов. Атрибуты пула MAC-адресов для вашего экземпляра oVirt/RHV можно найти по следующему URL: http://ovirt.github.io/ovirt-engine-api-model/master/#types/mac_pool. Возвращается: При успешном выполнении, если пул MAC-адресов найден. |
Ссылки на коллекцию
© 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/ovirt/ovirt/ovirt_mac_pool_module.html
