Spec-Zone.ru › Ansible 2.11

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

Примечание

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

Для его установки используйте: 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
строка / обязательно
IP-адрес сервера Infinity.
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
строка
успех
При резервировании следующего доступного IP-адреса из сети, возвращаются данные об IP-адресе.

Пример:
{"address": "192.168.10.3", "hostname": "", "FQDN": "", "domainname": "", "id": 3229}
network_id
строка
успех
Идентификатор заданной сети.

Пример:
1501
network_info
строка
успех
При резервировании локальной сети из сети 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}}


Авторы

  • Мейронг Лю (@MeganLiu)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API