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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 строка	URL конечной точки сервера XMLRPC. Если параметр не указан, используется значение переменной окружения `ONE_URL`, если оно задано.
api_username строка	Имя пользователя для аутентификации XMLRPC. Если параметр не указан, используется значение переменной окружения `ONE_USERNAME`, если оно задано.
id целое число	`id` сети, которой требуется управлять. Если параметр не задан, создаётся новая сеть с указанным `name`.
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	Поддержка: отсутствует	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `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 целое число	Идентификатор группы сети. Возвращается: когда `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 целое число	Идентификатор владельца сети. Возвращается: когда `state=present` Пример: `143`
owner_name строка	Имя владельца сети. Возвращается: когда `state=present` Пример: `"ansible-test"`
parent_network_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 строка	Разрешения MANAGE для остальных пользователей сети. Возвращается: при успешном выполнении Пример: `"0"`
other_u строка	Разрешения USAGE для остальных пользователей сети. Возвращается: при успешном выполнении Пример: `"0"`
owner_a строка	Разрешения ADMIN владельца сети. Возвращается: при успешном выполнении Пример: `"0"`
owner_m строка	Разрешения MANAGE владельца сети. Возвращается: при успешном выполнении Пример: `"0"`
owner_u строка	Разрешения USAGE владельца сети. Возвращается: при успешном выполнении Пример: `"1"`
phydev строка	Физическое устройство сети (NIC). Возвращается: когда `state=present` Пример: `"eth0"`
template словарь	Разобранный шаблон сети. Возвращается: когда `state=present` Пример: `{"BRIDGE": "onebr.1000", "BRIDGE_TYPE": "linux", "DESCRIPTION": "sampletext", "PHYDEV": "eth0", "SECURITY_GROUPS": 0, "VLAN_ID": 1000, "VN_MAD": "802.1Q"}`
user_id целое число	Имя пользователя сети. Возвращается: когда `state=present` Пример: `1`
user_name строка	Идентификатор пользователя сети. Возвращается: когда `state=present` Пример: `"oneadmin"`
vlan_id целое число	Тег VLAN сети. Возвращается: когда `state=present` Пример: `1000`
vn_mad строка	VN_MAD сети. Возвращается: когда `state=present` Пример: `"bridge"`
vrouters список / элементы=строка	Список идентификаторов виртуальных маршрутизаторов сети. Возвращается: когда `state=present` Пример: `[0, 1]`

Авторы

Alexander Bakanovskii (@abakanovskii)

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

© 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/community/general/one_vnet_module.html