meraki_network - Manage networks in the Meraki cloud

New in version 2.6.

Synopsis

  • Allows for creation, management, and visibility into networks within Meraki.

Parameters

Parameter Choices/Defaults Comments
auth_key
Authentication key provided by the dashboard. Required if environmental variable MERAKI_KEY is not set.
host
string
 Default:
"api.meraki.com"
Hostname for Meraki dashboard
Only useful for internal Meraki developers
net_id
ID number of a network.
net_name
Name of a network.

aliases: name, network
org_id
ID of organization associated to a network.
org_name
Name of organization associated to a network.

aliases: organization
output_level
    Choices:
  • normal ←
  • debug
Set amount of debug output during module execution
state
    Choices:
  • absent
  • present ←
  • query
Create or modify an organization.
tags
Comma delimited list of tags to assign to network.
timeout
int
 Default:
30
Time to timeout for HTTP requests.
timezone
Timezone associated to network.
type
    Choices:
  • appliance
  • combined
  • switch
  • wireless
Type of network device network manages.
Required when creating a network.

aliases: net_type
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.
validate_certs
bool
    Choices:
  • no
  • yes ←
Whether to validate HTTP certificates.

Notes

Note

Examples

- name: List all networks associated to the YourOrg organization
  meraki_network:
    auth_key: abc12345
    state: query
    org_name: YourOrg
  delegate_to: localhost
- name: Query network named MyNet in the YourOrg organization
  meraki_network:
    auth_key: abc12345
    state: query
    org_name: YourOrg
    net_name: MyNet
  delegate_to: localhost
- name: Create network named MyNet in the YourOrg organization
  meraki_network:
    auth_key: abc12345
    state: present
    org_name: YourOrg
    net_name: MyNet
    type: switch
    timezone: America/Chicago
    tags: production, chicago

Return Values

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

Key Returned Description
data
complex
 info
Information about the created or manipulated object.
id
string
 success
Identification string of network.

Sample:
N_12345
name
string
 success
Written name of network.

Sample:
YourNet
organizationId
string
 success
Organization ID which owns the network.

Sample:
0987654321
tags
string
 success
Space delimited tags assigned to network.

Sample:
production wireless
timeZone
string
 success
Timezone where network resides.

Sample:
America/Chicago
type
string
 success
Functional type of network.

Sample:
switch
disableMyMerakiCom
bool
 success
States whether my.meraki.com and other device portals should be disabled.

Sample:
True


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.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/meraki_network_module.html