VhJRdZdZdZddlmZGddeZdZedk(rey y ) a --- module: floating_ip author: OpenStack Ansible SIG short_description: Manage floating IP addresses for OpenStack servers description: - Add or remove an floating ip address to/from an OpenStack server. - Returns the floating IP when attaching only if I(wait) is C(true). - When detaching a floating IP there might be a delay until an server does not list the floating IP any more. options: fixed_address: description: - To which fixed IP of server the floating IP address should be attached to. type: str floating_ip_address: description: - A floating IP address to attach or to detach. When I(state) is present can be used to specify a IP address to attach. I(floating_ip_address) requires I(network) to be set. type: str nat_destination: description: - The name or id of a neutron private network that the fixed IP to attach floating IP is on aliases: ["fixed_network", "internal_network"] type: str network: description: - The name or ID of a neutron external network or a nova pool name. type: str purge: description: - When I(state) is absent, indicates whether or not to delete the floating IP completely, or only detach it from the server. Default is to detach only. type: bool default: 'false' reuse: description: - When I(state) is present, and I(floating_ip_address) is not present, this parameter can be used to specify whether we should try to reuse a floating IP address already allocated to the project. - When I(reuse) is C(true), I(network) is defined and I(floating_ip_address) is undefined, then C(nat_destination) and C(fixed_address) will be ignored. type: bool default: 'false' server: description: - The name or ID of the server to which the IP address should be assigned. required: true type: str state: description: - Should the resource be present or absent. choices: [present, absent] default: present type: str extends_documentation_fragment: - openstack.cloud.openstack av # Assign a floating IP to the first interface of `cattle001` from an existing # external network or nova pool. A new floating IP from the first available # external network is allocated to the project. - openstack.cloud.floating_ip: cloud: dguerri server: cattle001 # Assign a new floating IP to the server fixed ip `192.0.2.3` of # `cattle001`. If a free floating IP is already allocated to the project, it is # reused; if not, a new one is created. - openstack.cloud.floating_ip: cloud: dguerri state: present reuse: true server: cattle001 network: ext_net fixed_address: 192.0.2.3 wait: true timeout: 180 # Assign a new floating IP from the network `ext_net` to the server fixed # ip in network `private_net` of `cattle001`. - openstack.cloud.floating_ip: cloud: dguerri state: present server: cattle001 network: ext_net nat_destination: private_net wait: true timeout: 180 # Detach a floating IP address from a server - openstack.cloud.floating_ip: cloud: dguerri state: absent floating_ip_address: 203.0.113.2 server: cattle001 a floating_ip: description: Dictionary describing the floating ip address. type: dict returned: success contains: created_at: description: Timestamp at which the floating IP was assigned. type: str description: description: The description of a floating IP. type: str dns_domain: description: The DNS domain. type: str dns_name: description: The DNS name. type: str fixed_ip_address: description: The fixed IP address associated with a floating IP address. type: str floating_ip_address: description: The IP address of a floating IP. type: str floating_network_id: description: The id of the network associated with a floating IP. type: str id: description: Id of the floating ip. type: str name: description: Name of the floating ip. type: str port_details: description: | The details of the port that this floating IP associates with. Present if C(fip-port-details) extension is loaded. type: dict port_id: description: The port ID floating ip associated with. type: str project_id: description: The ID of the project this floating IP is associated with. type: str qos_policy_id: description: The ID of the QoS policy attached to the floating IP. type: str revision_number: description: Revision number. type: str router_id: description: The id of the router floating ip associated with. type: str status: description: | The status of a floating IP, which can be 'ACTIVE' or 'DOWN'. type: str subnet_id: description: The id of the subnet the floating ip associated with. type: str tags: description: List of tags. type: list elements: str updated_at: description: Timestamp at which the floating IP was last updated. type: str )OpenStackModuleceZdZeeeeddgeeddeddeded d d g  Zed d dgggddiZdZdZdZdZ dZ dZ ddZ dZ y)NetworkingFloatingIPModule fixed_networkinternal_network)aliasesboolF)typedefaultT)requiredpresentabsent)r choices) fixed_addressfloating_ip_addressnat_destinationnetworkpurgereuseserverstaterrr) required_if required_byc|j|jddk(r|jy|jy)Nrr )_initparams_create_and_attach_detach_and_delete)selfs o/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/openstack/cloud/plugins/modules/floating_ip.pyrunzNetworkingFloatingIPModule.runs6 ;;w 9 ,  # # %  # # %c d}|jd}|jd}|jd}|jr|jdnd}|j|j||||}|r|dnd}|r|s*|jjj ||d }n\|j rP|j d d k(r>||j|jvr!|jd j| |r||j|jvrH|jj|j|g|jd|jd|d }n[nZ|sW|jj|j|d|jd||jd|jd|d }n |rS|jjj|j|_|j|j||||}|j||r|djdydy)NFrrridrr network_idrnat_destination_name_or_idr)rfloating_network_idTstatusACTIVEz5Floating ip {0} has been attached to different server)msgwaittimeout)ripsr,r-rr)rip_poolr.rrr,r-r)computed)changed floating_ip)rr _find_ipsrconn create_ip port_details _filter_ips fail_jsonformat add_ip_listadd_ips_to_servercompute get_server exit_jsonto_dict)rr1rrr'r&r.ips r rz-NetworkingFloatingIPModule._create_and_attachsU O4 "kk*?@%)[[1B%C"+/<r4detach_ip_from_server delete_ip)rr.r1r@s r rz-NetworkingFloatingIPModule._detach_and_delete_snn;; $ ,A B-1\\t||D)t++o6'+{{3D'E G NN5N ) B$%  //$++d:K?A$x0I {{7# !!++BtH5# & w'r"cd}|d%|jjj|}|dsgS||djDcgc]}|ddk(r|dc}Scc}w)Nc@|Dcgc] }|D]}| c}}Scc}}wN)listssublistitems r _flattenz8NetworkingFloatingIPModule._filter_ips.._flattens"(-BW'B$DBDB BBs addressesOS-EXT-IPS:typefloatingaddr)r4r<r=values)rrrNaddresss r r7z&NetworkingFloatingIPModule._filter_ipss C +  &YY&&11&9Fk"I ({(;(B(B(DE=,-;= ==sA'c|r,|jjj|}|r|gSgS|s|r|j||S|j |||SrI)r4rfind_ip_find_ips_by_nat_destination)_find_ips_by_network_id_and_fixed_address)rrrr&rr'r@s r r3z$NetworkingFloatingIPModule._find_ipssn ""**+>?BB4 %2 %$>4424 4AA z3 3r"c@|dsy|jjj|d}|dj|dgDcgc] }|ddk(r|}}|sy|Dcgc],}|jjj |dd.c}Scc}wcc}w)NrOFignore_missingnamerPrQrR)r4r find_networkgetrV)rrr'rrRfips_with_nat_destinationfips r rWz7NetworkingFloatingIPModule._find_ips_by_nat_destinationsk"))++88 &u9> k"&&v'>C%6%&*4 %6!%6 ) 56 !!))#f+e)L6 6%66s B"1BNc&|jjjDcgc]}|d|j|vr|}}g}|D]=}|r |d|k7r|s|j ||s$|d|k(s-|j |?|Scc}w)Nrr(rB)r4rr.r7append)rrrr&r@r. matching_ipss r rXzDNetworkingFloatingIPModule._find_ips_by_network_id_and_fixed_addresss !II--113Ib*+t/?/?/GGII  (Bb!67:E ##B'"%7"8M"I##B' ('IsBcN|jd}|jjj|d}|jjj ||_|jd}|r-|jj j|d|_yd|_y)NrFrZr) name_or_idr[)rr4r< find_serverr=rrr])rserver_name_or_idrnetwork_name_or_ids r rz NetworkingFloatingIPModule._inits KK1""../@>C/Eii''226: ![[3 99,,99-e:EDL DLr")NN)__name__ __module__ __qualname__dict argument_spec module_kwargsr!rrr7r3rWrXrrJr"r rrsf Fo7I%JK..T"9x.CD M h!6 7 8  "I M&HIT (D=&3466AE=A4  r"rc&t}|yrI)r)modules r mainrqs ' )F Hr"__main__N) DOCUMENTATIONEXAMPLESRETURNBansible_collections.openstack.cloud.plugins.module_utils.openstackrrrqrirJr"r rwsL? B& PC J_u u p   zFr"