Documentation

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 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 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
    Choices:
  • no
  • yes ←
If no, it will use HTTP. Otherwise it will use HTTPS.
Only useful for internal Meraki developers
use_proxy
    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
    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
    status: query
    org_name: YourOrg
  delegate_to: localhost
- name: Query network named MyNet in the YourOrg organization
  meraki_network:
    auth_key: abc12345
    status: query
    org_name: YourOrg
    net_name: MyNet
  delegate_to: localhost
- name: Create network named MyNet in the YourOrg organization
  meraki_network:
    auth_key: abc12345
    status: 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
list
 info
Information about the created or manipulated object.

Sample:
[{'name': 'YourNetwork', 'tags': ' production ', 'organizationId': '0987654321', 'timeZone': 'America/Chicago', 'type': 'switch', 'id': 'N_12345'}]


Status

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

Author

  • Kevin Breit (@kbreit)

Hint

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