omapi_host – Setup OMAPI hosts.

New in version 2.3.

Synopsis

  • Create, update and remove OMAPI hosts into compatible DHCPd servers.

Requirements

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

  • pypureomapi

Parameters

Parameter Choices/Defaults Comments
ddns
boolean
    Choices:
  • no ←
  • yes
Enable dynamic DNS updates for this host.
host
-
Default:
"localhost"
Sets OMAPI server host to interact with.
ip
-
Sets the lease host IP address.
key
- / required
Sets the TSIG key content for authenticating against OMAPI server.
key_name
- / required
Sets the TSIG key name for authenticating against OMAPI server.
macaddr
- / required
Sets the lease host MAC address.
name
-
Sets the host lease hostname (mandatory if state=present).
port
-
Default:
7911
Sets the OMAPI server port to interact with.
state
- / required
    Choices:
  • present
  • absent
Create or remove OMAPI host.
statements
-
Default:
[]
Attach a list of OMAPI DHCP statements with host lease (without ending semicolon).

Examples

- name: Remove a host using OMAPI
  omapi_host:
    key_name: "defomapi"
    key: "+bFQtBCta6j2vWkjPkNFtgA=="
    host: "10.1.1.1"
    macaddr: "00:66:ab:dd:11:44"
    state: absent

- name: Add a host using OMAPI
  omapi_host:
    key_name: "defomapi"
    key: "+bFQtBCta6j2vWkjPkNFtgA=="
    host: "10.98.4.55"
    macaddr: "44:dd:ab:dd:11:44"
    name: "server01"
    ip: "192.168.88.99"
    ddns: yes
    statements:
      - 'filename "pxelinux.0"'
      - 'next-server 1.1.1.1'
    state: present

Return Values

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

Key Returned Description
changed
string
 success
If module has modified a host
lease
complex
 success
dictionary containing host information
  hardware-address
string
 success
MAC address

Sample:
00:11:22:33:44:55
  hardware-type
integer
 success
hardware type, generally '1'

Sample:
1
  ip-address
string
 success
IP address, if there is.

Sample:
192.168.1.5
  name
string
 success
hostname

Sample:
mydesktop


Status

Authors

  • Loic Blot (@nerzhul)

Hint

If you notice any issues in this documentation you can edit this document to improve it.