#!/usr/bin/python # Copyright: (c) 2019, Hetzner Cloud GmbH # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt) DOCUMENTATION = """ --- module: hcloud_network_info short_description: Gather info about your Hetzner Cloud networks. description: - Gather info about your Hetzner Cloud networks. author: - Christopher Schmitt (@cschmitt-hcloud) options: id: description: - The ID of the network you want to get. type: int name: description: - The name of the network you want to get. type: str label_selector: description: - The label selector for the network you want to get. type: str extends_documentation_fragment: - hetzner.hcloud.hcloud """ EXAMPLES = """ - name: Gather hcloud network info local_action: module: hcloud_network_info - name: Print the gathered info debug: var: hcloud_network_info """ RETURN = """ hcloud_network_info: description: The network info as list returned: always type: complex contains: id: description: Numeric identifier of the network returned: always type: int sample: 1937415 name: description: Name of the network returned: always type: str sample: awesome-network ip_range: description: IP range of the network returned: always type: str sample: 10.0.0.0/16 subnetworks: description: Subnetworks belonging to the network returned: always type: complex contains: type: description: Type of the subnetwork. returned: always type: str sample: cloud network_zone: description: Network of the subnetwork. returned: always type: str sample: eu-central ip_range: description: IP range of the subnetwork returned: always type: str sample: 10.0.0.0/24 gateway: description: Gateway of this subnetwork returned: always type: str sample: 10.0.0.1 routes: description: Routes belonging to the network returned: always type: complex contains: ip_range: description: Destination network or host of this route. returned: always type: str sample: 10.0.0.0/16 gateway: description: Gateway of this route returned: always type: str sample: 10.0.0.1 expose_routes_to_vswitch: description: Indicates if the routes from this network should be exposed to the vSwitch connection. returned: always type: bool sample: false servers: description: Servers attached to the network returned: always type: complex contains: id: description: Numeric identifier of the server returned: always type: int sample: 1937415 name: description: Name of the server returned: always type: str sample: my-server status: description: Status of the server returned: always type: str sample: running server_type: description: Name of the server type of the server returned: always type: str sample: cx11 ipv4_address: description: Public IPv4 address of the server, None if not existing returned: always type: str sample: 116.203.104.109 ipv6: description: IPv6 network of the server, None if not existing returned: always type: str sample: 2a01:4f8:1c1c:c140::/64 location: description: Name of the location of the server returned: always type: str sample: fsn1 datacenter: description: Name of the datacenter of the server returned: always type: str sample: fsn1-dc14 rescue_enabled: description: True if rescue mode is enabled, Server will then boot into rescue system on next reboot returned: always type: bool sample: false backup_window: description: Time window (UTC) in which the backup will run, or null if the backups are not enabled returned: always type: bool sample: 22-02 labels: description: User-defined labels (key-value pairs) returned: always type: dict delete_protection: description: True if the network is protected for deletion returned: always type: bool version_added: "0.1.0" labels: description: Labels of the network returned: always type: dict """ from ansible.module_utils.basic import AnsibleModule from ansible.module_utils.common.text.converters import to_native from ansible_collections.hetzner.hcloud.plugins.module_utils.hcloud import Hcloud from ansible_collections.hetzner.hcloud.plugins.module_utils.vendor.hcloud import ( HCloudException, ) class AnsibleHcloudNetworkInfo(Hcloud): def __init__(self, module): Hcloud.__init__(self, module, "hcloud_network_info") self.hcloud_network_info = None def _prepare_result(self): tmp = [] for network in self.hcloud_network_info: if network is not None: subnets = [] for subnet in network.subnets: prepared_subnet = { "type": subnet.type, "ip_range": subnet.ip_range, "network_zone": subnet.network_zone, "gateway": subnet.gateway, } subnets.append(prepared_subnet) routes = [] for route in network.routes: prepared_route = {"destination": route.destination, "gateway": route.gateway} routes.append(prepared_route) servers = [] for server in network.servers: image = None if server.image is None else to_native(server.image.name) ipv4_address = None if server.public_net.ipv4 is None else to_native(server.public_net.ipv4.ip) ipv6 = None if server.public_net.ipv6 is None else to_native(server.public_net.ipv6.ip) prepared_server = { "id": to_native(server.id), "name": to_native(server.name), "ipv4_address": ipv4_address, "ipv6": ipv6, "image": image, "server_type": to_native(server.server_type.name), "datacenter": to_native(server.datacenter.name), "location": to_native(server.datacenter.location.name), "rescue_enabled": server.rescue_enabled, "backup_window": to_native(server.backup_window), "labels": server.labels, "status": to_native(server.status), } servers.append(prepared_server) tmp.append( { "id": to_native(network.id), "name": to_native(network.name), "ip_range": to_native(network.ip_range), "subnetworks": subnets, "routes": routes, "expose_routes_to_vswitch": network.expose_routes_to_vswitch, "servers": servers, "labels": network.labels, "delete_protection": network.protection["delete"], } ) return tmp def get_networks(self): try: if self.module.params.get("id") is not None: self.hcloud_network_info = [self.client.networks.get_by_id(self.module.params.get("id"))] elif self.module.params.get("name") is not None: self.hcloud_network_info = [self.client.networks.get_by_name(self.module.params.get("name"))] elif self.module.params.get("label_selector") is not None: self.hcloud_network_info = self.client.networks.get_all( label_selector=self.module.params.get("label_selector") ) else: self.hcloud_network_info = self.client.networks.get_all() except HCloudException as e: self.fail_json_hcloud(e) @staticmethod def define_module(): return AnsibleModule( argument_spec=dict( id={"type": "int"}, name={"type": "str"}, label_selector={"type": "str"}, **Hcloud.base_module_arguments() ), supports_check_mode=True, ) def main(): module = AnsibleHcloudNetworkInfo.define_module() hcloud = AnsibleHcloudNetworkInfo(module) hcloud.get_networks() result = hcloud.get_result() info = {"hcloud_network_info": result["hcloud_network_info"]} module.exit_json(**info) if __name__ == "__main__": main()