cisco.meraki.devices_blink_leds module -- Resource module for devices _blink _leds

Note

This module is part of the cisco.meraki collection (version 2.20.7).

To install it, use: ansible-galaxy collection install cisco.meraki. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: cisco.meraki.devices_blink_leds.

New in cisco.meraki 2.16.0

Synopsis

• Manage operation create of the resource devices _blink _leds.

• Blink the LEDs on a device. This endpoint is deprecrated in favor of /devices/{serial}/liveTools/leds/blink.

Note

This module has a corresponding action plugin.

Requirements

The below requirements are needed on the host that executes this module.

• meraki >= 2.4.9

• python >= 3.5

Parameters

Parameter	Comments
duration integer	The duration in seconds. Must be between 5 and 120. Default is 20 seconds.
duty integer	The duty cycle as the percent active. Must be between 10 and 90. Default is 50.
meraki_action_batch_retry_wait_time integer	meraki_action_batch_retry_wait_time (integer), action batch concurrency error retry wait time Default: :ansible-option-default:`60`
meraki_api_key string / required	meraki_api_key (string), API key generated in dashboard; can also be set as an environment variable MERAKI_DASHBOARD_API_KEY
meraki_base_url string	meraki_base_url (string), preceding all endpoint resources Default: :ansible-option-default:`"https://api.meraki.com/api/v1"`
meraki_be_geo_id string	meraki_be_geo_id (string), optional partner identifier for API usage tracking; can also be set as an environment variable BE_GEO_ID Default: :ansible-option-default:`""`
meraki_certificate_path string	meraki_certificate_path (string), path for TLS/SSL certificate verification if behind local proxy Default: :ansible-option-default:`""`
meraki_inherit_logging_config boolean	meraki_inherit_logging_config (boolean), Inherits your own logger instance Choices: :ansible-option-choices-entry-default:`false` ← (default) :ansible-option-choices-entry:`true`
meraki_log_file_prefix string	meraki_log_file_prefix (string), log file name appended with date and timestamp Default: :ansible-option-default:`"meraki\_api\_"`
meraki_log_path string	log_path (string), path to output log; by default, working directory of script if not specified Default: :ansible-option-default:`""`
meraki_maximum_retries integer	meraki_maximum_retries (integer), retry up to this many times when encountering 429s or other server-side errors Default: :ansible-option-default:`2`
meraki_nginx_429_retry_wait_time integer	meraki_nginx_429_retry_wait_time (integer), Nginx 429 retry wait time Default: :ansible-option-default:`60`
meraki_output_log boolean	meraki_output_log (boolean), create an output log file? Choices: :ansible-option-choices-entry:`false` :ansible-option-choices-entry-default:`true` ← (default)
meraki_print_console boolean	meraki_print_console (boolean), print logging output to console? Choices: :ansible-option-choices-entry:`false` :ansible-option-choices-entry-default:`true` ← (default)
meraki_requests_proxy string	meraki_requests_proxy (string), proxy server and port, if needed, for HTTPS Default: :ansible-option-default:`""`
meraki_retry_4xx_error boolean	meraki_retry_4xx_error (boolean), retry if encountering other 4XX error (besides 429)? Choices: :ansible-option-choices-entry-default:`false` ← (default) :ansible-option-choices-entry:`true`
meraki_retry_4xx_error_wait_time integer	meraki_retry_4xx_error_wait_time (integer), other 4XX error retry wait time Default: :ansible-option-default:`60`
meraki_simulate boolean	meraki_simulate (boolean), simulate POST/PUT/DELETE calls to prevent changes? Choices: :ansible-option-choices-entry-default:`false` ← (default) :ansible-option-choices-entry:`true`
meraki_single_request_timeout integer	meraki_single_request_timeout (integer), maximum number of seconds for each API call Default: :ansible-option-default:`60`
meraki_suppress_logging boolean	meraki_suppress_logging (boolean), disable all logging? you're on your own then! Choices: :ansible-option-choices-entry-default:`false` ← (default) :ansible-option-choices-entry:`true`
meraki_use_iterator_for_get_pages boolean	meraki_use_iterator_for_get_pages (boolean), list* methods will return an iterator with each object instead of a complete list with all items Choices: :ansible-option-choices-entry-default:`false` ← (default) :ansible-option-choices-entry:`true`
meraki_wait_on_rate_limit boolean	meraki_wait_on_rate_limit (boolean), retry if 429 rate limit error encountered? Choices: :ansible-option-choices-entry:`false` :ansible-option-choices-entry-default:`true` ← (default)
period integer	The period in milliseconds. Must be between 100 and 1000. Default is 160 milliseconds.
serial string	Serial path parameter.

Notes

Note

• SDK Method used are devices.Devices.blink_device_leds,

• Paths used are post /devices/{serial}/blinkLeds,

• Does not support check_mode

• The plugin runs on the control node and does not use any ansible connection plugins, but instead the embedded connection manager

• from Cisco Dashboard API Python(SDK)

• The parameters starting with dnac_ are used by the Cisco DNAC Python SDK to establish the connection

See Also

See also

Cisco Meraki documentation for devices blinkDeviceLeds

Complete reference of the blinkDeviceLeds API.

Examples

- name: Create
  cisco.meraki.devices_blink_leds:
    meraki_api_key: '{{ meraki_api_key }}'
    meraki_base_url: '{{ meraki_base_url }}'
    meraki_single_request_timeout: '{{ meraki_single_request_timeout }}'
    meraki_certificate_path: '{{ meraki_certificate_path }}'
    meraki_requests_proxy: '{{ meraki_requests_proxy }}'
    meraki_wait_on_rate_limit: '{{ meraki_wait_on_rate_limit }}'
    meraki_nginx_429_retry_wait_time: '{{ meraki_nginx_429_retry_wait_time }}'
    meraki_action_batch_retry_wait_time: '{{ meraki_action_batch_retry_wait_time }}'
    meraki_retry_4xx_error: '{{ meraki_retry_4xx_error }}'
    meraki_retry_4xx_error_wait_time: '{{ meraki_retry_4xx_error_wait_time }}'
    meraki_maximum_retries: '{{ meraki_maximum_retries }}'
    meraki_output_log: '{{ meraki_output_log }}'
    meraki_log_file_prefix: '{{ meraki_log_file_prefix }}'
    meraki_log_path: '{{ meraki_log_path }}'
    meraki_print_console: '{{ meraki_print_console }}'
    meraki_suppress_logging: '{{ meraki_suppress_logging }}'
    meraki_simulate: '{{ meraki_simulate }}'
    meraki_be_geo_id: '{{ meraki_be_geo_id }}'
    meraki_use_iterator_for_get_pages: '{{ meraki_use_iterator_for_get_pages }}'
    meraki_inherit_logging_config: '{{ meraki_inherit_logging_config }}'
    duration: 20
    duty: 50
    period: 160
    serial: string

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Description
meraki_response dictionary	A dictionary or list with the response returned by the Cisco Meraki Python SDK Returned: always Sample: :ansible-rv-sample-value:`{"duration": 0, "duty": 0, "period": 0}`

Authors

• Francisco Munoz (@fmunoz)

Collection links

Issue Tracker Repository (Sources)