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

Примечание

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

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

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

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

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

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

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

Параметры

Параметр	Комментарии
action string / required	Выполняемое действие Варианты: `"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 / required	Пароль Infinity.
server_ip string / required	IP-адрес сервера Infinity.
username string / required	Имя пользователя для доступа к Infinity. Пользователь должен иметь права доступа к REST API.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: отсутствует	Может работать в режиме `check_mode` и возвращать прогноз состояния изменений без изменения целевого объекта.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает подробную информацию о том, что изменилось (или что может потребовать изменения в `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 строка	При резервировании следующего доступного IP-адреса из сети возвращается информация об IP-адресе. Возвращено: успех Пример: `"{\"address\": \"192.168.10.3\", \"hostname\": \"\", \"FQDN\": \"\", \"domainname\": \"\", \"id\": 3229}"`
network_id строка	Идентификатор заданной сети. Возвращено: успех Пример: `"1501"`
network_info строка	При резервировании локальной сети из суперсети Infinity, указав 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/infinity_module.html