.. 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.meraki_mr_ssid_module: .. Anchors: short name for ansible.builtin .. Anchors: aliases .. Title cisco.meraki.meraki_mr_ssid module -- Manage wireless SSIDs in the Meraki cloud +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ .. Collection note .. note:: This module is part of the `cisco.meraki collection `_ (version 2.20.7). To install it, use: :code:`ansible-galaxy collection install cisco.meraki`. To use it in a playbook, specify: :code:`cisco.meraki.meraki_mr_ssid`. .. version_added .. contents:: :local: :depth: 1 .. Deprecated DEPRECATED ---------- :Removed in: version 3.0.0 :Why: Updated modules released with increased functionality :Alternative: cisco.meraki.networks\_wireless\_ssids Synopsis -------- .. Description - Allows for management of SSIDs in a Meraki wireless environment. .. Aliases .. Requirements .. Options Parameters ---------- .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Parameter - Comments * - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-ap_availability_tags: .. rst-class:: ansible-option-title **ap_availability_tags** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
Set whether SSID will be broadcast by APs with tags matching any of the tags in this list. Requires \ :literal:`available\_on\_all\_aps`\ to be \ :literal:`false`\ . .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-ap_tags_vlan_ids: .. rst-class:: ansible-option-title **ap_tags_vlan_ids** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
List of VLAN tags. Requires \ :literal:`ip\_assignment\_mode`\ to be \ :literal:`Bridge mode`\ or \ :literal:`Layer 3 roaming`\ . Requires \ :literal:`use\_vlan\_tagging`\ to be \ :literal:`True`\ . .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-ap_tags_vlan_ids/tags: .. rst-class:: ansible-option-title **tags** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of AP tags. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-ap_tags_vlan_ids/vlan_id: .. rst-class:: ansible-option-title **vlan_id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Numerical identifier that is assigned to the VLAN. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-auth_key: .. rst-class:: ansible-option-title **auth_key** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
Authentication key provided by the dashboard. Required if environmental variable \ :literal:`MERAKI\_KEY`\ is not set. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-auth_mode: .. rst-class:: ansible-option-title **auth_mode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Set authentication mode of network. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"open"` - :ansible-option-choices-entry:`"psk"` - :ansible-option-choices-entry:`"open-with-radius"` - :ansible-option-choices-entry:`"8021x-meraki"` - :ansible-option-choices-entry:`"8021x-radius"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-available_on_all_aps: .. rst-class:: ansible-option-title **available_on_all_aps** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Set whether all APs should broadcast the SSID or if it should be restricted to APs matching any availability tags. Requires \ :literal:`ap\_availability\_tags`\ to be defined when set to \ :literal:`False`\ . .. 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.meraki_mr_ssid_module__parameter-band_selection: .. rst-class:: ansible-option-title **band_selection** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Set band selection mode. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"Dual band operation"` - :ansible-option-choices-entry:`"5 GHz band only"` - :ansible-option-choices-entry:`"Dual band operation with Band Steering"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-concentrator_network_id: .. rst-class:: ansible-option-title **concentrator_network_id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The concentrator to use for 'Layer 3 roaming with a concentrator' or 'VPN'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-default_vlan_id: .. rst-class:: ansible-option-title **default_vlan_id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Default VLAN ID. Requires \ :literal:`ip\_assignment\_mode`\ to be \ :literal:`Bridge mode`\ or \ :literal:`Layer 3 roaming`\ . .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-enabled: .. rst-class:: ansible-option-title **enabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enable or disable SSID network. .. 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.meraki_mr_ssid_module__parameter-encryption_mode: .. rst-class:: ansible-option-title **encryption_mode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Set encryption mode of network. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"wpa"` - :ansible-option-choices-entry:`"eap"` - :ansible-option-choices-entry:`"wpa-eap"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-enterprise_admin_access: .. rst-class:: ansible-option-title **enterprise_admin_access** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Whether SSID is accessible by enterprise administrators. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"access disabled"` - :ansible-option-choices-entry:`"access enabled"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-host: .. rst-class:: ansible-option-title **host** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Hostname for Meraki dashboard. Can be used to access regional Meraki environments, such as China. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"api.meraki.com"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-internal_error_retry_time: .. rst-class:: ansible-option-title **internal_error_retry_time** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Number of seconds to retry if server returns an internal server error. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`60` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-ip_assignment_mode: .. rst-class:: ansible-option-title **ip_assignment_mode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Method of which SSID uses to assign IP addresses. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"NAT mode"` - :ansible-option-choices-entry:`"Bridge mode"` - :ansible-option-choices-entry:`"Layer 3 roaming"` - :ansible-option-choices-entry:`"Layer 3 roaming with a concentrator"` - :ansible-option-choices-entry:`"VPN"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-lan_isolation_enabled: .. rst-class:: ansible-option-title **lan_isolation_enabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enable or disable Layer 2 Lan isolation. Requires \ :literal:`ip\_assignment\_mode`\ to be \ :literal:`Bridge mode`\ . .. 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.meraki_mr_ssid_module__parameter-min_bitrate: .. rst-class:: ansible-option-title **min_bitrate** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`float` .. raw:: html
- .. raw:: html
Minimum bitrate (Mbps) allowed on SSID. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`1.0` - :ansible-option-choices-entry:`2.0` - :ansible-option-choices-entry:`5.5` - :ansible-option-choices-entry:`6.0` - :ansible-option-choices-entry:`9.0` - :ansible-option-choices-entry:`11.0` - :ansible-option-choices-entry:`12.0` - :ansible-option-choices-entry:`18.0` - :ansible-option-choices-entry:`24.0` - :ansible-option-choices-entry:`36.0` - :ansible-option-choices-entry:`48.0` - :ansible-option-choices-entry:`54.0` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-name: .. rst-class:: ansible-option-title **name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of SSID. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-net_id: .. rst-class:: ansible-option-title **net_id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
ID of network. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-net_name: .. rst-class:: ansible-option-title **net_name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of network. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-number: .. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-ssid_number: .. rst-class:: ansible-option-title **number** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: ssid_number` .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
SSID number within network. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-org_id: .. rst-class:: ansible-option-title **org_id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
ID of organization. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-org_name: .. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-organization: .. rst-class:: ansible-option-title **org_name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: organization` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of organization. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-output_format: .. rst-class:: ansible-option-title **output_format** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Instructs module whether response keys should be snake case (ex. \ :literal:`net\_id`\ ) or camel case (ex. \ :literal:`netId`\ ). .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`"snakecase"` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`"camelcase"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-output_level: .. rst-class:: ansible-option-title **output_level** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Set amount of debug output during module execution. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"debug"` - :ansible-option-choices-entry-default:`"normal"` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-per_client_bandwidth_limit_down: .. rst-class:: ansible-option-title **per_client_bandwidth_limit_down** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Maximum bandwidth in Mbps devices on SSID can download. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-per_client_bandwidth_limit_up: .. rst-class:: ansible-option-title **per_client_bandwidth_limit_up** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Maximum bandwidth in Mbps devices on SSID can upload. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-psk: .. rst-class:: ansible-option-title **psk** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Password for wireless network. Requires auth\_mode to be set to psk. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-radius_accounting_enabled: .. rst-class:: ansible-option-title **radius_accounting_enabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enable or disable RADIUS accounting. .. 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.meraki_mr_ssid_module__parameter-radius_accounting_servers: .. rst-class:: ansible-option-title **radius_accounting_servers** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
List of RADIUS servers for RADIUS accounting. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-radius_accounting_servers/host: .. rst-class:: ansible-option-title **host** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
IP address or hostname of RADIUS server. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-radius_accounting_servers/port: .. rst-class:: ansible-option-title **port** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Port number RADIUS server is listening to. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-radius_accounting_servers/secret: .. rst-class:: ansible-option-title **secret** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
RADIUS password. Setting password is not idempotent. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-radius_coa_enabled: .. rst-class:: ansible-option-title **radius_coa_enabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enable or disable RADIUS CoA (Change of Authorization) on SSID. .. 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.meraki_mr_ssid_module__parameter-radius_failover_policy: .. rst-class:: ansible-option-title **radius_failover_policy** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Set client access policy in case RADIUS servers aren't available. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"Deny access"` - :ansible-option-choices-entry:`"Allow access"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-radius_load_balancing_policy: .. rst-class:: ansible-option-title **radius_load_balancing_policy** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Set load balancing policy when multiple RADIUS servers are specified. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"Strict priority order"` - :ansible-option-choices-entry:`"Round robin"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-radius_proxy_enabled: .. rst-class:: ansible-option-title **radius_proxy_enabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enable or disable RADIUS Proxy on SSID. .. 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.meraki_mr_ssid_module__parameter-radius_servers: .. rst-class:: ansible-option-title **radius_servers** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
List of RADIUS servers. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-radius_servers/host: .. rst-class:: ansible-option-title **host** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
IP address or hostname of RADIUS server. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-radius_servers/port: .. rst-class:: ansible-option-title **port** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Port number RADIUS server is listening to. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-radius_servers/secret: .. rst-class:: ansible-option-title **secret** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
RADIUS password. Setting password is not idempotent. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-rate_limit_retry_time: .. rst-class:: ansible-option-title **rate_limit_retry_time** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Number of seconds to retry if rate limiter is triggered. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`165` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-splash_guest_sponsor_domains: .. rst-class:: ansible-option-title **splash_guest_sponsor_domains** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of valid sponsor email domains for sponsored guest portal. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-splash_page: .. rst-class:: ansible-option-title **splash_page** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Set to enable splash page and specify type of splash. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"None"` - :ansible-option-choices-entry:`"Click-through splash page"` - :ansible-option-choices-entry:`"Billing"` - :ansible-option-choices-entry:`"Password-protected with Meraki RADIUS"` - :ansible-option-choices-entry:`"Password-protected with custom RADIUS"` - :ansible-option-choices-entry:`"Password-protected with Active Directory"` - :ansible-option-choices-entry:`"Password-protected with LDAP"` - :ansible-option-choices-entry:`"SMS authentication"` - :ansible-option-choices-entry:`"Systems Manager Sentry"` - :ansible-option-choices-entry:`"Facebook Wi-Fi"` - :ansible-option-choices-entry:`"Google OAuth"` - :ansible-option-choices-entry:`"Sponsored guest"` - :ansible-option-choices-entry:`"Cisco ISE"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-state: .. rst-class:: ansible-option-title **state** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Specifies whether SNMP information should be queried or modified. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"absent"` - :ansible-option-choices-entry:`"query"` - :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-timeout: .. rst-class:: ansible-option-title **timeout** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Time to timeout for HTTP requests. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`30` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-use_https: .. rst-class:: ansible-option-title **use_https** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
If \ :literal:`no`\ , it will use HTTP. Otherwise it will use HTTPS. Only useful for internal Meraki developers. .. 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.meraki_mr_ssid_module__parameter-use_proxy: .. rst-class:: ansible-option-title **use_proxy** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
If \ :literal:`no`\ , it will not use a proxy, even if one is defined in an environment variable on the target hosts. .. 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.meraki_mr_ssid_module__parameter-use_vlan_tagging: .. rst-class:: ansible-option-title **use_vlan_tagging** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Set whether to use VLAN tagging. Requires \ :literal:`default\_vlan\_id`\ to be set. .. 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.meraki_mr_ssid_module__parameter-validate_certs: .. rst-class:: ansible-option-title **validate_certs** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Whether to validate HTTP certificates. .. 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.meraki_mr_ssid_module__parameter-visible: .. rst-class:: ansible-option-title **visible** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enable or disable whether APs should broadcast this SSID. .. 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.meraki_mr_ssid_module__parameter-vlan_id: .. rst-class:: ansible-option-title **vlan_id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
ID number of VLAN on SSID. Requires \ :literal:`ip\_assignment\_mode`\ to be \ :literal:`ayer 3 roaming with a concentrator`\ or \ :literal:`VPN`\ . .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-walled_garden_enabled: .. rst-class:: ansible-option-title **walled_garden_enabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enable or disable walled garden functionality. .. 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.meraki_mr_ssid_module__parameter-walled_garden_ranges: .. rst-class:: ansible-option-title **walled_garden_ranges** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
List of walled garden ranges. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__parameter-wpa_encryption_mode: .. rst-class:: ansible-option-title **wpa_encryption_mode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Encryption mode within WPA specification. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`"WPA1 and WPA2"` - :ansible-option-choices-entry:`"WPA2 only"` - :ansible-option-choices-entry:`"WPA3 Transition Mode"` - :ansible-option-choices-entry:`"WPA3 only"` .. raw:: html
.. Attributes .. Notes Notes ----- .. note:: - Deleting an SSID does not delete RADIUS servers. - More information about the Meraki API can be found at \ https://dashboard.meraki.com/api_docs\ . - Some of the options are likely only used for developers within Meraki. - As of Ansible 2.9, Meraki modules output keys as snake case. To use camel case, set the \ :literal:`ANSIBLE\_MERAKI\_FORMAT`\ environment variable to \ :literal:`camelcase`\ . - Ansible's Meraki modules will stop supporting camel case output in Ansible 2.13. Please update your playbooks. - Check Mode downloads the current configuration from the dashboard, then compares changes against this download. Check Mode will report changed if there are differences in the configurations, but does not submit changes to the API for validation of change. .. Seealso .. Examples Examples -------- .. code-block:: yaml+jinja - name: Enable and name SSID meraki_ssid: auth_key: abc123 state: present org_name: YourOrg net_name: WiFi name: GuestSSID enabled: true visible: true delegate_to: localhost - name: Set PSK with invalid encryption mode meraki_ssid: auth_key: abc123 state: present org_name: YourOrg net_name: WiFi name: GuestSSID auth_mode: psk psk: abc1234 encryption_mode: eap ignore_errors: true delegate_to: localhost - name: Configure RADIUS servers meraki_ssid: auth_key: abc123 state: present org_name: YourOrg net_name: WiFi name: GuestSSID auth_mode: open-with-radius radius_servers: - host: 192.0.1.200 port: 1234 secret: abc98765 delegate_to: localhost - name: Enable click-through splash page meraki_ssid: auth_key: abc123 state: present org_name: YourOrg net_name: WiFi name: GuestSSID splash_page: Click-through splash page delegate_to: localhost .. 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.meraki_mr_ssid_module__return-data: .. rst-class:: ansible-option-title **data** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`complex` .. raw:: html
- .. raw:: html
List of wireless SSIDs. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/auth_mode: .. rst-class:: ansible-option-title **auth_mode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Authentication method. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"psk"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/band_selection: .. rst-class:: ansible-option-title **band_selection** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Wireless RF frequency wireless network will be broadcast on. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"5 GHz band only"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/enabled: .. rst-class:: ansible-option-title **enabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enabled state of wireless network. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/encryption_mode: .. rst-class:: ansible-option-title **encryption_mode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Wireless traffic encryption method. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"wpa"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/ip_assignment_mode: .. rst-class:: ansible-option-title **ip_assignment_mode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Wireless client IP assignment method. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"NAT mode"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/min_bitrate: .. rst-class:: ansible-option-title **min_bitrate** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Minimum bitrate a wireless client can connect at. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`11` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/name: .. rst-class:: ansible-option-title **name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of wireless SSID. This value is what is broadcasted. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"CorpWireless"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/number: .. rst-class:: ansible-option-title **number** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Zero-based index number for SSIDs. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`0` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/per_client_bandwidth_limit_down: .. rst-class:: ansible-option-title **per_client_bandwidth_limit_down** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Maximum download bandwidth a client can use. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`0` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/per_client_bandwidth_limit_up: .. rst-class:: ansible-option-title **per_client_bandwidth_limit_up** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Maximum upload bandwidth a client can use. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`1000` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/psk: .. rst-class:: ansible-option-title **psk** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Secret wireless password. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"SecretWiFiPass"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/splash_page: .. rst-class:: ansible-option-title **splash_page** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Splash page to show when user authenticates. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"Click-through splash page"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/ssid_admin_accessible: .. rst-class:: ansible-option-title **ssid_admin_accessible** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Whether SSID is administratively accessible. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.meraki.meraki_mr_ssid_module__return-data/wpa_encryption_mode: .. rst-class:: ansible-option-title **wpa_encryption_mode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Enabled WPA versions. .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` success .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`"WPA2 only"` .. raw:: html
.. Status (Presently only deprecated) Status ------ .. Deprecated note - This module will be removed in version 3.0.0. *[deprecated]* - For more information see `DEPRECATED`_. .. Authors Authors ~~~~~~~ - Kevin Breit (@kbreit) .. Extra links Collection links ~~~~~~~~~~~~~~~~ .. raw:: html .. Parsing errors