Vh ?ddlmZmZmZeZdZdZdZddl m Z ddl m Z ddl m Z ddlmZdd lmZmZmZmZmZmZd j/eZdd Zd ZdZdZdZdZdZdZ dZ!dZ"dZ#e$dk(re#y y ))absolute_importdivisionprint_functiona6 module: v_switch short_description: Manage Hetzner's vSwitch version_added: 1.7.0 author: - Alexander Gil Casas (@pando85) description: - Manage Hetzner's vSwitch. seealso: - name: vSwitch documentation description: Hetzner's documentation on vSwitch for connecting dedicated servers. link: https://docs.hetzner.com/robot/dedicated-server/network/vswitch extends_documentation_fragment: - community.hrobot.robot - community.hrobot.attributes - community.hrobot.attributes.actiongroup_robot attributes: check_mode: support: full diff_mode: support: none idempotent: support: full action_group: version_added: 2.1.0 options: vlan: description: - The vSwitch's VLAN ID. - Range can be from 4000 to 4091. - In order to identify a vSwitch both name and VLAN must match. If not, a new vSwitch will be created. type: int required: true name: description: - The vSwitch's name. - In order to identify a vSwitch both name and VLAN must match. If not, a new vSwitch will be created. type: str required: true state: description: - State of the vSwitch. - VSwitch is created if state is V(present), and deleted if state is V(absent). - V(absent) just cancels the vSwitch at the end of the current day. - When cancelling, you have to specify O(servers=[]) if you want to actively remove the servers in the vSwitch. type: str default: present choices: [present, absent] servers: description: - List of server identifiers (server's numeric ID or server's main IPv4 or IPv6). - If servers is not specified, servers are not going to be deleted. type: list elements: str wait: description: - Whether to wait until the vSwitch has been successfully configured before determining what to do, and before returning from the module. - The API returns status C(in process) when the vSwitch is currently being set up in the servers. If this happens, the module will try again until the status changes to C(ready) or server has been removed from vSwitch. - Please note that if you disable wait while deleting and removing servers module will fail with C(VSWITCH_IN_PROCESS) error. type: bool default: true wait_delay: description: - Delay to wait (in seconds) before checking again whether the vSwitch servers has been configured. type: int default: 10 timeout: description: - Timeout (in seconds) for waiting for vSwitch servers to be configured. type: int default: 180 a --- - name: Create vSwitch with VLAN 4010 and name foo community.hrobot.v_switch: hetzner_user: foo hetzner_password: bar vlan: 4010 name: foo - name: Create vSwitch with VLAN 4020 and name foo with two servers community.hrobot.v_switch: hetzner_user: foo hetzner_password: bar vlan: 4010 name: foo servers: - 123.123.123.123 - 154323 a< v_switch: description: - Information on the vSwitch. returned: success type: dict contains: id: description: - The vSwitch's ID. type: int sample: 4321 returned: success name: description: - The vSwitch's name. type: str sample: 'my vSwitch' returned: success vlan: description: - The vSwitch's VLAN ID. type: int sample: 4000 returned: success cancelled: description: - Cancellation status. type: bool sample: false returned: success server: description: - The vSwitch's VLAN. type: list elements: dict sample: - server_ip: '123.123.123.123' server_ipv6_net: '2a01:4f8:111:4221::' server_number: 321 status: 'ready' contains: server_ip: description: - The server's main IP address. type: str sample: '123.123.123.123' server_ipv6_net: description: - The server's main IPv6 network address. type: str sample: '2a01:f48:111:4221::' server_number: description: - The server's numeric ID. type: int sample: 321 status: description: - Status of vSwitch for this server. type: str choices: - ready - in process - failed sample: 'ready' returned: success subnet: description: - List of assigned IP addresses. type: list elements: dict sample: - ip: '213.239.252.48' mask: 29 gateway: '213.239.252.49' contains: ip: description: - IP address. type: str sample: '213.239.252.48' mask: description: - Subnet mask in CIDR notation. type: int sample: 29 gateway: description: - Gateway of the subnet. type: str sample: '213.239.252.49' returned: success cloud_network: description: - List of assigned Cloud networks. type: list elements: dict sample: - id: 123 ip: '10.0.2.0' mask: 24 gateway: '10.0.2.1' contains: id: description: - Cloud network ID. type: int sample: 123 ip: description: - IP address. type: str sample: '10.0.2.0' mask: description: - Subnet mask in CIDR notation. type: int sample: 24 gateway: description: - Gateway. type: str sample: '10.0.2.1' returned: success )datetime) AnsibleModule) to_native) urlencode)BASE_URLROBOT_DEFAULT_ARGUMENT_SPEC)get_x_www_form_urlenconded_dict_from_listfetch_url_jsonfetch_url_json_with_retriesCheckDoneTimeoutExceptionz {0}/vswitchNc<djt|}dg}|r0 t||||jd|jd|\}}nt |||\}}dk(r|j d S#t$r}|j dYd}~9d}~wwxYw) N{0}/{1} NOT_FOUND wait_delaytimeout)check_done_callbackcheck_done_delaycheck_done_timeout accept_errorsz+Timeout waiting vSwitch operation to finishmsgrzvSwitch not found.)formatV_SWITCH_BASE_URLrparamsr fail_jsonr )moduleid_wait_conditionurlrresulterrordummys m/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/hrobot/plugins/modules/v_switch.py get_v_switchr(s   ,c 2C MM P7$2!'|!<#)==#;+ MFE'  '   12 M) P   !N  O O Ps.A66 B?BBct|tr(dj|Dcgc] }t|c}St |Scc}w)Nz, ) isinstancelistjoinrrepr) possible_listxs r' print_listr0s:-&yy >1)A,>??  ?sAc 2ddi}|jd|jdd}t|tt||dddg \}}|dk(r4t |d d }|j d j | |S|dk(r|j d |S)N Content-type!application/x-www-form-urlencodednamevlan)r4r5POST INVALID_INPUTVSWITCH_LIMIT_REACHED)dataheadersmethodrr%invalidvSwitch invalid parameter ({0})rz)The maximum count of vSwitches is reached)rr rr r0rr)r r:r9r$r%invalid_parameterss r'create_v_switchr?#sBCGMM&)6==3H ID" t_&(?@ MFE 'w (BC>EEFXYZ M ) )HI Mc djt|}ddi}dtjj di}t ||t ||dgdd \}}|d k(r4t|d d }|jd j||S|dk(r|jd|S|dk(r|jd|S)Nrr2r3cancellation_datez%y-%m-%dDELETE)r7rCONFLICTTr9r:r;rallow_empty_resultr7r%r<r=rrzvSwitch not found to deleterDz The vSwitch is already cancelled) rrrnowstrftimer r r0r)r r!r#r:r9r$r%r>s r'delete_v_switchrI7s   ,c 2CBCG !8!8!D ED" t_@MFE 'w (BC>EEFXYZ M + :; M * ?@ Mr@c,td|dDS)Nc3,K|] }|ddk(yw)statusreadyN).0servers r' z'is_all_servers_ready..PsJvvh7*JsrP)all)r$r&s r'is_all_servers_readyrSOs J9IJ JJr@c djt|}ddi}td|}t||t ||dgddd \}}|d k(r3t |d d }|j d j|nk|dk(r|j |d dnM|dk(r|j |d dn/|dk(r|j dn|dk(r|j d|jdrtnd} t||| S)N{0}/{1}/serverr2r3rPr6)r7SERVER_NOT_FOUNDVSWITCH_VLAN_NOT_UNIQUEVSWITCH_IN_PROCESSVSWITCH_SERVER_LIMIT_REACHEDT))r9r:r;rrF!allowed_empty_result_status_codesr7r%r<z%Invalid parameter adding server ({0})rrVmessagerWrXCThere is a update running, therefore the vswitch can not be updatedrYz9The maximum number of servers is reached for this vSwitchwait) rrr r r r0rrrSr() r r!serversr#r:r9r$r%r>r"s r' add_serversr`Ss6  ! !"3S 9CBCG 4Xw GD" t_  *0MFE" 'w (BCDKKL^_` $ $VG_Y78 + +VG_Y78 & &bc 0 0XY.4]]6-B)N ^ 44r@c @djt|}ddi}td|}t||t ||dddgd \}}|dk(r|j |d d  n|dk(r|j d |j drtnd}t|||S)NrUr2r3rPrCrVrXTrEr%r\rr]r^) rrr r r rrrSr() r r!r_r#r:r9r$r%r"s r'delete_serversrb{s  ! !"3S 9CBCG 4Xw GD" t_)+?@ MFE ""VG_Y78 & &bc-3]]6-B)N ^ 44r@cn|Dcgc]%}|d|vr|d|vrt|d|vr|d'c}Scc}w)N server_ipserver_ipv6_net server_numberstr)current_serversdesired_serversrPs r'get_servers_to_deleterksV&   + o 5 $ %_ < ' ( ? {  s*2c|Dcgc]}t|d}}|Dcgc]}|d }}|Dcgc]}|d }}|Dcgc]}||vr ||vr||vr|c}Scc}wcc}wcc}wcc}w)Nrfrdrerg)rirjrP current_ids current_ips current_ipv6ss r'get_servers_to_addrps>MNF3vo./NKN5DE66+&EKE=LM6V-.MMM&    ${)BvUbGb   OEM sA A! A&A+c0t||}d}|jd||fSt|d|jd}|r|js t |||}d}t |d|jd}|r|js t |||}d}||fS)NFr_rPT)r(rrk check_moderbrpr`)r r!v_switchchangedservers_to_deleteservers_to_adds r'set_desired_serversrwsFC(HG }}Y''""-hx.@&--PYBZ[  %fc3DEH'(:FMM)Ya;SXAXYY F #$q(b   % &! +&q)$//<'  $F9  == !Y .!)F:  ]]7 #x /$$, $F9 %o6 6 == !Y . $F9 $$*62==+)4VXd^V]][dMe)fF:&)1F:&FvK Zs33H, H9H__main__)N)% __future__rrrrz __metaclass__ DOCUMENTATIONEXAMPLESRETURNransible.module_utils.basicr+ansible.module_utils.common.text.convertersr+ansible.module_utils.six.moves.urllib.parser ?ansible_collections.community.hrobot.plugins.module_utils.robotr r r r rrrrr(r0r?rIrSr`rbrkrprwr__name__rNr@r'rsA@ L \ (} @4AA"((28 (0K%5P50 (:z zFr@