Модуль community.general.one_vnet — Управление виртуальными сетями OpenNebula

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования. Подробнее см. Требования.

Для использования в плейбуке укажите: community.general.one_vnet.

Новая в community.general 9.4.0

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

Обзор

Управление виртуальными сетями в OpenNebula.

Требования

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

pyone

Параметры

Параметр	Комментарии
api_password псевдонимы: api_token строка	Пароль или токен для аутентификации XMLRPC. Если не указан, используется значение переменной окружения `ONE_PASSWORD`, если она задана.
api_url псевдонимы: api_endpoint строка	Адрес ENDPOINT сервера XMLRPC. Если не указан, используется значение переменной окружения `ONE_URL`, если она задана.
api_username строка	Имя пользователя для аутентификации XMLRPC. Если не указан, используется значение переменной окружения `ONE_USERNAME`, если она задана.
id целое число	Идентификатор сети, которую нужно управлять. Если не задан, будет создана новая сеть с заданными `name`.
name строка	Имя сети, которую нужно управлять. Если сети с заданным именем не существует, она будет создана, иначе она будет управляется этим модулем.
state строка	`present` - состояние, используемое для управления сетью. `absent` - удалить сеть. Варианты: `"present"` ← (по умолчанию) `"absent"`
template строка	Строка, содержащая содержимое шаблона сети.
validate_certs логическое	Проверять сертификаты TLS/SSL или нет. Этот параметр игнорируется, если используется переменная окружения `PYTHONHTTPSVERIFY`. Варианты: `false` `true` ← (по умолчанию)
wait_timeout целое число	Время ожидания достижения желаемого состояния перед истечением времени, в секундах. По умолчанию: `300`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: частичная Обратите внимание, что режим проверки всегда возвращает `changed=true` для существующих сетей, даже если сеть фактически не изменится.	Может работать в режиме `check_mode` и возвращать прогноз состояния изменения без модификации целевого объекта.
diff_mode	Поддержка: отсутствует	Возвращает подробности о том, что изменилось (или, возможно, нужно изменить в `check_mode`), когда режим отличается.

Примеры

- name: Make sure the network is present by ID
  community.general.one_vnet:
    id: 0
    state: present
  register: result

- name: Make sure the network is present by name
  community.general.one_vnet:
    name: opennebula-bridge
    state: present
  register: result

- name: Create a new or update an existing network
  community.general.one_vnet:
    name: bridge-network
    template: |
      VN_MAD  = "bridge"
      BRIDGE  = "br0"
      BRIDGE_TYPE  = "linux"
      AR=[
        TYPE  = "IP4",
        IP    = 192.0.2.50,
        SIZE  = "20"
      ]
      DNS     = 192.0.2.1
      GATEWAY = 192.0.2.1

- name: Delete the network by ID
  community.general.one_vnet:
    id: 0
    state: absent

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

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

Ключ	Описание
ar_pool список / элементы=строка	Список ar_pool сети. Возвращается: когда `state=present` Пример: `[{"ar_id": 0, "ip": "192.0.2.1", "mac": "6c:1e:46:01:cd:d1", "size": 20, "type": "IP4"}, {"allocated": 0, "ar_id": 1, "ip": "198.51.100.1", "mac": "5d:9b:c0:9e:f6:e5", "size": 20, "type": "IP4"}]`
bridge строка	Интерфейс моста сети. Возвращается: когда `state=present` Пример: `"br0"`
bridge_type строка	Тип моста сети. Возвращается: когда `state=present` Пример: `"linux"`
clusters список / элементы=строка	Кластеры сети. Возвращается: когда `state=present` Пример: `[0, 100]`
group_id целое число	ID группы сети. Возвращается: когда `state=present` Пример: `1`
group_name строка	Имя группы сети. Возвращается: когда `state=present` Пример: `"one-users"`
id целое число	Идентификатор сети. Возвращается: когда `state=present` Пример: `153`
name строка	Имя сети. Возвращается: когда `state=present` Пример: `"app1"`
outer_vlan_id целое число	Внешний тег VLAN сети. Возвращается: когда `state=present` Пример: `1000`
owner_id целое число	ID владельца сети. Возвращается: когда `state=present` Пример: `143`
owner_name строка	Имя владельца сети. Возвращается: когда `state=present` Пример: `"ansible-test"`
parent_network_id целое число	ID родительской сети. Возвращается: когда `state=present` Пример: `1`
permissions словарь	Разрешения сети. Возвращается: когда `state=present` Пример: `{"group_a": 0, "group_m": 0, "group_u": 0, "other_a": 0, "other_m": 0, "other_u": 0, "owner_a": 0, "owner_m": 0, "owner_u": 1}`
group_a строка	Разрешения группы ADMIN сети. Возвращается: успех Пример: `"0"`
group_m строка	Разрешения группы MANAGE сети. Возвращается: успех Пример: `"0"`
group_u строка	Разрешения группы USAGE сети. Возвращается: успех Пример: `"0"`
other_a строка	Разрешения других пользователей ADMIN сети. Возвращается: успех Пример: `"0"`

other_m string	Разрешения MANAGE для других пользователей сети. Возвращаемое значение: success Пример: `"0"`
other_u string	Разрешения USAGE для других пользователей сети. Возвращаемое значение: success Пример: `"0"`
owner_a string	Разрешения ADMIN для владельца сети. Возвращаемое значение: success Пример: `"0"`
owner_m string	Разрешения MANAGE для владельца сети. Возвращаемое значение: success Пример: `"0"`
owner_u string	Разрешения USAGE для владельца сети. Возвращаемое значение: success Пример: `"1"`
phydev string	Физическое устройство сети (сетевая карта). Возвращаемое значение: когда `state=present` Пример: `"eth0"`
template dictionary	Обработанный шаблон сети. Возвращаемое значение: когда `state=present` Пример: `{"BRIDGE": "onebr.1000", "BRIDGE_TYPE": "linux", "DESCRIPTION": "sampletext", "PHYDEV": "eth0", "SECURITY_GROUPS": 0, "VLAN_ID": 1000, "VN_MAD": "802.1Q"}`
user_id integer	Имя пользователя сети. Возвращаемое значение: когда `state=present` Пример: `1`
user_name string	Идентификатор пользователя сети. Возвращаемое значение: когда `state=present` Пример: `"oneadmin"`
vlan_id integer	Тег VLAN сети. Возвращаемое значение: когда `state=present` Пример: `1000`
vm_mad string	VM_MAD сети. Возвращаемое значение: когда `state=present` Пример: `"bridge"`
vrouters list / elements=string	Список идентификаторов виртуальных маршрутизаторов сети. Возвращаемое значение: когда `state=present` Пример: `[0, 1]`

Авторы

Александр Бакановский (@abakanovskii)

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/one_vnet_module.html