B
`o6 @ s G d d de ZdS )c s e Zd Z fddZedddZedddZeddd Zedd
d Zeed d
dZ edddZ
eedddZ edddZ edddZ
edddZeddd Zeeed d d Zeeed d!d"Z ZS )#Networksc s t t| || _d S )N)superr __init___session)selfsession) __class__ q/private/var/folders/7j/8686xlfs15q3tgljmghtvg0r0000gn/T/pip-target-isidps9b/lib/python/meraki_v0/api/networks.pyr s zNetworks.__init__) networkIdc C s$ dgdd}d| }| j ||S )z
**Return a network**
https://developer.cisco.com/meraki/api/#!get-network
- networkId (string)
r
getNetwork)tags operationz
/networks/)r get)r r
metadataresourcer r r r s
zNetworks.getNetworkc sX | t dgdd}d| }ddddd d
g fd d | D }| j|||S )
aS
**Update a network**
https://developer.cisco.com/meraki/api/#!update-network
- networkId (string)
- name (string): The name of the network
- timeZone (string): The timezone of the network. For a list of allowed timezones, please see the 'TZ' column in the table in this article.
- tags (string): A space-separated list of tags to be applied to the network
- disableMyMerakiCom (boolean): Disables the local device status pages (my.meraki.com, ap.meraki.com, switch.meraki.com, wired.meraki.com). Optional (defaults to false)
- disableRemoteStatusPage (boolean): Disables access to the device status page (http://[device's LAN IP]). Optional. Can only be set if disableMyMerakiCom is set to false
- enrollmentString (string): A unique identifier which can be used for device enrollment or easy access through the Meraki SM Registration page or the Self Service Portal. Please note that changing this field may cause existing bookmarks to break.
r
updateNetwork)r r
z
/networks/nametimeZoner disableMyMerakiComdisableRemoteStatusPageenrollmentStringc s& i | ] \}}| kr|| qS r )strip).0kv) body_paramsr r
- s z*Networks.updateNetwork..)updatelocalsitemsr put)r r
kwargsr r payloadr )r r r s
zNetworks.updateNetworkc C s$ dgdd}d| }| j ||S )z
**Delete a network**
https://developer.cisco.com/meraki/api/#!delete-network
- networkId (string)
r
deleteNetwork)r r
z
/networks/)r delete)r r
r r r r r r# 1 s
zNetworks.deleteNetworkc sR | t dgdd}d| d}ddg fdd | D }| j|||S )
a
**List Air Marshal scan results from a network**
https://developer.cisco.com/meraki/api/#!get-network-air-marshal
- networkId (string)
- t0 (string): The beginning of the timespan for the data. The maximum lookback period is 31 days from today.
- timespan (number): The timespan for which the information will be fetched. If specifying timespan, do not specify parameter t0. The value must be in seconds and be less than or equal to 31 days. The default is 7 days.
r getNetworkAirMarshal)r r
z
/networks/z /airMarshalt0timespanc s& i | ] \}}| kr|| qS r )r )r r r ) query_paramsr r r T s z1Networks.getNetworkAirMarshal..)r r r r r )r r
r! r r paramsr )r( r r% A s
z Networks.getNetworkAirMarshal)r
configTemplateIdc sR | t dgdd}d| d}ddg fdd | D }| j|||S )
aj
**Bind a network to a template.**
https://developer.cisco.com/meraki/api/#!bind-network
- networkId (string)
- configTemplateId (string): The ID of the template to which the network should be bound.
- autoBind (boolean): Optional boolean indicating whether the network's switches should automatically bind to profiles of the same model. Defaults to false if left unspecified. This option only affects switch networks and switch templates. Auto-bind is not valid unless the switch template has at least one profile and has at most one profile per switch model.
r bindNetwork)r r
z
/networks/z/bindr* ZautoBindc s& i | ] \}}| kr|| qS r )r )r r r )r r r r k s z(Networks.bindNetwork..)r r r r post)r r
r* r! r r r" r )r r r+ X s
zNetworks.bindNetworkc C s& dgdd}d| d}| j ||S )z
**Return the site-to-site VPN settings of a network. Only valid for MX networks.**
https://developer.cisco.com/meraki/api/#!get-network-site-to-site-vpn
- networkId (string)
r getNetworkSiteToSiteVpn)r r
z
/networks/z/siteToSiteVpn)r r )r r
r r r r r r- o s z Networks.getNetworkSiteToSiteVpn)r
modec s | t d|krBdddg}|d |ksBtd|d d| dgdd }d
| d }dd d
g fdd| D }| j|||S )a
**Update the site-to-site VPN settings of a network. Only valid for MX networks in NAT mode.**
https://developer.cisco.com/meraki/api/#!update-network-site-to-site-vpn
- networkId (string)
- mode (string): The site-to-site VPN mode. Can be one of 'none', 'spoke' or 'hub'
- hubs (array): The list of VPN hubs, in order of preference. In spoke mode, at least 1 hub is required.
- subnets (array): The list of subnets and their VPN presence.
r. noneZspokeZhubz"mode" cannot be "z ", & must be set to one of: r updateNetworkSiteToSiteVpn)r r
z
/networks/z/siteToSiteVpnZhubssubnetsc s& i | ] \}}| kr|| qS r )r )r r r )r r r r s z7Networks.updateNetworkSiteToSiteVpn..)r r AssertionErrorr r r )r r
r. r! optionsr r r" r )r r r0 s
$
z#Networks.updateNetworkSiteToSiteVpnc C s& dgdd}d| d}| j ||S )z
**Split a combined network into individual networks for each type of device**
https://developer.cisco.com/meraki/api/#!split-network
- networkId (string)
r splitNetwork)r r
z
/networks/z/split)r r, )r r
r r r r r r4 s zNetworks.splitNetworkc s | t d|krDddddg}|d |ksDtd|d d| dgd d
}d | d }d
ddg fdd| D }| j|||S )a
** The traffic analysis data for this network.
Traffic Analysis with Hostname Visibility must be enabled on the network.
**
https://developer.cisco.com/meraki/api/#!get-network-traffic
- networkId (string)
- t0 (string): The beginning of the timespan for the data. The maximum lookback period is 30 days from today.
- timespan (number): The timespan for which the information will be fetched. If specifying timespan, do not specify parameter t0. The value must be in seconds and be less than or equal to 30 days.
- deviceType (string): Filter the data by device type: 'combined', 'wireless', 'switch' or 'appliance'. Defaults to 'combined'.
When using 'combined', for each rule the data will come from the device type with the most usage.
Z
deviceTypeZcombinedZwirelessswitchZ appliancez"deviceType" cannot be "z ", & must be set to one of: r getNetworkTraffic)r r
z
/networks/z/trafficr& r' c s& i | ] \}}| kr|| qS r )r )r r r )r( r r r s z.Networks.getNetworkTraffic..)r r r2 r r r )r r
r! r3 r r r) r )r( r r6 s $
zNetworks.getNetworkTrafficc C s& dgdd}d| d}| j ||S )z
**Unbind a network from a template.**
https://developer.cisco.com/meraki/api/#!unbind-network
- networkId (string)
r
unbindNetwork)r r
z
/networks/z/unbind)r r, )r r
r r r r r r7 s zNetworks.unbindNetwork)organizationIdc sP | t dgdd}d| d}dg fdd| D }| j|||S ) aA
**List the networks in an organization**
https://developer.cisco.com/meraki/api/#!get-organization-networks
- organizationId (string)
- configTemplateId (string): An optional parameter that is the ID of a config template. Will return all networks bound to that template.
r getOrganizationNetworks)r r
z/organizations/z /networksr* c s& i | ] \}}| kr|| qS r )r )r r r )r( r r r s z4Networks.getOrganizationNetworks..)r r r r r )r r8 r! r r r) r )r( r r9 s z Networks.getOrganizationNetworks)r8 r typec s\ | t dgdd}d| d}dddd d
d d g fd
d| D }| j|||S )a
**Create a network**
https://developer.cisco.com/meraki/api/#!create-organization-network
- organizationId (string)
- name (string): The name of the new network
- type (string): The type of the new network. Valid types are wireless, appliance, switch, systemsManager, camera, cellularGateway, or a space-separated list of those for a combined network.
- tags (string): A space-separated list of tags to be applied to the network
- timeZone (string): The timezone of the network. For a list of allowed timezones, please see the 'TZ' column in the table in this article.
- copyFromNetworkId (string): The ID of the network to copy configuration from. Other provided parameters will override the copied configuration, except type which must match this network's type exactly.
- disableMyMerakiCom (boolean): Disables the local device status pages (my.meraki.com, ap.meraki.com, switch.meraki.com, wired.meraki.com). Optional (defaults to false)
- disableRemoteStatusPage (boolean): Disables access to the device status page (http://[device's LAN IP]). Optional. Can only be set if disableMyMerakiCom is set to false
r createOrganizationNetwork)r r
z/organizations/z /networksr r: r r ZcopyFromNetworkIdr r c s& i | ] \}}| kr|| qS r )r )r r r )r r r r s z6Networks.createOrganizationNetwork..)r r r r r, )r r8 r r: r! r r r" r )r r r; s z"Networks.createOrganizationNetwork)r8 r
networkIdsc sT | t dgdd}d| d}dddg fd d
| D }| j|||S ) au
**Combine multiple networks into a single network**
https://developer.cisco.com/meraki/api/#!combine-organization-networks
- organizationId (string)
- name (string): The name of the combined network
- networkIds (array): A list of the network IDs that will be combined. If an ID of a combined network is included in this list, the other networks in the list will be grouped into that network
- enrollmentString (string): A unique identifier which can be used for device enrollment or easy access through the Meraki SM Registration page or the Self Service Portal. Please note that changing this field may cause existing bookmarks to break. All networks that are part of this combined network will have their enrollment string appended by '-network_type'. If left empty, all exisitng enrollment strings will be deleted.
r combineOrganizationNetworks)r r
z/organizations/z/networks/combiner r< r c s& i | ] \}}| kr|| qS r )r )r r r )r r r r ! s z8Networks.combineOrganizationNetworks..)r r r r r, )r r8 r r< r! r r r" r )r r r=
s
z$Networks.combineOrganizationNetworks)__name__
__module__ __qualname__r strr r r# r% r+ r- r0 r4 r6 r7 r9 r; listr=
__classcell__r r )r r r s r N)objectr r r r r