community.general.infinity – Управление Infinity IPAM с помощью REST API

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.infinity.

Обзор
Параметры
Примеры
Значения возврата

Обзор

Управление Infinity IPAM с помощью REST API.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
action строка / обязательно	Варианты: add_network delete_network get_network get_network_id release_ip release_network reserve_network reserve_next_available_ip	Действие для выполнения
ip_address строка	Значение по умолчанию: ""	IP-адрес для резервирования или освобождения.
network_address строка	Значение по умолчанию: ""	Адрес сети в формате CIDR (например, 192.168.310.0).
network_family строка	Варианты: 4 6 dual Значение по умолчанию: 4	Семейство сетей, определённое Infinity (например, IPv4, IPv6 и Dual stack).
network_id строка	Значение по умолчанию: ""	Идентификатор сети.
network_location целое число	Значение по умолчанию: -1	Идентификатор родительской сети для заданной сети.
network_name строка	Значение по умолчанию: ""	Имя сети.
network_size строка	Значение по умолчанию: ""	Маска сети (например, 255.255.255.220) или формат CIDR (например, /26).
network_type строка	Варианты: lan ← shared_lan supernet	Тип сети, определённый Infinity.
password строка / обязательно		Пароль Infinity.
server_ip строка / обязательно		server_ip Infinity с IP-адресом.
username строка / обязательно		Имя пользователя для доступа к Infinity. Пользователь должен иметь права REST API.

Примеры

---
- hosts: localhost
  connection: local
  strategy: debug
  tasks:
    - name: Reserve network into Infinity IPAM
      community.general.infinity:
        server_ip: 80.75.107.12
        username: username
        password: password
        action: reserve_network
        network_name: reserve_new_ansible_network
        network_family: 4
        network_type: lan
        network_id: 1201
        network_size: /28
      register: infinity

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

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

Ключ	Возвращённое значение	Описание
ip_info строка	success	При резервировании следующего доступного IP-адреса из сети возвращается информация об IP-адресе. Пример: {"address": "192.168.10.3", "hostname": "", "FQDN": "", "domainname": "", "id": 3229}
network_id строка	success	Идентификатор заданной сети Пример: 1501
network_info строка	success	При резервировании LAN-сети из Infinity supernet путём указания network_size возвращается информация о зарезервированной сети. Пример: {'description': None, 'network_address': '192.168.10.32/28', 'network_family': '4', 'network_id': 3102, 'network_location': '3085', 'network_name': "'reserve_new_ansible_network'", 'network_size': None, 'network_type': 'lan', 'ranges': {'first_ip': None, 'id': 0, 'last_ip': None, 'name': None, 'type': None}}

Авторы

Meirong Liu (@MeganLiu)

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