.. Document meta :orphan: .. |antsibull-internal-nbsp| unicode:: 0xA0 :trim: .. role:: ansible-attribute-support-label .. role:: ansible-attribute-support-property .. role:: ansible-attribute-support-full .. role:: ansible-attribute-support-partial .. role:: ansible-attribute-support-none .. role:: ansible-attribute-support-na .. role:: ansible-option-type .. role:: ansible-option-elements .. role:: ansible-option-required .. role:: ansible-option-versionadded .. role:: ansible-option-aliases .. role:: ansible-option-choices .. role:: ansible-option-choices-default-mark .. role:: ansible-option-default-bold .. role:: ansible-option-configuration .. role:: ansible-option-returned-bold .. role:: ansible-option-sample-bold .. Anchors .. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module: .. Anchors: short name for ansible.builtin .. Anchors: aliases .. Title cisco.meraki.networks_wireless_ssids_splash_settings module -- Resource module for networks \_wireless \_ssids \_splash \_settings ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ .. Collection note .. note:: This module is part of the `cisco.meraki collection `_ (version 2.20.8). To install it, use: :code:`ansible-galaxy collection install cisco.meraki`. You need further requirements to be able to use this module, see :ref:`Requirements ` for details. To use it in a playbook, specify: :code:`cisco.meraki.networks_wireless_ssids_splash_settings`. .. version_added .. rst-class:: ansible-version-added New in cisco.meraki 2.16.0 .. contents:: :local: :depth: 1 .. Deprecated Synopsis -------- .. Description - Manage operation update of the resource networks \_wireless \_ssids \_splash \_settings. - Modify the splash page settings for the given SSID. .. note:: This module has a corresponding :ref:`action plugin `. .. Aliases .. Requirements .. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module_requirements: Requirements ------------ The below requirements are needed on the host that executes this module. - meraki \>= 2.4.9 - python \>= 3.5 .. Options Parameters ---------- .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Parameter - Comments * - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-allowsimultaneouslogins: .. rst-class:: ansible-option-title **allowSimultaneousLogins** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Whether or not to allow simultaneous logins from different devices. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-billing: .. rst-class:: ansible-option-title **billing** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Details associated with billing splash. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-billing/freeaccess: .. rst-class:: ansible-option-title **freeAccess** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Details associated with a free access plan with limits. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-billing/freeaccess/durationinminutes: .. rst-class:: ansible-option-title **durationInMinutes** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
How long a device can use a network for free. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-billing/freeaccess/enabled: .. rst-class:: ansible-option-title **enabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Whether or not free access is enabled. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-billing/prepaidaccessfastloginenabled: .. rst-class:: ansible-option-title **prepaidAccessFastLoginEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Whether or not billing uses the fast login prepaid access option. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-billing/replytoemailaddress: .. rst-class:: ansible-option-title **replyToEmailAddress** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The email address that receives replies from clients. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-blockalltrafficbeforesignon: .. rst-class:: ansible-option-title **blockAllTrafficBeforeSignOn** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
How restricted allowing traffic should be. If true, all traffic types are blocked until the splash page is acknowledged. If false, all non-HTTP traffic is allowed before the splash page is acknowledged. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-controllerdisconnectionbehavior: .. rst-class:: ansible-option-title **controllerDisconnectionBehavior** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
How login attempts should be handled when the controller is unreachable. Can be either 'open', 'restricted', or 'default'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-guestsponsorship: .. rst-class:: ansible-option-title **guestSponsorship** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Details associated with guest sponsored splash. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-guestsponsorship/durationinminutes: .. rst-class:: ansible-option-title **durationInMinutes** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Duration in minutes of sponsored guest authorization. Must be between 1 and 60480 (6 weeks). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-guestsponsorship/guestcanrequesttimeframe: .. rst-class:: ansible-option-title **guestCanRequestTimeframe** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Whether or not guests can specify how much time they are requesting. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_action_batch_retry_wait_time: .. rst-class:: ansible-option-title **meraki_action_batch_retry_wait_time** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
meraki\_action\_batch\_retry\_wait\_time (integer), action batch concurrency error retry wait time .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`60` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_api_key: .. rst-class:: ansible-option-title **meraki_api_key** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
meraki\_api\_key (string), API key generated in dashboard; can also be set as an environment variable MERAKI\_DASHBOARD\_API\_KEY .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_base_url: .. rst-class:: ansible-option-title **meraki_base_url** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
meraki\_base\_url (string), preceding all endpoint resources .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"https://api.meraki.com/api/v1"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_be_geo_id: .. rst-class:: ansible-option-title **meraki_be_geo_id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
meraki\_be\_geo\_id (string), optional partner identifier for API usage tracking; can also be set as an environment variable BE\_GEO\_ID .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`""` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_certificate_path: .. rst-class:: ansible-option-title **meraki_certificate_path** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
meraki\_certificate\_path (string), path for TLS/SSL certificate verification if behind local proxy .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`""` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_inherit_logging_config: .. rst-class:: ansible-option-title **meraki_inherit_logging_config** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
meraki\_inherit\_logging\_config (boolean), Inherits your own logger instance .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_log_file_prefix: .. rst-class:: ansible-option-title **meraki_log_file_prefix** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
meraki\_log\_file\_prefix (string), log file name appended with date and timestamp .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"meraki\_api\_"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_log_path: .. rst-class:: ansible-option-title **meraki_log_path** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
log\_path (string), path to output log; by default, working directory of script if not specified .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`""` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_maximum_retries: .. rst-class:: ansible-option-title **meraki_maximum_retries** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
meraki\_maximum\_retries (integer), retry up to this many times when encountering 429s or other server-side errors .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`2` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_nginx_429_retry_wait_time: .. rst-class:: ansible-option-title **meraki_nginx_429_retry_wait_time** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
meraki\_nginx\_429\_retry\_wait\_time (integer), Nginx 429 retry wait time .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`60` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_output_log: .. rst-class:: ansible-option-title **meraki_output_log** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
meraki\_output\_log (boolean), create an output log file? .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_print_console: .. rst-class:: ansible-option-title **meraki_print_console** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
meraki\_print\_console (boolean), print logging output to console? .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_requests_proxy: .. rst-class:: ansible-option-title **meraki_requests_proxy** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
meraki\_requests\_proxy (string), proxy server and port, if needed, for HTTPS .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`""` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_retry_4xx_error: .. rst-class:: ansible-option-title **meraki_retry_4xx_error** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
meraki\_retry\_4xx\_error (boolean), retry if encountering other 4XX error (besides 429)? .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_retry_4xx_error_wait_time: .. rst-class:: ansible-option-title **meraki_retry_4xx_error_wait_time** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
meraki\_retry\_4xx\_error\_wait\_time (integer), other 4XX error retry wait time .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`60` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_simulate: .. rst-class:: ansible-option-title **meraki_simulate** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
meraki\_simulate (boolean), simulate POST/PUT/DELETE calls to prevent changes? .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_single_request_timeout: .. rst-class:: ansible-option-title **meraki_single_request_timeout** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
meraki\_single\_request\_timeout (integer), maximum number of seconds for each API call .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`60` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_suppress_logging: .. rst-class:: ansible-option-title **meraki_suppress_logging** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
meraki\_suppress\_logging (boolean), disable all logging? you're on your own then! .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_use_iterator_for_get_pages: .. rst-class:: ansible-option-title **meraki_use_iterator_for_get_pages** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
meraki\_use\_iterator\_for\_get\_pages (boolean), list\* methods will return an iterator with each object instead of a complete list with all items .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-meraki_wait_on_rate_limit: .. rst-class:: ansible-option-title **meraki_wait_on_rate_limit** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
meraki\_wait\_on\_rate\_limit (boolean), retry if 429 rate limit error encountered? .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-networkid: .. rst-class:: ansible-option-title **networkId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
NetworkId path parameter. Network ID. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-number: .. rst-class:: ansible-option-title **number** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Number path parameter. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-redirecturl: .. rst-class:: ansible-option-title **redirectUrl** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The custom redirect URL where the users will go after the splash page. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-sentryenrollment: .. rst-class:: ansible-option-title **sentryEnrollment** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Systems Manager sentry enrollment splash settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-sentryenrollment/enforcedsystems: .. rst-class:: ansible-option-title **enforcedSystems** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
The system types that the Sentry enforces. Must be included in 'iOS, 'Android', 'macOS', and 'Windows'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-sentryenrollment/strength: .. rst-class:: ansible-option-title **strength** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The strength of the enforcement of selected system types. Must be one of 'focused', 'click-through', and 'strict'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-sentryenrollment/systemsmanagernetwork: .. rst-class:: ansible-option-title **systemsManagerNetwork** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Systems Manager network targeted for sentry enrollment. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-sentryenrollment/systemsmanagernetwork/id: .. rst-class:: ansible-option-title **id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The network ID of the Systems Manager network. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashimage: .. rst-class:: ansible-option-title **splashImage** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
The image used in the splash page. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashimage/extension: .. rst-class:: ansible-option-title **extension** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The extension of the image file. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashimage/image: .. rst-class:: ansible-option-title **image** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Properties for setting a new image. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashimage/image/contents: .. rst-class:: ansible-option-title **contents** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The file contents (a base 64 encoded string) of your new image. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashimage/image/format: .. rst-class:: ansible-option-title **format** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The format of the encoded contents. Supported formats are 'png', 'gif', and jpg'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashimage/md5: .. rst-class:: ansible-option-title **md5** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The MD5 value of the image file. Setting this to null will remove the image from the splash page. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashlogo: .. rst-class:: ansible-option-title **splashLogo** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
The logo used in the splash page. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashlogo/extension: .. rst-class:: ansible-option-title **extension** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The extension of the logo file. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashlogo/image: .. rst-class:: ansible-option-title **image** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Properties for setting a new image. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashlogo/image/contents: .. rst-class:: ansible-option-title **contents** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The file contents (a base 64 encoded string) of your new logo. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashlogo/image/format: .. rst-class:: ansible-option-title **format** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The format of the encoded contents. Supported formats are 'png', 'gif', and jpg'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashlogo/md5: .. rst-class:: ansible-option-title **md5** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The MD5 value of the logo file. Setting this to null will remove the logo from the splash page. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashprepaidfront: .. rst-class:: ansible-option-title **splashPrepaidFront** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
The prepaid front image used in the splash page. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashprepaidfront/extension: .. rst-class:: ansible-option-title **extension** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The extension of the prepaid front image file. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashprepaidfront/image: .. rst-class:: ansible-option-title **image** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Properties for setting a new image. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashprepaidfront/image/contents: .. rst-class:: ansible-option-title **contents** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The file contents (a base 64 encoded string) of your new prepaid front. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashprepaidfront/image/format: .. rst-class:: ansible-option-title **format** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The format of the encoded contents. Supported formats are 'png', 'gif', and jpg'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashprepaidfront/md5: .. rst-class:: ansible-option-title **md5** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The MD5 value of the prepaid front image file. Setting this to null will remove the prepaid front from the splash page. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashtimeout: .. rst-class:: ansible-option-title **splashTimeout** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Splash timeout in minutes. This will determine how often users will see the splash page. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-splashurl: .. rst-class:: ansible-option-title **splashUrl** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Optional The custom splash URL of the click-through splash page. Note that the URL can be configured without necessarily being used. In order to enable the custom URL, see 'useSplashUrl'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-themeid: .. rst-class:: ansible-option-title **themeId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The id of the selected splash theme. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-useredirecturl: .. rst-class:: ansible-option-title **useRedirectUrl** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
The Boolean indicating whether the the user will be redirected to the custom redirect URL after the splash page. A custom redirect URL must be set if this is true. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-usesplashurl: .. rst-class:: ansible-option-title **useSplashUrl** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Optional Boolean indicating whether the users will be redirected to the custom splash url. A custom splash URL must be set if this is true. Note that depending on your SSID's access control settings, it may not be possible to use the custom splash URL. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__parameter-welcomemessage: .. rst-class:: ansible-option-title **welcomeMessage** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The welcome message for the users on the splash page. .. raw:: html
.. Attributes .. Notes Notes ----- .. note:: - SDK Method used are wireless.Wireless.update\_network\_wireless\_ssid\_splash\_settings, - Paths used are put /networks/{networkId}/wireless/ssids/{number}/splash/settings, - Does not support \ :literal:`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 .. Seealso See Also -------- .. seealso:: `Cisco Meraki documentation for wireless updateNetworkWirelessSsidSplashSettings `_ Complete reference of the updateNetworkWirelessSsidSplashSettings API. .. Examples Examples -------- .. code-block:: yaml+jinja - name: Update all cisco.meraki.networks_wireless_ssids_splash_settings: 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 }}' state: present allowSimultaneousLogins: false billing: freeAccess: durationInMinutes: 120 enabled: true prepaidAccessFastLoginEnabled: true replyToEmailAddress: user@email.com blockAllTrafficBeforeSignOn: false controllerDisconnectionBehavior: default guestSponsorship: durationInMinutes: 30 guestCanRequestTimeframe: false networkId: string number: string redirectUrl: https://example.com sentryEnrollment: enforcedSystems: - iOS strength: focused systemsManagerNetwork: id: N_1234 splashImage: extension: jpg image: contents: Q2lzY28gTWVyYWtp format: jpg md5: 542cccac8d7dedee0f185311d154d194 splashLogo: extension: jpg image: contents: Q2lzY28gTWVyYWtp format: jpg md5: abcd1234 splashPrepaidFront: extension: jpg image: contents: Q2lzY28gTWVyYWtp format: jpg md5: 542cccac8d7dedee0f185311d154d194 splashTimeout: 1440 splashUrl: https://www.custom_splash_url.com themeId: c3ddcb4f16785ee747ab5ffc10867d6c8ea704be useRedirectUrl: true useSplashUrl: true welcomeMessage: Welcome! .. Facts .. Return values Return Values ------------- Common return values are documented :ref:`here `, the following are the fields unique to this module: .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Key - Description * - .. raw:: html
.. _ansible_collections.cisco.meraki.networks_wireless_ssids_splash_settings_module__return-meraki_response: .. rst-class:: ansible-option-title **meraki_response** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
A dictionary or list with the response returned by the Cisco Meraki Python SDK .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` always .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`{"allowSimultaneousLogins": true, "billing": {"freeAccess": {"durationInMinutes": 0, "enabled": true}, "prepaidAccessFastLoginEnabled": true, "replyToEmailAddress": "string"}, "blockAllTrafficBeforeSignOn": true, "controllerDisconnectionBehavior": "string", "guestSponsorship": {"durationInMinutes": 0, "guestCanRequestTimeframe": true}, "redirectUrl": "string", "selfRegistration": {"authorizationType": "string", "enabled": true}, "sentryEnrollment": {"enforcedSystems": ["string"], "strength": "string", "systemsManagerNetwork": {"id": "string"}}, "splashImage": {"extension": "string", "md5": "string"}, "splashLogo": {"extension": "string", "md5": "string"}, "splashPage": "string", "splashPrepaidFront": {"extension": "string", "md5": "string"}, "splashTimeout": 0, "splashUrl": "string", "ssidNumber": 0, "themeId": "string", "useRedirectUrl": true, "useSplashUrl": true, "welcomeMessage": "string"}` .. raw:: html
.. Status (Presently only deprecated) .. Authors Authors ~~~~~~~ - Francisco Munoz (@fmunoz) .. Extra links Collection links ~~~~~~~~~~~~~~~~ .. raw:: html .. Parsing errors