meraki_ssid - Manage wireless SSIDs in the Meraki cloud

New in version 2.7.

Synopsis

Parameters

Parameter Choices/Defaults Comments
ap_tags_vlan_ids
List of VLAN tags.
vlan_id
Numerical identifier that is assigned to the VLAN.
tags
List of AP tags.
auth_key
Authentication key provided by the dashboard. Required if environmental variable MERAKI_KEY is not set.
auth_mode
    Choices:
  • open
  • psk
  • open-with-radius
  • 8021x-meraki
  • 8021x-radius
Set authentication mode of network.
band_selection
    Choices:
  • Dual band operation
  • 5 GHz band only
  • Dual band operation with Band Steering
Set band selection mode.
concentrator_network_id
The concentrator to use for 'Layer 3 roaming with a concentrator' or 'VPN'.
default_vlan_id
Default VLAN ID.
enabled
bool
    Choices:
  • no
  • yes
Enable or disable SSID network.
encryption_mode
    Choices:
  • wpa
  • eap
  • wpa-eap
Set encryption mode of network.
host
string
Default:
api.meraki.com
Hostname for Meraki dashboard
Only useful for internal Meraki developers
ip_assignment_mode
    Choices:
  • NAT mode
  • Bridge mode
  • Layer 3 roaming
  • Layer 3 roaming with a concentrator
  • VPN
Method of which SSID uses to assign IP addresses.
min_bitrate
    Choices:
  • 1
  • 2
  • 5.5
  • 6
  • 9
  • 11
  • 12
  • 18
  • 24
  • 36
  • 48
  • 54
Minimum bitrate (Mbps) allowed on SSID.
name
Name of SSID.
net_id
ID of network.
net_name
Name of network.
number
SSID number within network.

aliases: ssid_number
org_id
ID of organization.
org_name
Name of organization.

aliases: organization
output_level
    Choices:
  • normal ←
  • debug
Set amount of debug output during module execution
per_client_bandwidth_limit_down
Maximum bandwidth in Mbps devices on SSID can download.
per_client_bandwidth_limit_up
Maximum bandwidth in Mbps devices on SSID can upload.
psk
Password for wireless network.
Requires auth_mode to be set to psk.
radius_accounting_enabled
bool
    Choices:
  • no
  • yes
Enable or disable RADIUS accounting.
radius_accounting_servers
List of RADIUS servers for RADIUS accounting.
host
IP addres or hostname of RADIUS server.
secret
RADIUS password.
port
Port number RADIUS server is listening to.
radius_coa_enabled
bool
    Choices:
  • no
  • yes
Enable or disable RADIUS CoA (Change of Authorization) on SSID.
radius_failover_policy
    Choices:
  • Deny access
  • Allow access
Set client access policy in case RADIUS servers aren't available.
radius_load_balancing_policy
    Choices:
  • Strict priority order
  • Round robin
Set load balancing policy when multiple RADIUS servers are specified.
radius_servers
List of RADIUS servers.
host
IP addres or hostname of RADIUS server.
secret
RADIUS password.
port
Port number RADIUS server is listening to.
splash_page
    Choices:
  • None
  • Click-through splash page
  • Billing
  • Password-protected with Meraki RADIUS
  • Password-protected with custom RADIUS
  • Password-protected with Active Directory
  • Password-protected with LDAP
  • SMS authentication
  • Systems Manager Sentry
  • Facebook Wi-Fi
  • Google OAuth
  • Sponsored guest
Set to enable splash page and specify type of splash.
state
    Choices:
  • absent
  • query
  • present ←
Specifies whether SNMP information should be queried or modified.
timeout
int
Default:
30
Time to timeout for HTTP requests.
use_https
bool
    Choices:
  • no
  • yes ←
If no, it will use HTTP. Otherwise it will use HTTPS.
Only useful for internal Meraki developers
use_proxy
bool
    Choices:
  • no
  • yes
If no, it will not use a proxy, even if one is defined in an environment variable on the target hosts.
use_vlan_tagging
bool
    Choices:
  • no
  • yes
Set whether to use VLAN tagging.
validate_certs
bool
    Choices:
  • no
  • yes ←
Whether to validate HTTP certificates.
vlan_id
ID number of VLAN on SSID.
walled_garden_enabled
bool
    Choices:
  • no
  • yes
Enable or disable walled garden functionality.
walled_garden_ranges
List of walled garden ranges.
wpa_encryption_mode
    Choices:
  • WPA1 and WPA2
  • WPA2 only
Encryption mode within WPA2 specification.

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

Examples


Return Values

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

Key Returned Description
data
list
info
Information about queried or updated object.

Sample:
{'data': {}}


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • Kevin Breit (@kbreit)

Hint

If you notice any issues in this documentation you can edit this document to improve it.