community.general.infinity – Manage Infinity IPAM using Rest API

Note

This plugin is part of the community.general collection (version 3.8.3).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.infinity.

Synopsis

  • Manage Infinity IPAM using REST API.

Parameters

Parameter

Comments

action

string / required

Action to perform

Choices:

  • add_network

  • delete_network

  • get_network

  • get_network_id

  • release_ip

  • release_network

  • reserve_network

  • reserve_next_available_ip

ip_address

string

IP Address for a reservation or a release.

Default: “”

network_address

string

Network address with CIDR format (e.g., 192.168.310.0).

Default: “”

network_family

string

Network family defined by Infinity, e.g. IPv4, IPv6 and Dual stack

Choices:

  • 4

  • 6

  • dual

Default: 4

network_id

string

Network ID.

Default: “”

network_location

integer

The parent network id for a given network.

Default: -1

network_name

string

The name of a network.

Default: “”

network_size

string

Network bitmask (e.g. 255.255.255.220) or CIDR format (e.g., /26).

Default: “”

network_type

string

Network type defined by Infinity

Choices:

  • lan ← (default)

  • shared_lan

  • supernet

password

string / required

Infinity password.

server_ip

string / required

Infinity server_ip with IP address.

username

string / required

Username to access Infinity.

The user must have REST API privileges.

Examples

---
- 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

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

ip_info

string

when reserve next available ip address from a network, the ip address info ) is returned.

Returned: success

Sample: “{\”address\”: \”192.168.10.3\”, \”hostname\”: \”\”, \”FQDN\”: \”\”, \”domainname\”: \”\”, \”id\”: 3229}”

network_id

string

id for a given network

Returned: success

Sample: “1501”

network_info

string

when reserving a LAN network from a Infinity supernet by providing network_size, the information about the reserved network is returned.

Returned: success

Sample: {“description”: null, “network_address”: “192.168.10.32/28”, “network_family”: “4”, “network_id”: 3102, “network_location”: “3085”, “network_name”: “\u0027reserve_new_ansible_network\u0027”, “network_size”: null, “network_type”: “lan”, “ranges”: {“first_ip”: null, “id”: 0, “last_ip”: null, “name”: null, “type”: null}}

Authors

  • Meirong Liu (@MeganLiu)