community.network.ig_unit_information – Get unit information from an Ingate SBC.

Note

This plugin is part of the community.network collection (version 3.0.0).

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

To use it in a playbook, specify: community.network.ig_unit_information.

Synopsis

  • Get unit information from an Ingate SBC.

Requirements

The below requirements are needed on the host that executes this module.

  • ingatesdk >= 1.0.6

Parameters

Parameter Choices/Defaults Comments
client
string
A dict object containing connection details.
address
string / required
The hostname or IP address to the unit.
password
string / required
The password for the REST API user.
port
integer
Which HTTP(S) port to connect to.
scheme
string / required
    Choices:
  • http
  • https
Which HTTP protocol to use.
timeout
integer
The timeout (in seconds) for REST API requests.
username
string / required
The username of the REST API user.
validate_certs
boolean
    Choices:
  • no
  • yes ←
Verify the unit's HTTPS certificate.

aliases: verify_ssl
version
string
    Choices:
  • v1 ←
REST API version.

Notes

Note

  • This module requires that the Ingate Python SDK is installed on the host. To install the SDK use the pip command from your shell pip install ingatesdk.

Examples

- name: Get unit information
  community.network.ig_unit_information:
    client:
      version: v1
      scheme: http
      address: 192.168.1.1
      username: alice
      password: foobar

Return Values

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

Key Returned Description
unit-information
complex
success
Information about the unit

 
installid
string
success
The installation identifier

Sample:
any
 
interfaces
string
success
List of interface names

Sample:
eth0 eth1 eth2 eth3 eth4 eth5
 
lang
string
success
The unit's language

Sample:
en
 
lic_email
string
success
License email information

Sample:
 
lic_mac
string
success
License MAC information

Sample:
any
 
lic_name
string
success
License name information

Sample:
Example Inc
 
macaddr
string
success
The MAC address of the first interface

Sample:
52:54:00:4c:e2:07
 
mode
string
success
Operational mode of the unit

Sample:
Siparator
 
modules
string
success
Installed module licenses

Sample:
failover vpn sip qturn ems qos rsc voipsm
 
patches
list / elements=string
success
Installed patches on the unit

 
product
string
success
The product name

Sample:
Software SIParator/Firewall
 
serial
string
success
The serial number of the unit

Sample:
IG-200-839-2008-0
 
systemid
string
success
The system identifier of the unit

Sample:
IG-200-839-2008-0
 
unitname
string
success
The name of the unit

Sample:
Testname
 
version
string
success
Firmware version

Sample:
6.2.0-beta2


Authors

  • Ingate Systems AB (@ingatesystems)