Vh:IddlmZmZmZeZdZdZdZddl m Z ddl m Z m Z  ddlmZmZdZGd d e ZGd deZGddeZdZdZedk(rey y #e$rd Zd ZY@wxYw))absolute_importdivisionprint_functiona module: dimensiondata_vlan short_description: Manage a VLAN in a Cloud Control network domain extends_documentation_fragment: - community.general.dimensiondata - community.general.dimensiondata_wait - community.general.attributes description: - Manage VLANs in Cloud Control network domains. author: 'Adam Friedman (@tintoy)' attributes: check_mode: support: none diff_mode: support: none options: name: description: - The name of the target VLAN. type: str required: true description: description: - A description of the VLAN. type: str default: '' network_domain: description: - The ID or name of the target network domain. required: true type: str private_ipv4_base_address: description: - The base address for the VLAN's IPv4 network (for example V(192.168.1.0)). type: str default: '' private_ipv4_prefix_size: description: - The size of the IPv4 address space, for example V(24). - Required, if O(private_ipv4_base_address) is specified. type: int default: 0 state: description: - The desired state for the target VLAN. - V(readonly) ensures that the state is only ever read, not modified (the module will fail if the resource does not exist). choices: [present, absent, readonly] default: present type: str allow_expand: description: - Permit expansion of the target VLAN's network if the module parameters specify a larger network than the VLAN currently possesses. - If V(false), the module will fail under these conditions. - This is intended to prevent accidental expansion of a VLAN's network (since this operation is not reversible). type: bool default: false a - name: Add or update VLAN community.general.dimensiondata_vlan: region: na location: NA5 network_domain: test_network name: my_vlan1 description: A test VLAN private_ipv4_base_address: 192.168.23.0 private_ipv4_prefix_size: 24 state: present wait: true - name: Read / get VLAN details community.general.dimensiondata_vlan: region: na location: NA5 network_domain: test_network name: my_vlan1 state: readonly wait: true - name: Delete a VLAN community.general.dimensiondata_vlan: region: na location: NA5 network_domain: test_network name: my_vlan_1 state: absent wait: true a vlan: description: Dictionary describing the VLAN. returned: On success when O(state=present) type: complex contains: id: description: VLAN ID. type: str sample: "aaaaa000-a000-4050-a215-2808934ccccc" name: description: VLAN name. type: str sample: "My VLAN" description: description: VLAN description. type: str sample: "My VLAN description" location: description: Datacenter location. type: str sample: NA3 private_ipv4_base_address: description: The base address for the VLAN's private IPV4 network. type: str sample: 192.168.23.0 private_ipv4_prefix_size: description: The prefix size for the VLAN's private IPV4 network. type: int sample: 24 private_ipv4_gateway_address: description: The gateway address for the VLAN's private IPV4 network. type: str sample: 192.168.23.1 private_ipv6_base_address: description: The base address for the VLAN's IPV6 network. type: str sample: 2402:9900:111:1195:0:0:0:0 private_ipv6_prefix_size: description: The prefix size for the VLAN's IPV6 network. type: int sample: 64 private_ipv6_gateway_address: description: The gateway address for the VLAN's IPV6 network. type: str sample: 2402:9900:111:1195:0:0:0:1 status: description: VLAN status. type: str sample: NORMAL ) AnsibleModule)DimensionDataModuleUnknownNetworkError)DimensionDataVlanDimensionDataAPIExceptionTNFcReZdZdZfdZdZdZdZdZdZ dZ d Z d Z xZ S) DimensionDataVlanModulez4 The dimensiondata_vlan module for Ansible. cRtt| tt j t ddt ddt ddt ddt ddt ddd t d gd  t j|jjd|_ |jjd|_ |jjd|_ |jjd|_ |jjd|_|jjd|_|jjd|_|j"r-|jd k7r|jj%dyyy)z: Create a new Dimension Data VLAN module. Tstr)requiredtype)defaultrrintFbool)rrrpresent)rabsentreadonly)rchoices)name descriptionnetwork_domainprivate_ipv4_base_addressprivate_ipv4_prefix_size allow_expandstate) argument_specrequired_togethermodulerrrrrrrz=The wait parameter is only supported when state is "present".msgN)superr __init__rrargument_spec_with_waitdictr!r#paramsrrnetwork_domain_selectorrrrrwait fail_json)self __class__s x/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/dimensiondata_vlan.pyr'z DimensionDataVlanModule.__init__s^ %t5 1IIt%8 $Re <#'E#B.22E.J-1!%-H!%ue&!Qy:[\#6"G"G"I  6 KK&&v. ;;--m<'+{{'9'9:J'K$)-);); 99y0 KK ! !S " 19c|j}|j|}|s|jjrA|jj dj |j |jd|j|}|jj dj |j |jt|dyt||jj}|jsL|jj dj |j |jt|dy |j|j!r`|j"sT|jjd j |j$d j |j&zd z |jjrK|jj dj |j |jt|d|j)r=|j |_|j*|_|j,j/||j!r,|j$|_|j,j1||jj dj |j |jt|dy#t$rL}|jjd j |j |j| Yd}~d}~wwxYw)z9 Ensure that the target VLAN is present. zCVLAN "{0}" is absent from network domain "{1}" (should be present).Tr%changedz+Created VLAN "{0}" in network domain "{1}".r%vlanr4zDVLAN "{0}" is present in network domain "{1}" (no changes detected).FNz8Unable to update VLAN "{0}" in network domain "{1}": {2}r$z>The configured private IPv4 network size ({0}-bit prefix) for z@the VLAN differs from its current network size ({0}-bit prefix) zIand needs to be expanded. Use allow_expand=true if this is what you want.zAVLAN "{0}" is present in network domain "{1}" (changes detected).z+Updated VLAN "{0}" in network domain "{1}".)_get_network_domain _get_vlanr# check_mode exit_jsonformatrr+ _create_vlan vlan_to_dictVlanDiffr* has_changesensure_legal_changeInvalidVlanChangeErrorr- needs_expandrrprivate_ipv4_range_size needs_editrdriverex_update_vlanex_expand_vlan)r.rr6diffinvalid_vlan_changes r0 state_presentz%DimensionDataVlanModule.state_presents 113~~n-{{%% %%]dd 4#?#?! &$$^4D KK ! !AHHIIt;;"$' " D$++"4"45D##% %%^ee 4#?#?&d+! & ((*  "4+<+< %%X__55Zaa44d d&{{%% %%[bb 4#?#?&d+ &  II #'#3#3  **40  "/3/L/L, **40 KK ! !AHHIIt;;"$' " G*  %%RYY 4#?#?AT& sL M AMM c|j}|j|}|r'|jjt |dy|jj dj |j|jy)z/ Read the target VLAN's state. F)r6r4z2VLAN "{0}" does not exist in network domain "{1}".r$N) r7r8r#r:r=r-r;rr+r.rr6s r0state_readonlyz&DimensionDataVlanModule.state_readonly%s{ 113~~n-  KK ! !!$' "  KK ! !HOOIIt;; " r1c4|j}|j|}|sB|jjdj |j |j dy|jjrK|jjdj |j |j t|d|j||jjdj |j |j dy) z= Ensure that the target VLAN is not present. z/VLAN "{0}" is absent from network domain "{1}".Fr3NzAVLAN "{0}" is present in network domain "{1}" (should be absent).Tr5z-Deleted VLAN "{0}" from network domain "{1}".) r7r8r#r:r;rr+r9r= _delete_vlanrLs r0 state_absentz$DimensionDataVlanModule.state_absent9s 113~~n- KK ! !ELLIIt;; "   ;; ! ! KK ! !W^^IIt;;"$' "  $ ?FF 477  r1c|jj|j|}|Dcgc]}|j|jk(s| }}|r|dSycc}w)z Retrieve the target VLAN details from CloudControl. :param network_domain: The target network domain. :return: The VLAN, or None if the target VLAN was not found. :rtype: DimensionDataVlan )locationrrN)rE ex_list_vlansrRr)r.rvlansr6matching_vlanss r0r8z!DimensionDataVlanModule._get_vlan]sb ))]])* ,1K4DII4J$KK !!$ $ Ls A Ac|jj||j|j|j|j }|j r|j|jd}|S)NNORMAL) rEex_create_vlanrrrrr,_wait_for_vlan_stateidrLs r0r<z$DimensionDataVlanModule._create_vlanps_{{))  II  * *     ) )   99,,TWWh?D r1c& |jj||jr|j|dyy#t$rJ}|j j dj|j|jYd}~yd}~wwxYw)N NOT_FOUNDzRFailed to delete VLAN "{0}" due to unexpected error from the CloudControl API: {1}r$) rEex_delete_vlanr,rYr r#r-r;rZr%)r.r6 api_exceptions r0rOz$DimensionDataVlanModule._delete_vlan~s  KK & &t ,yy))$ <)  KK ! !hooGG].. "   s9= BAB  Bc|j}|jjd}|jjd} |jjj ||jj |||S#t$rE}|jdk7rt|jddddddddd|j| cYd}~Sd}~wwxYw)Nwait_poll_interval wait_timeRESOURCE_NOT_FOUNDr\rr) rZstatusrrprivate_ipv4_range_addressrC ipv4_gatewayipv6_range_addressipv6_range_size ipv6_gatewayrRr) r7r#r*rE connectionwait_for_state ex_get_vlanr coder rZrR)r.r6state_to_wait_forrr`rar^s r0rYz,DimensionDataVlanModule._wait_for_vlan_states113![[//0DEKK&&{3  ;;))88! ''"  ) !!%99$77"+-()#% !-    szd Represents differences between VLAN information (from CloudControl) and module parameters. c$||_||_|d|jk7|_|d|jk7|_|d|j k7|_|d|jk7|_ |d|jz }|dkD|_ |dk|_ y)z :param vlan: The VLAN information from CloudControl. :type vlan: DimensionDataVlan :param module_params: The module parameters. :type module_params: dict rrrrrN) r6 module_paramsr name_changedrdescription_changedrd!private_ipv4_base_address_changedrC private_ipv4_prefix_size_changed"private_ipv4_prefix_size_increased"private_ipv4_prefix_size_decreased)r.r6rz#private_ipv4_prefix_size_differences r0r'zVlanDiff.__init__s *)&1TYY>#0#?4CSCS#S 1>?Z1[_c_~_~1~.0=>X0Y]a]y]y0y-/<  1 1()lm m  2 2(*CD D 3r1c6|jxs |jS)z Is an Edit operation required to resolve the differences between the VLAN information and the module parameters? :return: True, if an Edit operation is required; otherwise, False. )r{r|rps r0rDzVlanDiff.needs_edits  r>s"Z,8D$= 7r1r>c |j|j|j|jj|j|j |j |j|j|j|jd S)N) rZrrrRrrprivate_ipv4_gateway_addressipv6_base_addressipv6_prefix_sizeipv6_gateway_addressrc) rZrrrRrdrCrerfrgrhrc)r6s r0r=r=smgg ''MM$$%)%D%D$($@$@(,(9(9!44 00 $ 1 1++  r1ct}|jdk(r|jy|jdk(r|jy|jdk(r|j yy)Nrrr)r rrJrMrPr"s r0mainr)sW $ &F ||y   #  ! "r1__main__) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrHansible_collections.community.general.plugins.module_utils.dimensiondatarrlibcloud.common.dimensiondatar r HAS_LIBCLOUD ImportErrorr ExceptionrAobjectr>r=rrqrwr1r0rsCB ; z @2 h5}ZLW1Wt Y H7vH7V   zF] Ls A!! A-,A-