Модуль community.general.infinity — управление Infinity IPAM с помощью REST API

Примечание

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

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

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

Чтобы использовать коллекцию в плейбуке, укажите: community.general.infinity.

Краткое описание
Параметры
Атрибуты
Примеры
Возвращаемые значения

Краткое описание

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

Параметры

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

Атрибуты

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

Примеры

- 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 string	При резервировании следующего доступного IP-адреса в сети возвращаются сведения об IP-адресе. Обратите внимание, что значение представляет собой строку, содержащую данные JSON. Возвращается: при успехе Пример: `"{\n \"address\": \"192.168.10.3\",\n \"hostname\": \"\",\n \"FQDN\": \"\",\n \"domainname\": \"\",\n \"id\": 3229\n}"`
network_id string	Идентификатор указанной сети. Возвращается: при успехе Пример: `"1501"`
network_info string	При резервировании LAN-сети из суперсети Infinity с указанием network_size возвращаются сведения о зарезервированной сети. Обратите внимание, что значение представляет собой строку, содержащую данные JSON. Возвращается: при успехе Пример: `"{\n \"network_address\": \"192.168.10.32/28\",\n \"network_family\": \"4\",\n \"network_id\": 3102,\n \"network_size\": null,\n \"description\": null,\n \"network_location\": \"3085\",\n \"ranges\": {\"id\": 0, \"name\": null, \"first_ip\": null, \"type\": null, \"last_ip\": null},\n \"network_type\": \"lan\",\n \"network_name\": \"'reserve_new_ansible_network'\"\n}"`

Авторы

Meirong Liu (@MeganLiu)

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

© 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/infinity_module.html