Vh6ddlmZmZmZeZddgddZdZdZdZ dd l m Z m Z dd l mZdd lmZmZd Zd ZdZedk(reyy))absolute_importdivisionprint_functionz1.1 deprecated community)metadata_versionstatus supported_bya% --- module: meraki_snmp short_description: Manage organizations in the Meraki cloud description: - Allows for management of SNMP settings for Meraki. deprecated: removed_in: '3.0.0' why: Updated modules released with increased functionality alternative: cisco.meraki.networks_snmp options: state: description: - Specifies whether SNMP information should be queried or modified. choices: ['query', 'present'] default: present type: str v2c_enabled: description: - Specifies whether SNMPv2c is enabled. type: bool v3_enabled: description: - Specifies whether SNMPv3 is enabled. type: bool v3_auth_mode: description: - Sets authentication mode for SNMPv3. choices: ['MD5', 'SHA'] type: str v3_auth_pass: description: - Authentication password for SNMPv3. - Must be at least 8 characters long. type: str v3_priv_mode: description: - Specifies privacy mode for SNMPv3. choices: ['DES', 'AES128'] type: str v3_priv_pass: description: - Privacy password for SNMPv3. - Must be at least 8 characters long. type: str peer_ips: description: - List of IP addresses which can perform SNMP queries. type: list elements: str net_name: description: - Name of network. type: str net_id: description: - ID of network. type: str access: description: - Type of SNMP access. choices: [community, none, users] type: str community_string: description: - SNMP community string. - Only relevant if C(access) is set to C(community). type: str users: description: - Information about users with access to SNMP. - Only relevant if C(access) is set to C(users). type: list elements: dict suboptions: username: description: Username of user with access. type: str passphrase: description: Passphrase for user SNMP access. type: str author: - Kevin Breit (@kbreit) extends_documentation_fragment: cisco.meraki.meraki a - name: Query SNMP values meraki_snmp: auth_key: abc12345 org_name: YourOrg state: query delegate_to: localhost - name: Enable SNMPv2 meraki_snmp: auth_key: abc12345 org_name: YourOrg state: present v2c_enabled: true delegate_to: localhost - name: Disable SNMPv2 meraki_snmp: auth_key: abc12345 org_name: YourOrg state: present v2c_enabled: false delegate_to: localhost - name: Enable SNMPv3 meraki_snmp: auth_key: abc12345 org_name: YourOrg state: present v3_enabled: true v3_auth_mode: SHA v3_auth_pass: ansiblepass v3_priv_mode: AES128 v3_priv_pass: ansiblepass peer_ips: 192.0.1.1;192.0.1.2 delegate_to: localhost - name: Set network access type to community string meraki_snmp: auth_key: abc1235 org_name: YourOrg net_name: YourNet state: present access: community community_string: abc123 delegate_to: localhost - name: Set network access type to username meraki_snmp: auth_key: abc1235 org_name: YourOrg net_name: YourNet state: present access: users users: - username: ansibleuser passphrase: ansiblepass delegate_to: localhost a data: description: Information about SNMP settings. type: complex returned: always contains: hostname: description: Hostname of SNMP server. returned: success and no network specified. type: str sample: n1.meraki.com peer_ips: description: Semi-colon delimited list of IPs which can poll SNMP information. returned: success and no network specified. type: str sample: 192.0.1.1 port: description: Port number of SNMP. returned: success and no network specified. type: str sample: 16100 v2c_enabled: description: Shows enabled state of SNMPv2c returned: success and no network specified. type: bool sample: true v3_enabled: description: Shows enabled state of SNMPv3 returned: success and no network specified. type: bool sample: true v3_auth_mode: description: The SNMP version 3 authentication mode either MD5 or SHA. returned: success and no network specified. type: str sample: SHA v3_priv_mode: description: The SNMP version 3 privacy mode DES or AES128. returned: success and no network specified. type: str sample: AES128 v2_community_string: description: Automatically generated community string for SNMPv2c. returned: When SNMPv2c is enabled and no network specified. type: str sample: o/8zd-JaSb v3_user: description: Automatically generated username for SNMPv3. returned: When SNMPv3c is enabled and no network specified. type: str sample: o/8zd-JaSb access: description: Type of SNMP access. type: str returned: success, when network specified community_string: description: SNMP community string. Only relevant if C(access) is set to C(community). type: str returned: success, when network specified users: description: Information about users with access to SNMP. Only relevant if C(access) is set to C(users). type: complex contains: username: description: Username of user with access. type: str returned: success, when network specified passphrase: description: Passphrase for user SNMP access. type: str returned: success, when network specified ) AnsibleModulejson)snake_dict_to_camel_dict) MerakiModulemeraki_argument_speccr|jd|}|j|d}|jdk(r|Sy)Nget_allorg_idGETmethod)construct_pathrequestr )merakirpathrs l/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cisco/meraki/plugins/modules/meraki_snmp.pyget_snmprsG  6 :Dt#  A}}ct}|jdd|jdi}|jddurt|jddkst|jddkr|jd |jd -|jd|jd |jd|jd |jd|jd j |jd|jd j |jdd }|jd(|jd|d<n|jddurddi}t |}|j d|}t||}gd}|j|||r|jjdur]|j|||j|||jd<d|jd<|jdi|j|j|dt!j"|}|j$dk(r#|j||d|jd<|Sy|S)N v2c_enabled v2cEnabled v3_enabledT v3_auth_pass v3_priv_passzFv3_auth_pass and v3_priv_pass must both be at least 8 characters long.msg v3_auth_mode v3_priv_modezGv3_auth_mode, v3_auth_pass, v3_priv_mode, and v3_auth_pass are required) v3Enabled v3AuthMode v3AuthPass v3PrivMode v3PrivPasspeer_ipspeerIpsFr+creater)r-r/hostnameportv2CommunityStringv3User)optional_ignoredatachangedPUTrpayloadr)dictparamslen fail_jsonupperr rris_update_requiredmodule check_mode generate_diffupdateresult exit_jsonrr dumpsr )rrr< full_comparersnmpignored_parametersrs rset_snmprNsgfG }}]#/}!= }}\"d* v}}^, - 1S~9V5WZ[5[   !i  j == ( 0 == ( 0 == ( 0 == ( 0   !j  k & l ;!'~!>!D!D!F!'~!>!'~!>!D!D!F!'~!>  == $ 0!'z!:GI  | $ -&+G4L  & 9D FF #Dh   |EW X == # #t +  | 4 KK $(FMM& !'+FMM) $ F   -v}} - NN4"'#'::g#6  8 ==C   q )'+FMM) $H  rcttdtdd}t}|jtdddgdtd td tdd d g tddtdd dg tddtdddtdgd tddtddd|tdtd t|d}t |d}d|j d<ddi}ddi}ddi}ddi}|j dj|||j d<||j d<||j d<d}|j d s!|j d!s|jd"#|j d!} | |j|j d } |j d$} | B|j d%r3|j| &} |j| |j d%| '} |j d(dk(rV| Td)|j d)i}|j d*|j d*|d+<n!|j d,|j d,|d,<|j d(dk(rc| t|| |jd-<n;|jd| .} |j| d/0} |jd1k(r| |jd-<n|j d(dk(r| t!|| |jd-<n|jd| .} |j| d/0}|j#||r|jd| .} |j| d2t%j&|3} |jd1k(rF| d)d4k(ri|jd-<n| |jd-<d|jd5<n||jd-<|j(d6i|jy)7Nstr)typeT)rQno_log)username passphrasepresentquery)rQchoicesdefaultboolSHAMD5)rQrWDESAES128list)rQrXelements)nonerusersr>)rQrXr_options) stater!r#r)r$r*r&r0accesscommunity_stringranet_namenet_id) argument_specsupports_check_moderL)functionallfollow_redirectsz/organizations/{org_id}/snmpz/networks/{net_id}/snmpr query_net_allr2 create_netorg_namerzorg_name or org_id is requiredr'rgrfr)r8rcrdrecommunityStringrar8)rgrrrr:r;r`r9r=)r>rrGr rr? url_catalogrA get_org_idget_nets get_net_idrrHrrr rNrCr rJrI) user_arg_specrhrDr query_urlsquery_net_urls update_urlsupdate_net_urlsr<rrgnetsrresponseoriginals rmainr}&s$E"2$(eD$AM)*MtG8LV_`%)v%6$(f$5&*u~&N&*d&C&*x?P&Q&*d&C"&FD5"Q $%9W X*.E$*G#Xef"&E"2 $% 0 &/3F&6 2F(-FMM$%89J78N9:K89O y!((4*8F'#.Fx '6F|$G == $V]]8-D=> ]]8 $F ~""6==#<= ]]8 $F ~&-- 3f-""66==+D4"P }}W*  x!89G}}/0<-3]];M-N)*w'3#)==#9  }}W( >$,VV$$,VV$>$udjjQXFY>Z==C')V302 f-08 f-/3FMM),(0 f%F%v}}%r__main__N) __future__rrrrQ __metaclass__ANSIBLE_METADATA DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicr r 0ansible.module_utils.common.dict_transformationsr Kansible_collections.cisco.meraki.plugins.module_utils.network.meraki.merakirrrrNr}__name__r=rrrssA@ n T l: xG R;Uz*Z]&@ zFr