Vh(ddlmZmZmZeZdZdZddlm Z m Z ddl m Z m Z ddlmZmZddlmZddlmZe Z e j*eed d  Gd de e Zy))absolute_importdivisionprint_functionab name: meraki author: - Nilashish Chakraborty (@NilashishC) short_description: Ansible dynamic inventory plugin for Cisco Meraki devices. requirements: - meraki extends_documentation_fragment: - constructed description: - Build inventories using the Cisco Meraki API. - Uses a YAML configuration file cisco_meraki.[yml|yaml]. options: meraki_org_id: description: - The organization ID to fetch the networks and devices from. type: str required: true meraki_api_key: description: - meraki_api_key (string), API key generated in dashboard; can also be set as an environment variable MERAKI_DASHBOARD_API_KEY type: str meraki_base_url: description: - meraki_base_url (string), preceding all endpoint resources type: str default: https://api.meraki.com/api/v1 meraki_single_request_timeout: description: - meraki_single_request_timeout (integer), maximum number of seconds for each API call type: int default: 60 meraki_certificate_path: description: - meraki_certificate_path (string), path for TLS/SSL certificate verification if behind local proxy type: str default: '' meraki_requests_proxy: description: - meraki_requests_proxy (string), proxy server and port, if needed, for HTTPS type: str default: '' meraki_wait_on_rate_limit: description: - meraki_wait_on_rate_limit (boolean), retry if 429 rate limit error encountered? type: bool default: true meraki_nginx_429_retry_wait_time: description: - meraki_nginx_429_retry_wait_time (integer), Nginx 429 retry wait time type: int default: 60 meraki_action_batch_retry_wait_time: description: - meraki_action_batch_retry_wait_time (integer), action batch concurrency error retry wait time type: int default: 60 meraki_retry_4xx_error: description: - meraki_retry_4xx_error (boolean), retry if encountering other 4XX error (besides 429)? type: bool default: false meraki_retry_4xx_error_wait_time: description: - meraki_retry_4xx_error_wait_time (integer), other 4XX error retry wait time type: int default: 60 meraki_maximum_retries: description: - meraki_maximum_retries (integer), retry up to this many times when encountering 429s or other server-side errors type: int default: 2 meraki_output_log: description: - meraki_output_log (boolean), create an output log file? type: bool default: true meraki_log_file_prefix: description: - meraki_log_file_prefix (string), log file name appended with date and timestamp type: str default: meraki_api_ meraki_log_path: description: - log_path (string), path to output log; by default, working directory of script if not specified type: str default: '' meraki_print_console: description: - meraki_print_console (boolean), print logging output to console? type: bool default: true meraki_suppress_logging: description: - meraki_suppress_logging (boolean), disable all logging? you're on your own then! type: bool default: false meraki_simulate: description: - meraki_simulate (boolean), simulate POST/PUT/DELETE calls to prevent changes? type: bool default: false meraki_be_geo_id: description: - meraki_be_geo_id (string), optional partner identifier for API usage tracking; can also be set as an environment variable BE_GEO_ID type: str default: '' meraki_use_iterator_for_get_pages: description: - meraki_use_iterator_for_get_pages (boolean), list* methods will return an iterator with each object instead of a complete list with all items type: bool default: false meraki_inherit_logging_config: description: - meraki_inherit_logging_config (boolean), Inherits your own logger instance type: bool default: false a # cisco_meraki.yml --- plugin: cisco.meraki.meraki meraki_api_key: "" meraki_org_id: "" keyed_groups: # group devices based on network ID - prefix: meraki_network_id key: network_id # group devices based on network name - prefix: meraki_network key: network # group devices based on device type - prefix: meraki_device_type key: device_type # group devices based on meraki device tag - prefix: meraki_tag key: tags )MERAKImeraki_argument_spec)BaseInventoryPlugin Constructable) to_nativeto_text)ArgumentSpecValidator) AnsibleErrorstrT)typerequired) meraki_org_idc:eZdZdZfdZdZdZdfd ZxZS)InventoryModulezcisco.meraki.merakicXd}tt| |r|jdrd}|S)zMreturn true/false if this is possibly a valid file for this plugin to consumeF)zcisco_meraki.yamlzcisco_meraki.ymlT)superr verify_fileendswith)selfpathvalid __class__s i/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cisco/meraki/plugins/inventory/meraki.pyrzInventoryModule.verify_files. $ 3D 9}}FG ci}|jdd|dd}|D]#}t|jdd||d<%|S) z7Build a dictionary mapping network ID to network names. organizationsgetOrganizationNetworksallorganizationId total_pagesfamilyfunctionparamsnameid) exec_merakir get)r dashboardorg_id network_mapnetworksnetworks r_build_network_mapz"InventoryModule._build_network_mapsc ((".&,UC)    JG)0VR1H)IK & Jrctt}|j|}|jr't ddj |j|j S)z&Validate the inventory plugin argspec.zValidation failed: z, )r rvalidateerror_messagesr joinvalidated_parameters)r parametersargspec_validatorresults r_validate_argspecz!InventoryModule._validate_argspecs^12FG"++J7  %dii0E0E&F%GHJ J***rctt| |||||j|}|Dcic]}|tvs |||}}|j |}|j d} |jd} t|} | jdd| dd } | r|j| | } | D]}|jd }|s&|jjd |d |d }|jj|d |jdrD|jj!|d|d|jj!|d| |dn|jj#d|d|jdr!|jj!|d|dn|jjd|d|jj!|d|d|jj!|d|d|jj!|d|d |j%|jd||d|j'|jd||| |j)|jd ||| !y#y#cc}w#t*$r}t-d"t/|d#}~wwxYw)$z/Talk to the Meraki API and build the inventory.)r9rstrict)r(rgetOrganizationDevicesr!r"r%r)z No name set for device with MAC mac)group networkId network_idr2zDevice z" is not associated with a network.lanIp ansible_hostzNo lanIp found for device with z<. The `ansible_host` variable will not be set for this host. device_typemodelansible_product_serialserial macaddresscomposeT)r>groups keyed_groups)keys variableshostr>z'Failed to get devices from Meraki API: N)rrparse_read_config_datarr<pop get_optionrr,r3r-displaywarning inventoryadd_host set_variablevvvv_set_composite_vars_add_host_to_composed_groups_add_host_to_keyed_groups Exceptionr r )rrWloaderrcacheconfigkmeraki_connect_configvalidated_configrr>r.devicesr0devicehostnameers rrQzInventoryModule.parses ot*9fdEJ''-"(! A1E,EAvayL! !  11,2.),,_= *"23 B J++&1*7N,G "55iO %6F%zz&1H# ,,>ve}oN$*%=NN++HE+Bzz+.33$lF;4G33$iVK=P1Q ))%hZ/QRzz'*33$nfWo ,,=hZHZZ NN// -NN// ":F8rzsu CB u n *IJF',-t679zJ)=zJr