ansible / ansible.builtin / v2.9.23 / module / utm_network_interface_address Create, update or destroy network/interface_address object | "added in version" 2.8 of ansible.builtin" Authors: Juergen Wiebe (@steamx) preview | supported by communityansible.builtin.utm_network_interface_address (v2.9.23) — module
pip
Install with pip install ansible==2.9.23
Create, update or destroy a network/interface_address object in SOPHOS UTM.
This module needs to have the REST Ability of the UTM to be activated.
# Create a network interface address - name: utm network interface address utm_proxy_backend: utm_host: sophos.host.name utm_token: abcdefghijklmno1234 name: TestNetworkInterfaceAddress address: 0.0.0.0 state: present
# Remove a network interface address - name: utm network interface address network_interface_address: utm_host: sophos.host.name utm_token: abcdefghijklmno1234 name: TestNetworkInterfaceAddress address: 0.0.0.0 state: absent
name: description: - The name of the object. Will be used to identify the entry required: true state: choices: - absent - present default: present description: - The desired state of the object. - C(present) will create or update an object - C(absent) will delete an object if it was present type: str address: description: - The ip4 address of the network/interface_address object. required: true comment: description: - An optional comment to add to the object headers: default: {} description: - A dictionary of additional headers to be sent to POST and PUT requests. - Is needed for some modules required: false type: dict address6: description: - The ip6 address of the network/interface_address object. required: false resolved: description: - Whether or not the object is resolved utm_host: description: - The REST Endpoint of the Sophos UTM. required: true type: str utm_port: default: 4444 description: - The port of the REST interface. type: int resolved6: description: - Whether or not the object is resolved utm_token: description: - The token used to identify at the REST-API. See U(https://www.sophos.com/en-us/medialibrary/PDFs/documentation/UTMonAWS/Sophos-UTM-RESTful-API.pdf?la=en), Chapter 2.4.2. required: true type: str utm_protocol: choices: - http - https default: https description: - The protocol of the REST Endpoint. type: str validate_certs: default: true description: - Whether the REST interface's ssl certificate should be verified or not. type: bool
result: contains: _locked: description: Whether or not the object is currently locked type: bool _ref: description: The reference name of the object type: str _type: description: The type of the object type: str address: description: The ip4 address of the network/interface_address object type: str address6: description: The ip6 address of the network/interface_address object type: str comment: description: The comment string type: str name: description: The name of the object type: str resolved: description: Whether or not the object is resolved type: bool resolved6: description: Whether or not the object is resolved type: bool description: The utm object that was created returned: success type: complex