Python client library for Meraki Dashboard API
Project description
Getting started
The Cisco Meraki Dashboard API is a modern REST API based on the OpenAPI specification.
What can the API be used for?
The Dashboard API can be used for many purposes. It's meant to be an open-ended tool. Here are some examples of use cases:
- Add new organizations, admins, networks, devices, VLANs, and more
- Configure networks at scale
- Automatically on-board and off-board new employees' teleworker setups
- Build your own dashboard for store managers, field techs, or unique use cases
Enabling the Dashboard API
-
Begin by logging into Meraki Dashboard and navigating to Organization > Settings
-
Locate the section titled Dashboard API access and select Enable Access, then Save your changes
-
After enabling the API, choose your username at the top-right of the Meraki Dashboard and select my profile
-
Locate the section titled Dashboard API access and select Generate new API key
Note: The API key is associated with a Dashboard administrator account. You can generate, revoke, and regenerate your API key on your profile.
Keep your API key safe as it provides authentication to all of your organizations with the API enabled. If your API key is shared, you can regenerate your API key at any time. This will revoke the existing API key.
Copy and store your API key in a safe place. Dashboard does not store API keys in plaintext for security reasons, so this is the only time you will be able to record it. If you lose or forget your API key, you will have to revoke it and generate a new one.
Every request must specify an API key via a request header.
The API key must be specified in the URL header. The API will return a 404 (rather than a 403) in response to a request with a missing or incorrect API key in order to prevent leaking the existence of resources to unauthorized users.
X-Cisco-Meraki-API-Key: <secret key>
Read more about API authorization
Versioning
Once an API version is released, we will make only backwards-compatible changes to it. Backwards-compatible changes include:
-
Adding new API resources
-
Adding new optional request parameters to existing API methods
-
Adding new properties to existing API responses
-
Changing the order of properties in existing API responses
Rate Limit
- The Dashboard API is limited to 5 calls per second, per organization.
- A burst of 5 additional calls are allowed in the first second, so a maximum of 15 calls in the first 2 seconds.
- The rate limiting technique is based off of the token bucket model.
- An error with a
429
status code will be returned when the rate limit has been exceeded. - Expect to backoff for 1 - 2 seconds if the limit has been exceeded. You may have to wait potentially longer if a large number of requests were made within this timeframe.
Additional Details
Identifiers in the API are opaque strings. A {networkId}
, for example, might be the string "126043", whereas an {orderId}
might contain characters, such as "4S1234567". Client applications must not try to parse them as numbers. Even identifiers that look like numbers might be too long to encode without loss of precision in Javascript, where the only numeric type is IEEE 754 floating point.
Verbs in the API follow the usual REST conventions:
GET
returns the value of a resource or a list of resources, depending on whether an identifier is specified. For example, a GET
of /organizations
returns a list of organizations, whereas a GET
of /organizations/{organizationId}
returns a particular organization.
POST
adds a new resource, as in a POST
to /organizations/{organizationId}/admins
, or performs some other non-idempotent change.
PUT
updates a resource. PUTs
are idempotent; they update a resource, creating it first if it does not already exist. A PUT
should specify all the fields of a resource; the API will revert omitted fields to their default value.
DELETE
removes a resource.
How to Build
You must have Python 2 >=2.7.9
or Python 3 >=3.4
installed on your system to install and run this SDK. This SDK package depends on other Python packages like nose, jsonpickle etc.
These dependencies are defined in the requirements.txt
file that comes with the SDK.
To resolve these dependencies, you can use the PIP Dependency manager. Install it by following steps at https://pip.pypa.io/en/stable/installing/.
Python and PIP executables should be defined in your PATH. Open command prompt and type pip --version
.
This should display the version of the PIP Dependency Manager installed if your installation was successful and the paths are properly defined.
- Using command line, navigate to the directory containing the generated files (including
requirements.txt
) for the SDK. - Run the command
pip install -r requirements.txt
. This should install all the required dependencies.
How to Use
The following section explains how to use the Meraki SDK package in a new project.
1. Open Project in an IDE
Open up a Python IDE like PyCharm. The basic workflow presented here is also applicable if you prefer using a different editor or IDE.
Click on Open
in PyCharm to browse to your generated SDK directory and then click OK
.
The project files will be displayed in the side bar as follows:
2. Add a new Test Project
Create a new directory by right clicking on the solution name as shown below:
Name the directory as "test"
Add a python file to this project with the name "testsdk"
Name it "testsdk"
In your python file you will be required to import the generated python library using the following code lines
from meraki_sdk.meraki_sdk_client import MerakiSdkClient
After this you can write code to instantiate an API client object, get a controller object and make API calls. Sample code is given in the subsequent sections.
3. Run the Test Project
To run the file within your test project, right click on your Python file inside your Test project and click on Run
How to Test
You can test the generated SDK and the server with automatically generated test cases. unittest is used as the testing framework and nose is used as the test runner. You can run the tests as follows:
- From terminal/cmd navigate to the root directory of the SDK.
- Invoke
pip install -r test-requirements.txt
- Invoke
nosetests
Initialization
Authentication
In order to setup authentication and initialization of the API client, you need the following information.
Parameter | Description |
---|---|
x_cisco_meraki_api_key | TODO: add a description |
API client can be initialized as following.
# Configuration parameters and credentials
x_cisco_meraki_api_key = 'x_cisco_meraki_api_key'
client = MerakiSdkClient(x_cisco_meraki_api_key)
Class Reference
List of Controllers
- APIUsageController
- ActionBatchesController
- AdminsController
- AlertSettingsController
- BluetoothClientsController
- CamerasController
- ClientsController
- ConfigTemplatesController
- ConnectivityMonitoringDestinationsController
- ContentFilteringCategoriesController
- ContentFilteringRulesController
- DashboardBrandingPoliciesController
- DevicesController
- EventsController
- FirewalledServicesController
- FloorplansController
- GroupPoliciesController
- HTTPServersController
- IntrusionSettingsController
- MRL3FirewallController
- MVSenseController
- MX11NATRulesController
- MX1ManyNATRulesController
- MXL3FirewallController
- MXL7ApplicationCategoriesController
- MXL7FirewallController
- MXVLANPortsController
- MXVPNFirewallController
- MXCellularFirewallController
- MXPortForwardingRulesController
- MXStaticRoutesController
- MXWarmSpareSettingsController
- MalwareSettingsController
- ManagementInterfaceSettingsController
- MerakiAuthUsersController
- NamedTagScopeController
- NetflowSettingsController
- NetworksController
- OpenAPISpecController
- OrganizationsController
- PIIController
- RadioSettingsController
- SAMLRolesController
- SMController
- SNMPSettingsController
- SsidsController
- SecurityEventsController
- SplashLoginAttemptsController
- SplashSettingsController
- SwitchPortSchedulesController
- SwitchPortsController
- SwitchProfilesController
- SwitchSettingsController
- SwitchStacksController
- SyslogServersController
- TrafficAnalysisSettingsController
- TrafficShapingController
- UplinkSettingsController
- VlansController
- WebhookLogsController
- WirelessHealthController
- WirelessSettingsController
APIUsageController
Get controller instance
An instance of the APIUsageController
class can be accessed from the API Client.
api_usage_controller = client.api_usage
get_organization_api_requests
List the API requests made by an organization
def get_organization_api_requests(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 31 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 31 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 31 days. The default is 31 days. |
perPage | Optional |
The number of entries per page returned. Acceptable range is 3 - 1000. Default is 50. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
adminId | Optional |
Filter the results by the ID of the admin who made the API requests |
path | Optional |
Filter the results by the path of the API requests |
method | Optional |
Filter the results by the method of the API requests (must be 'GET', 'PUT', 'POST' or 'DELETE') |
responseCode | Optional |
Filter the results by the response code of the API requests |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 39.8749335202737
collect['timespan'] = timespan
per_page = 39
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
admin_id = 'adminId'
collect['admin_id'] = admin_id
path = 'path'
collect['path'] = path
method = 'method'
collect['method'] = method
response_code = 39
collect['response_code'] = response_code
result = api_usage_controller.get_organization_api_requests(collect)
ActionBatchesController
Get controller instance
An instance of the ActionBatchesController
class can be accessed from the API Client.
action_batches_controller = client.action_batches
create_organization_action_batch
Create an action batch
def create_organization_action_batch(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
createOrganizationActionBatch | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
create_organization_action_batch = CreateOrganizationActionBatchModel()
collect['create_organization_action_batch'] = create_organization_action_batch
result = action_batches_controller.create_organization_action_batch(collect)
get_organization_action_batches
Return the list of action batches in the organization
def get_organization_action_batches(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = action_batches_controller.get_organization_action_batches(organization_id)
get_organization_action_batch
Return an action batch
def get_organization_action_batch(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
actionBatchId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
action_batch_id = 'actionBatchId'
collect['action_batch_id'] = action_batch_id
result = action_batches_controller.get_organization_action_batch(collect)
delete_organization_action_batch
Delete an action batch
def delete_organization_action_batch(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
actionBatchId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
action_batch_id = 'actionBatchId'
collect['action_batch_id'] = action_batch_id
action_batches_controller.delete_organization_action_batch(collect)
update_organization_action_batch
Update an action batch
def update_organization_action_batch(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
actionBatchId | Required |
TODO: Add a parameter description |
updateOrganizationActionBatch | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
action_batch_id = 'actionBatchId'
collect['action_batch_id'] = action_batch_id
update_organization_action_batch = UpdateOrganizationActionBatchModel()
collect['update_organization_action_batch'] = update_organization_action_batch
result = action_batches_controller.update_organization_action_batch(collect)
AdminsController
Get controller instance
An instance of the AdminsController
class can be accessed from the API Client.
admins_controller = client.admins
get_organization_admins
List the dashboard administrators in this organization
def get_organization_admins(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = admins_controller.get_organization_admins(organization_id)
create_organization_admin
Create a new dashboard administrator
def create_organization_admin(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
createOrganizationAdmin | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
create_organization_admin = CreateOrganizationAdminModel()
collect['create_organization_admin'] = create_organization_admin
result = admins_controller.create_organization_admin(collect)
update_organization_admin
Update an administrator
def update_organization_admin(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
updateOrganizationAdmin | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
id = 'id'
collect['id'] = id
update_organization_admin = UpdateOrganizationAdminModel()
collect['update_organization_admin'] = update_organization_admin
result = admins_controller.update_organization_admin(collect)
delete_organization_admin
Revoke all access for a dashboard administrator within this organization
def delete_organization_admin(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
id = 'id'
collect['id'] = id
admins_controller.delete_organization_admin(collect)
AlertSettingsController
Get controller instance
An instance of the AlertSettingsController
class can be accessed from the API Client.
alert_settings_controller = client.alert_settings
get_network_alert_settings
Return the alert configuration for this network
def get_network_alert_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = alert_settings_controller.get_network_alert_settings(network_id)
update_network_alert_settings
Update the alert configuration for this network
def update_network_alert_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkAlertSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_alert_settings = UpdateNetworkAlertSettingsModel()
collect['update_network_alert_settings'] = update_network_alert_settings
result = alert_settings_controller.update_network_alert_settings(collect)
BluetoothClientsController
Get controller instance
An instance of the BluetoothClientsController
class can be accessed from the API Client.
bluetooth_clients_controller = client.bluetooth_clients
get_network_bluetooth_clients
List the Bluetooth clients seen by APs in this network
def get_network_bluetooth_clients(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 7 days from today. |
timespan | Optional |
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 7 days. The default is 1 day. |
perPage | Optional |
The number of entries per page returned. Acceptable range is 5 - 1000. Default is 10. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
includeConnectivityHistory | Optional |
Include the connectivity history for this client |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
timespan = 39.8749335202737
collect['timespan'] = timespan
per_page = 39
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
include_connectivity_history = False
collect['include_connectivity_history'] = include_connectivity_history
result = bluetooth_clients_controller.get_network_bluetooth_clients(collect)
get_network_bluetooth_client
Return a Bluetooth client. Bluetooth clients can be identified by their ID or their MAC.
def get_network_bluetooth_client(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
bluetoothClientId | Required |
TODO: Add a parameter description |
includeConnectivityHistory | Optional |
Include the connectivity history for this client |
connectivityHistoryTimespan | Optional |
The timespan, in seconds, for the connectivityHistory data. By default 1 day, 86400, will be used. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
bluetooth_client_id = 'bluetoothClientId'
collect['bluetooth_client_id'] = bluetooth_client_id
include_connectivity_history = False
collect['include_connectivity_history'] = include_connectivity_history
connectivity_history_timespan = 39
collect['connectivity_history_timespan'] = connectivity_history_timespan
result = bluetooth_clients_controller.get_network_bluetooth_client(collect)
CamerasController
Get controller instance
An instance of the CamerasController
class can be accessed from the API Client.
cameras_controller = client.cameras
generate_network_camera_snapshot
Generate a snapshot of what the camera sees at the specified time and return a link to that image.
def generate_network_camera_snapshot(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
generateNetworkCameraSnapshot | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
generate_network_camera_snapshot = GenerateNetworkCameraSnapshotModel()
collect['generate_network_camera_snapshot'] = generate_network_camera_snapshot
result = cameras_controller.generate_network_camera_snapshot(collect)
get_network_camera_video_link
Returns video link to the specified camera. If a timestamp is supplied, it links to that timestamp.
def get_network_camera_video_link(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
timestamp | Optional |
[optional] The video link will start at this timestamp. The timestamp is in UNIX Epoch time (milliseconds). If no timestamp is specified, we will assume current time. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
timestamp = 'timestamp'
collect['timestamp'] = timestamp
result = cameras_controller.get_network_camera_video_link(collect)
ClientsController
Get controller instance
An instance of the ClientsController
class can be accessed from the API Client.
clients_controller = client.clients
get_device_clients
List the clients of a device, up to a maximum of a month ago. The usage of each client is returned in kilobytes. If the device is a switch, the switchport is returned; otherwise the switchport field is null.
def get_device_clients(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
serial | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 31 days from today. |
timespan | Optional |
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 1 day. |
Example Usage
collect = {}
serial = 'serial'
collect['serial'] = serial
t_0 = 't0'
collect['t_0'] = t_0
timespan = 203.379651628611
collect['timespan'] = timespan
result = clients_controller.get_device_clients(collect)
get_network_clients
List the clients that have used this network in the timespan
def get_network_clients(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 31 days from today. |
timespan | Optional |
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 1 day. |
perPage | Optional |
The number of entries per page returned. Acceptable range is 3 - 1000. Default is 10. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
timespan = 203.379651628611
collect['timespan'] = timespan
per_page = 203
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = clients_controller.get_network_clients(collect)
provision_network_clients
Provisions a client with a name and policy. Clients can be provisioned before they associate to the network.
def provision_network_clients(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
provisionNetworkClients | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
provision_network_clients = ProvisionNetworkClientsModel()
collect['provision_network_clients'] = provision_network_clients
result = clients_controller.provision_network_clients(collect)
get_network_client
Return the client associated with the given identifier. Clients can be identified by a client key or either the MAC or IP depending on whether the network uses Track-by-IP.
def get_network_client(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
result = clients_controller.get_network_client(collect)
get_network_client_events
Return the events associated with this client. Clients can be identified by a client key or either the MAC or IP depending on whether the network uses Track-by-IP.
def get_network_client_events(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
perPage | Optional |
The number of entries per page returned. Acceptable range is 3 - 100. Default is 100. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
per_page = 203
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = clients_controller.get_network_client_events(collect)
get_network_client_latency_history
Return the latency history for a client. Clients can be identified by a client key or either the MAC or IP depending on whether the network uses Track-by-IP. The latency data is from a sample of 2% of packets and is grouped into 4 traffic categories: background, best effort, video, voice. Within these categories the sampled packet counters are bucketed by latency in milliseconds.
def get_network_client_latency_history(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 791 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 791 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 791 days. The default is 1 day. |
resolution | Optional |
The time resolution in seconds for returned data. The valid resolutions are: 86400. The default is 86400. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 203.379651628611
collect['timespan'] = timespan
resolution = 203
collect['resolution'] = resolution
result = clients_controller.get_network_client_latency_history(collect)
get_network_client_policy
Return the policy assigned to a client on the network. Clients can be identified by a client key or either the MAC or IP depending on whether the network uses Track-by-IP.
def get_network_client_policy(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
result = clients_controller.get_network_client_policy(collect)
update_network_client_policy
Update the policy assigned to a client on the network. Clients can be identified by a client key or either the MAC or IP depending on whether the network uses Track-by-IP.
def update_network_client_policy(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
updateNetworkClientPolicy | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
update_network_client_policy = UpdateNetworkClientPolicyModel()
collect['update_network_client_policy'] = update_network_client_policy
result = clients_controller.update_network_client_policy(collect)
get_network_client_splash_authorization_status
Return the splash authorization for a client, for each SSID they've associated with through splash. Only enabled SSIDs with Click-through splash enabled will be included. Clients can be identified by a client key or either the MAC or IP depending on whether the network uses Track-by-IP.
def get_network_client_splash_authorization_status(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
result = clients_controller.get_network_client_splash_authorization_status(collect)
update_network_client_splash_authorization_status
Update a client's splash authorization. Clients can be identified by a client key or either the MAC or IP depending on whether the network uses Track-by-IP.
def update_network_client_splash_authorization_status(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
updateNetworkClientSplashAuthorizationStatus | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
update_network_client_splash_authorization_status = UpdateNetworkClientSplashAuthorizationStatusModel()
collect['update_network_client_splash_authorization_status'] = update_network_client_splash_authorization_status
result = clients_controller.update_network_client_splash_authorization_status(collect)
get_network_client_traffic_history
Return the client's network traffic data over time. Usage data is in kilobytes. This endpoint requires detailed traffic analysis to be enabled on the Network-wide > General page. Clients can be identified by a client key or either the MAC or IP depending on whether the network uses Track-by-IP.
def get_network_client_traffic_history(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
perPage | Optional |
The number of entries per page returned. Acceptable range is 3 - 1000. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
per_page = 203
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = clients_controller.get_network_client_traffic_history(collect)
get_network_client_usage_history
Return the client's daily usage history. Usage data is in kilobytes. Clients can be identified by a client key or either the MAC or IP depending on whether the network uses Track-by-IP.
def get_network_client_usage_history(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
result = clients_controller.get_network_client_usage_history(collect)
ConfigTemplatesController
Get controller instance
An instance of the ConfigTemplatesController
class can be accessed from the API Client.
config_templates_controller = client.config_templates
get_organization_config_templates
List the configuration templates for this organization
def get_organization_config_templates(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = config_templates_controller.get_organization_config_templates(organization_id)
delete_organization_config_template
Remove a configuration template
def delete_organization_config_template(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
configTemplateId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
config_template_id = 'configTemplateId'
collect['config_template_id'] = config_template_id
config_templates_controller.delete_organization_config_template(collect)
ConnectivityMonitoringDestinationsController
Get controller instance
An instance of the ConnectivityMonitoringDestinationsController
class can be accessed from the API Client.
connectivity_monitoring_destinations_controller = client.connectivity_monitoring_destinations
get_network_connectivity_monitoring_destinations
Return the connectivity testing destinations for an MX network
def get_network_connectivity_monitoring_destinations(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = connectivity_monitoring_destinations_controller.get_network_connectivity_monitoring_destinations(network_id)
update_network_connectivity_monitoring_destinations
Update the connectivity testing destinations for an MX network
def update_network_connectivity_monitoring_destinations(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkConnectivityMonitoringDestinations | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_connectivity_monitoring_destinations = UpdateNetworkConnectivityMonitoringDestinationsModel()
collect['update_network_connectivity_monitoring_destinations'] = update_network_connectivity_monitoring_destinations
result = connectivity_monitoring_destinations_controller.update_network_connectivity_monitoring_destinations(collect)
ContentFilteringCategoriesController
Get controller instance
An instance of the ContentFilteringCategoriesController
class can be accessed from the API Client.
content_filtering_categories_controller = client.content_filtering_categories
get_network_content_filtering_categories
List all available content filtering categories for an MX network
def get_network_content_filtering_categories(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = content_filtering_categories_controller.get_network_content_filtering_categories(network_id)
ContentFilteringRulesController
Get controller instance
An instance of the ContentFilteringRulesController
class can be accessed from the API Client.
content_filtering_rules_controller = client.content_filtering_rules
get_network_content_filtering
Return the content filtering settings for an MX network
def get_network_content_filtering(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = content_filtering_rules_controller.get_network_content_filtering(network_id)
update_network_content_filtering
Update the content filtering settings for an MX network
def update_network_content_filtering(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkContentFiltering | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_content_filtering = UpdateNetworkContentFilteringModel()
collect['update_network_content_filtering'] = update_network_content_filtering
result = content_filtering_rules_controller.update_network_content_filtering(collect)
DashboardBrandingPoliciesController
Get controller instance
An instance of the DashboardBrandingPoliciesController
class can be accessed from the API Client.
dashboard_branding_policies_controller = client.dashboard_branding_policies
get_organization_branding_policies
List the branding policies of an organization
def get_organization_branding_policies(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = dashboard_branding_policies_controller.get_organization_branding_policies(organization_id)
create_organization_branding_policy
Add a new branding policy to an organization
def create_organization_branding_policy(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
createOrganizationBrandingPolicy | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
create_organization_branding_policy = CreateOrganizationBrandingPolicyModel()
collect['create_organization_branding_policy'] = create_organization_branding_policy
result = dashboard_branding_policies_controller.create_organization_branding_policy(collect)
get_organization_branding_policies_priorities
Return the branding policy IDs of an organization in priority order. IDs are ordered in ascending order of priority (IDs later in the array have higher priority).
def get_organization_branding_policies_priorities(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = dashboard_branding_policies_controller.get_organization_branding_policies_priorities(organization_id)
update_organization_branding_policies_priorities
Update the priority ordering of an organization's branding policies.
def update_organization_branding_policies_priorities(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
updateOrganizationBrandingPoliciesPriorities | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
update_organization_branding_policies_priorities = UpdateOrganizationBrandingPoliciesPrioritiesModel()
collect['update_organization_branding_policies_priorities'] = update_organization_branding_policies_priorities
result = dashboard_branding_policies_controller.update_organization_branding_policies_priorities(collect)
get_organization_branding_policy
Return a branding policy
def get_organization_branding_policy(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
brandingPolicyId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
branding_policy_id = 'brandingPolicyId'
collect['branding_policy_id'] = branding_policy_id
result = dashboard_branding_policies_controller.get_organization_branding_policy(collect)
update_organization_branding_policy
Update a branding policy
def update_organization_branding_policy(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
brandingPolicyId | Required |
TODO: Add a parameter description |
updateOrganizationBrandingPolicy | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
branding_policy_id = 'brandingPolicyId'
collect['branding_policy_id'] = branding_policy_id
update_organization_branding_policy = UpdateOrganizationBrandingPolicyModel()
collect['update_organization_branding_policy'] = update_organization_branding_policy
result = dashboard_branding_policies_controller.update_organization_branding_policy(collect)
delete_organization_branding_policy
Delete a branding policy
def delete_organization_branding_policy(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
brandingPolicyId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
branding_policy_id = 'brandingPolicyId'
collect['branding_policy_id'] = branding_policy_id
dashboard_branding_policies_controller.delete_organization_branding_policy(collect)
DevicesController
Get controller instance
An instance of the DevicesController
class can be accessed from the API Client.
devices_controller = client.devices
get_network_devices
List the devices in a network
def get_network_devices(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = devices_controller.get_network_devices(network_id)
claim_network_devices
Claim a device into a network
def claim_network_devices(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
claimNetworkDevices | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
claim_network_devices = ClaimNetworkDevicesModel()
collect['claim_network_devices'] = claim_network_devices
devices_controller.claim_network_devices(collect)
get_network_device
Return a single device
def get_network_device(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
result = devices_controller.get_network_device(collect)
update_network_device
Update the attributes of a device
def update_network_device(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
updateNetworkDevice | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
update_network_device = UpdateNetworkDeviceModel()
collect['update_network_device'] = update_network_device
result = devices_controller.update_network_device(collect)
blink_network_device_leds
Blink the LEDs on a device
def blink_network_device_leds(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
blinkNetworkDeviceLeds | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
blink_network_device_leds = BlinkNetworkDeviceLedsModel()
collect['blink_network_device_leds'] = blink_network_device_leds
result = devices_controller.blink_network_device_leds(collect)
get_network_device_lldp_cdp
List LLDP and CDP information for a device
def get_network_device_lldp_cdp(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
timespan | Optional |
The timespan for which LLDP and CDP information will be fetched. Must be in seconds and less than or equal to a month (2592000 seconds). LLDP and CDP information is sent to the Meraki dashboard every 10 minutes. In instances where this LLDP and CDP information matches an existing entry in the Meraki dashboard, the data is updated once every two hours. Meraki recommends querying LLDP and CDP information at an interval slightly greater than two hours, to ensure that unchanged CDP / LLDP information can be queried consistently. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
timespan = 203
collect['timespan'] = timespan
result = devices_controller.get_network_device_lldp_cdp(collect)
get_network_device_loss_and_latency_history
Get the uplink loss percentage and latency in milliseconds for a wired network device.
def get_network_device_loss_and_latency_history(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
ip | Required |
The destination IP used to obtain the requested stats. This is required. |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 365 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 31 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 31 days. The default is 1 day. |
resolution | Optional |
The time resolution in seconds for returned data. The valid resolutions are: 60, 600, 3600, 86400. The default is 60. |
uplink | Optional |
The WAN uplink used to obtain the requested stats. Valid uplinks are wan1, wan2, cellular. The default is wan1. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
ip = 'ip'
collect['ip'] = ip
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 203.379651628611
collect['timespan'] = timespan
resolution = 203
collect['resolution'] = resolution
uplink = UplinkEnum.WAN1
collect['uplink'] = uplink
result = devices_controller.get_network_device_loss_and_latency_history(collect)
get_network_device_performance
Return the performance score for a single device. Only primary MX devices supported. If no data is available, a 204 error code is returned.
def get_network_device_performance(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
result = devices_controller.get_network_device_performance(collect)
reboot_network_device
Reboot a device
def reboot_network_device(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
result = devices_controller.reboot_network_device(collect)
remove_network_device
Remove a single device
def remove_network_device(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
devices_controller.remove_network_device(collect)
get_network_device_uplink
Return the uplink information for a device.
def get_network_device_uplink(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
result = devices_controller.get_network_device_uplink(collect)
get_organization_devices
List the devices in an organization
def get_organization_devices(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
perPage | Optional |
The number of entries per page returned. Acceptable range is 3 - 1000. Default is 1000. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
per_page = 111
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = devices_controller.get_organization_devices(collect)
EventsController
Get controller instance
An instance of the EventsController
class can be accessed from the API Client.
events_controller = client.events
get_network_events
List the events for the network
def get_network_events(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
productType | Optional |
The product type to fetch events for. This parameter is required for networks with multiple device types. Valid types are wireless, appliance, switch, systemsManager, and camera |
includedEventTypes | Optional Collection |
A list of event types. The returned events will be filtered to only include events with these types. |
excludedEventTypes | Optional Collection |
A list of event types. The returned events will be filtered to exclude events with these types. |
deviceMac | Optional |
The MAC address of the Meraki device which the list of events will be filtered with |
deviceSerial | Optional |
The serial of the Meraki device which the list of events will be filtered with |
deviceName | Optional |
The name of the Meraki device which the list of events will be filtered with |
clientIp | Optional |
The IP of the client which the list of events will be filtered with. Only supported for track-by-IP networks. |
clientMac | Optional |
The MAC address of the client which the list of events will be filtered with. Only supported for track-by-MAC networks. |
clientName | Optional |
The name, or partial name, of the client which the list of events will be filtered with |
smDeviceMac | Optional |
The MAC address of the Systems Manager device which the list of events will be filtered with |
smDeviceName | Optional |
The name of the Systems Manager device which the list of events will be filtered with |
perPage | Optional |
The number of entries per page returned. Acceptable range is 3 - 1000. Default is 10. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
product_type = 'productType'
collect['product_type'] = product_type
included_event_types = ['includedEventTypes']
collect['included_event_types'] = included_event_types
excluded_event_types = ['excludedEventTypes']
collect['excluded_event_types'] = excluded_event_types
device_mac = 'deviceMac'
collect['device_mac'] = device_mac
device_serial = 'deviceSerial'
collect['device_serial'] = device_serial
device_name = 'deviceName'
collect['device_name'] = device_name
client_ip = 'clientIp'
collect['client_ip'] = client_ip
client_mac = 'clientMac'
collect['client_mac'] = client_mac
client_name = 'clientName'
collect['client_name'] = client_name
sm_device_mac = 'smDeviceMac'
collect['sm_device_mac'] = sm_device_mac
sm_device_name = 'smDeviceName'
collect['sm_device_name'] = sm_device_name
per_page = 111
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = events_controller.get_network_events(collect)
get_network_events_event_types
List the event type to human-readable description
def get_network_events_event_types(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = events_controller.get_network_events_event_types(network_id)
FirewalledServicesController
Get controller instance
An instance of the FirewalledServicesController
class can be accessed from the API Client.
firewalled_services_controller = client.firewalled_services
get_network_firewalled_services
List the appliance services and their accessibility rules
def get_network_firewalled_services(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = firewalled_services_controller.get_network_firewalled_services(network_id)
get_network_firewalled_service
Return the accessibility settings of the given service ('ICMP', 'web', or 'SNMP')
def get_network_firewalled_service(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
service | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
service = 'service'
collect['service'] = service
result = firewalled_services_controller.get_network_firewalled_service(collect)
update_network_firewalled_service
Updates the accessibility settings for the given service ('ICMP', 'web', or 'SNMP')
def update_network_firewalled_service(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
service | Required |
TODO: Add a parameter description |
updateNetworkFirewalledService | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
service = 'service'
collect['service'] = service
update_network_firewalled_service = UpdateNetworkFirewalledServiceModel()
collect['update_network_firewalled_service'] = update_network_firewalled_service
result = firewalled_services_controller.update_network_firewalled_service(collect)
FloorplansController
Get controller instance
An instance of the FloorplansController
class can be accessed from the API Client.
floorplans_controller = client.floorplans
get_network_floor_plans
List the floor plans that belong to your network
def get_network_floor_plans(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = floorplans_controller.get_network_floor_plans(network_id)
create_network_floor_plan
Upload a floor plan
def create_network_floor_plan(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkFloorPlan | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_floor_plan = CreateNetworkFloorPlanModel()
collect['create_network_floor_plan'] = create_network_floor_plan
result = floorplans_controller.create_network_floor_plan(collect)
get_network_floor_plan
Find a floor plan by ID
def get_network_floor_plan(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
floorPlanId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
floor_plan_id = 'floorPlanId'
collect['floor_plan_id'] = floor_plan_id
result = floorplans_controller.get_network_floor_plan(collect)
update_network_floor_plan
Update a floor plan's geolocation and other meta data
def update_network_floor_plan(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
floorPlanId | Required |
TODO: Add a parameter description |
updateNetworkFloorPlan | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
floor_plan_id = 'floorPlanId'
collect['floor_plan_id'] = floor_plan_id
update_network_floor_plan = UpdateNetworkFloorPlanModel()
collect['update_network_floor_plan'] = update_network_floor_plan
result = floorplans_controller.update_network_floor_plan(collect)
delete_network_floor_plan
Destroy a floor plan
def delete_network_floor_plan(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
floorPlanId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
floor_plan_id = 'floorPlanId'
collect['floor_plan_id'] = floor_plan_id
floorplans_controller.delete_network_floor_plan(collect)
GroupPoliciesController
Get controller instance
An instance of the GroupPoliciesController
class can be accessed from the API Client.
group_policies_controller = client.group_policies
get_network_group_policies
List the group policies in a network
def get_network_group_policies(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = group_policies_controller.get_network_group_policies(network_id)
create_network_group_policy
Create a group policy
def create_network_group_policy(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkGroupPolicy | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_group_policy = CreateNetworkGroupPolicyModel()
collect['create_network_group_policy'] = create_network_group_policy
result = group_policies_controller.create_network_group_policy(collect)
get_network_group_policy
Display a group policy
def get_network_group_policy(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
groupPolicyId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
group_policy_id = 'groupPolicyId'
collect['group_policy_id'] = group_policy_id
result = group_policies_controller.get_network_group_policy(collect)
update_network_group_policy
Update a group policy
def update_network_group_policy(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
groupPolicyId | Required |
TODO: Add a parameter description |
updateNetworkGroupPolicy | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
group_policy_id = 'groupPolicyId'
collect['group_policy_id'] = group_policy_id
update_network_group_policy = UpdateNetworkGroupPolicyModel()
collect['update_network_group_policy'] = update_network_group_policy
result = group_policies_controller.update_network_group_policy(collect)
delete_network_group_policy
Delete a group policy
def delete_network_group_policy(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
groupPolicyId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
group_policy_id = 'groupPolicyId'
collect['group_policy_id'] = group_policy_id
group_policies_controller.delete_network_group_policy(collect)
HTTPServersController
Get controller instance
An instance of the HTTPServersController
class can be accessed from the API Client.
http_servers_controller = client.http_servers
get_network_http_servers
List the HTTP servers for a network
def get_network_http_servers(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = http_servers_controller.get_network_http_servers(network_id)
create_network_http_server
Add an HTTP server to a network
def create_network_http_server(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkHttpServer | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_http_server = CreateNetworkHttpServerModel()
collect['create_network_http_server'] = create_network_http_server
result = http_servers_controller.create_network_http_server(collect)
create_network_http_servers_webhook_test
Send a test webhook for a network
def create_network_http_servers_webhook_test(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkHttpServersWebhookTest | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_http_servers_webhook_test = CreateNetworkHttpServersWebhookTestModel()
collect['create_network_http_servers_webhook_test'] = create_network_http_servers_webhook_test
result = http_servers_controller.create_network_http_servers_webhook_test(collect)
get_network_http_servers_webhook_test
Return the status of a webhook test for a network
def get_network_http_servers_webhook_test(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
id = 'id'
collect['id'] = id
result = http_servers_controller.get_network_http_servers_webhook_test(collect)
get_network_http_server
Return an HTTP server for a network
def get_network_http_server(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
id = 'id'
collect['id'] = id
result = http_servers_controller.get_network_http_server(collect)
update_network_http_server
Update an HTTP server
def update_network_http_server(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
updateNetworkHttpServer | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
id = 'id'
collect['id'] = id
update_network_http_server = UpdateNetworkHttpServerModel()
collect['update_network_http_server'] = update_network_http_server
result = http_servers_controller.update_network_http_server(collect)
delete_network_http_server
Delete an HTTP server from a network
def delete_network_http_server(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
id = 'id'
collect['id'] = id
http_servers_controller.delete_network_http_server(collect)
IntrusionSettingsController
Get controller instance
An instance of the IntrusionSettingsController
class can be accessed from the API Client.
intrusion_settings_controller = client.intrusion_settings
get_network_security_intrusion_settings
Returns all supported intrusion settings for an MX network
def get_network_security_intrusion_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = intrusion_settings_controller.get_network_security_intrusion_settings(network_id)
update_network_security_intrusion_settings
Set the supported intrusion settings for an MX network
def update_network_security_intrusion_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSecurityIntrusionSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_security_intrusion_settings = UpdateNetworkSecurityIntrusionSettingsModel()
collect['update_network_security_intrusion_settings'] = update_network_security_intrusion_settings
result = intrusion_settings_controller.update_network_security_intrusion_settings(collect)
get_organization_security_intrusion_settings
Returns all supported intrusion settings for an organization
def get_organization_security_intrusion_settings(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = intrusion_settings_controller.get_organization_security_intrusion_settings(organization_id)
update_organization_security_intrusion_settings
Sets supported intrusion settings for an organization
def update_organization_security_intrusion_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
updateOrganizationSecurityIntrusionSettings | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
update_organization_security_intrusion_settings = UpdateOrganizationSecurityIntrusionSettingsModel()
collect['update_organization_security_intrusion_settings'] = update_organization_security_intrusion_settings
result = intrusion_settings_controller.update_organization_security_intrusion_settings(collect)
MRL3FirewallController
Get controller instance
An instance of the MRL3FirewallController
class can be accessed from the API Client.
mr_l_3_firewall_controller = client.mr_l_3_firewall
get_network_ssid_l_3_firewall_rules
Return the L3 firewall rules for an SSID on an MR network
def get_network_ssid_l_3_firewall_rules(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
number | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
number = 'number'
collect['number'] = number
result = mr_l_3_firewall_controller.get_network_ssid_l_3_firewall_rules(collect)
update_network_ssid_l_3_firewall_rules
Update the L3 firewall rules of an SSID on an MR network
def update_network_ssid_l_3_firewall_rules(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
number | Required |
TODO: Add a parameter description |
updateNetworkSsidL3FirewallRules | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
number = 'number'
collect['number'] = number
update_network_ssid_l_3_firewall_rules = UpdateNetworkSsidL3FirewallRulesModel()
collect['update_network_ssid_l_3_firewall_rules'] = update_network_ssid_l_3_firewall_rules
result = mr_l_3_firewall_controller.update_network_ssid_l_3_firewall_rules(collect)
MVSenseController
Get controller instance
An instance of the MVSenseController
class can be accessed from the API Client.
mv_sense_controller = client.mv_sense
get_device_camera_analytics_live
Returns live state from camera of analytics zones
def get_device_camera_analytics_live(self,
serial)
Parameters
Parameter | Tags | Description |
---|---|---|
serial | Required |
TODO: Add a parameter description |
Example Usage
serial = 'serial'
result = mv_sense_controller.get_device_camera_analytics_live(serial)
get_device_camera_analytics_overview
Returns an overview of aggregate analytics data for a timespan
def get_device_camera_analytics_overview(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
serial | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 365 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. The default is 1 hour. |
objectType | Optional |
[optional] The object type for which analytics will be retrieved. The default object type is person. The available types are [person, vehicle]. |
Example Usage
collect = {}
serial = 'serial'
collect['serial'] = serial
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 111.884369736949
collect['timespan'] = timespan
object_type = ObjectTypeEnum.PERSON
collect['object_type'] = object_type
result = mv_sense_controller.get_device_camera_analytics_overview(collect)
get_device_camera_analytics_recent
Returns most recent record for analytics zones
def get_device_camera_analytics_recent(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
serial | Required |
TODO: Add a parameter description |
objectType | Optional |
[optional] The object type for which analytics will be retrieved. The default object type is person. The available types are [person, vehicle]. |
Example Usage
collect = {}
serial = 'serial'
collect['serial'] = serial
object_type = ObjectTypeEnum.PERSON
collect['object_type'] = object_type
result = mv_sense_controller.get_device_camera_analytics_recent(collect)
get_device_camera_analytics_zones
Returns all configured analytic zones for this camera
def get_device_camera_analytics_zones(self,
serial)
Parameters
Parameter | Tags | Description |
---|---|---|
serial | Required |
TODO: Add a parameter description |
Example Usage
serial = 'serial'
result = mv_sense_controller.get_device_camera_analytics_zones(serial)
get_device_camera_analytics_zone_history
Return historical records for analytic zones
def get_device_camera_analytics_zone_history(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
serial | Required |
TODO: Add a parameter description |
zoneId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 365 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 14 hours after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 14 hours. The default is 1 hour. |
resolution | Optional |
The time resolution in seconds for returned data. The valid resolutions are: 60. The default is 60. |
objectType | Optional |
[optional] The object type for which analytics will be retrieved. The default object type is person. The available types are [person, vehicle]. |
Example Usage
collect = {}
serial = 'serial'
collect['serial'] = serial
zone_id = 'zoneId'
collect['zone_id'] = zone_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 111.884369736949
collect['timespan'] = timespan
resolution = 111
collect['resolution'] = resolution
object_type = ObjectTypeEnum.PERSON
collect['object_type'] = object_type
result = mv_sense_controller.get_device_camera_analytics_zone_history(collect)
MX11NATRulesController
Get controller instance
An instance of the MX11NATRulesController
class can be accessed from the API Client.
mx_1_1_nat_rules_controller = client.mx_1_1_nat_rules
get_network_one_to_one_nat_rules
Return the 1:1 NAT mapping rules for an MX network
def get_network_one_to_one_nat_rules(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_11_nat_rules_controller.get_network_one_to_one_nat_rules(network_id)
update_network_one_to_one_nat_rules
Set the 1:1 NAT mapping rules for an MX network
def update_network_one_to_one_nat_rules(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkOneToOneNatRules | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_one_to_one_nat_rules = UpdateNetworkOneToOneNatRulesModel()
collect['update_network_one_to_one_nat_rules'] = update_network_one_to_one_nat_rules
result = mx_11_nat_rules_controller.update_network_one_to_one_nat_rules(collect)
MX1ManyNATRulesController
Get controller instance
An instance of the MX1ManyNATRulesController
class can be accessed from the API Client.
mx_1_many_nat_rules_controller = client.mx_1_many_nat_rules
get_network_one_to_many_nat_rules
Return the 1:Many NAT mapping rules for an MX network
def get_network_one_to_many_nat_rules(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_1_many_nat_rules_controller.get_network_one_to_many_nat_rules(network_id)
update_network_one_to_many_nat_rules
Set the 1:Many NAT mapping rules for an MX network
def update_network_one_to_many_nat_rules(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkOneToManyNatRules | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_one_to_many_nat_rules = UpdateNetworkOneToManyNatRulesModel()
collect['update_network_one_to_many_nat_rules'] = update_network_one_to_many_nat_rules
result = mx_1_many_nat_rules_controller.update_network_one_to_many_nat_rules(collect)
MXL3FirewallController
Get controller instance
An instance of the MXL3FirewallController
class can be accessed from the API Client.
mx_l_3_firewall_controller = client.mx_l_3_firewall
get_network_l_3_firewall_rules
Return the L3 firewall rules for an MX network
def get_network_l_3_firewall_rules(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_l_3_firewall_controller.get_network_l_3_firewall_rules(network_id)
update_network_l_3_firewall_rules
Update the L3 firewall rules of an MX network
def update_network_l_3_firewall_rules(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkL3FirewallRules | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_l_3_firewall_rules = UpdateNetworkL3FirewallRulesModel()
collect['update_network_l_3_firewall_rules'] = update_network_l_3_firewall_rules
result = mx_l_3_firewall_controller.update_network_l_3_firewall_rules(collect)
MXL7ApplicationCategoriesController
Get controller instance
An instance of the MXL7ApplicationCategoriesController
class can be accessed from the API Client.
mx_l_7_application_categories_controller = client.mx_l_7_application_categories
get_network_l_7_firewall_rules_application_categories
Return the L7 firewall application categories and their associated applications for an MX network
def get_network_l_7_firewall_rules_application_categories(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_l_7_application_categories_controller.get_network_l_7_firewall_rules_application_categories(network_id)
MXL7FirewallController
Get controller instance
An instance of the MXL7FirewallController
class can be accessed from the API Client.
mx_l_7_firewall_controller = client.mx_l_7_firewall
get_network_l_7_firewall_rules
List the MX L7 firewall rules for an MX network
def get_network_l_7_firewall_rules(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_l_7_firewall_controller.get_network_l_7_firewall_rules(network_id)
update_network_l_7_firewall_rules
Update the MX L7 firewall rules for an MX network
def update_network_l_7_firewall_rules(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkL7FirewallRules | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_l_7_firewall_rules = UpdateNetworkL7FirewallRulesModel()
collect['update_network_l_7_firewall_rules'] = update_network_l_7_firewall_rules
result = mx_l_7_firewall_controller.update_network_l_7_firewall_rules(collect)
MXVLANPortsController
Get controller instance
An instance of the MXVLANPortsController
class can be accessed from the API Client.
mx_vlan_ports_controller = client.mx_vlan_ports
get_network_appliance_ports
List per-port VLAN settings for all ports of a MX.
def get_network_appliance_ports(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_vlan_ports_controller.get_network_appliance_ports(network_id)
get_network_appliance_port
Return per-port VLAN settings for a single MX port.
def get_network_appliance_port(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
appliancePortId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
appliance_port_id = 'appliancePortId'
collect['appliance_port_id'] = appliance_port_id
result = mx_vlan_ports_controller.get_network_appliance_port(collect)
update_network_appliance_port
Update the per-port VLAN settings for a single MX port.
def update_network_appliance_port(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
appliancePortId | Required |
TODO: Add a parameter description |
updateNetworkAppliancePort | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
appliance_port_id = 'appliancePortId'
collect['appliance_port_id'] = appliance_port_id
update_network_appliance_port = UpdateNetworkAppliancePortModel()
collect['update_network_appliance_port'] = update_network_appliance_port
result = mx_vlan_ports_controller.update_network_appliance_port(collect)
MXVPNFirewallController
Get controller instance
An instance of the MXVPNFirewallController
class can be accessed from the API Client.
mx_vpn_firewall_controller = client.mx_vpn_firewall
get_organization_vpn_firewall_rules
Return the firewall rules for an organization's site-to-site VPN
def get_organization_vpn_firewall_rules(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = mx_vpn_firewall_controller.get_organization_vpn_firewall_rules(organization_id)
update_organization_vpn_firewall_rules
Update the firewall rules of an organization's site-to-site VPN
def update_organization_vpn_firewall_rules(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
updateOrganizationVpnFirewallRules | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
update_organization_vpn_firewall_rules = UpdateOrganizationVpnFirewallRulesModel()
collect['update_organization_vpn_firewall_rules'] = update_organization_vpn_firewall_rules
result = mx_vpn_firewall_controller.update_organization_vpn_firewall_rules(collect)
MXCellularFirewallController
Get controller instance
An instance of the MXCellularFirewallController
class can be accessed from the API Client.
mx_cellular_firewall_controller = client.mx_cellular_firewall
get_network_cellular_firewall_rules
Return the cellular firewall rules for an MX network
def get_network_cellular_firewall_rules(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_cellular_firewall_controller.get_network_cellular_firewall_rules(network_id)
update_network_cellular_firewall_rules
Update the cellular firewall rules of an MX network
def update_network_cellular_firewall_rules(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkCellularFirewallRules | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_cellular_firewall_rules = UpdateNetworkCellularFirewallRulesModel()
collect['update_network_cellular_firewall_rules'] = update_network_cellular_firewall_rules
result = mx_cellular_firewall_controller.update_network_cellular_firewall_rules(collect)
MXPortForwardingRulesController
Get controller instance
An instance of the MXPortForwardingRulesController
class can be accessed from the API Client.
mx_port_forwarding_rules_controller = client.mx_port_forwarding_rules
get_network_port_forwarding_rules
Return the port forwarding rules for an MX network
def get_network_port_forwarding_rules(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_port_forwarding_rules_controller.get_network_port_forwarding_rules(network_id)
update_network_port_forwarding_rules
Update the port forwarding rules for an MX network
def update_network_port_forwarding_rules(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkPortForwardingRules | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_port_forwarding_rules = UpdateNetworkPortForwardingRulesModel()
collect['update_network_port_forwarding_rules'] = update_network_port_forwarding_rules
result = mx_port_forwarding_rules_controller.update_network_port_forwarding_rules(collect)
MXStaticRoutesController
Get controller instance
An instance of the MXStaticRoutesController
class can be accessed from the API Client.
mx_static_routes_controller = client.mx_static_routes
get_network_static_routes
List the static routes for an MX or teleworker network
def get_network_static_routes(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_static_routes_controller.get_network_static_routes(network_id)
create_network_static_route
Add a static route for an MX or teleworker network
def create_network_static_route(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkStaticRoute | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_static_route = CreateNetworkStaticRouteModel()
collect['create_network_static_route'] = create_network_static_route
result = mx_static_routes_controller.create_network_static_route(collect)
get_network_static_route
Return a static route for an MX or teleworker network
def get_network_static_route(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
srId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
sr_id = 'srId'
collect['sr_id'] = sr_id
result = mx_static_routes_controller.get_network_static_route(collect)
update_network_static_route
Update a static route for an MX or teleworker network
def update_network_static_route(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
srId | Required |
TODO: Add a parameter description |
updateNetworkStaticRoute | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
sr_id = 'srId'
collect['sr_id'] = sr_id
update_network_static_route = UpdateNetworkStaticRouteModel()
collect['update_network_static_route'] = update_network_static_route
result = mx_static_routes_controller.update_network_static_route(collect)
delete_network_static_route
Delete a static route from an MX or teleworker network
def delete_network_static_route(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
srId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
sr_id = 'srId'
collect['sr_id'] = sr_id
mx_static_routes_controller.delete_network_static_route(collect)
MXWarmSpareSettingsController
Get controller instance
An instance of the MXWarmSpareSettingsController
class can be accessed from the API Client.
mx_warm_spare_settings_controller = client.mx_warm_spare_settings
swap_network_warmspare
Swap MX primary and warm spare appliances
def swap_network_warmspare(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_warm_spare_settings_controller.swap_network_warmspare(network_id)
get_network_warm_spare_settings
Return MX warm spare settings
def get_network_warm_spare_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = mx_warm_spare_settings_controller.get_network_warm_spare_settings(network_id)
update_network_warm_spare_settings
Update MX warm spare settings
def update_network_warm_spare_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkWarmSpareSettings | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_warm_spare_settings = UpdateNetworkWarmSpareSettingsModel()
collect['update_network_warm_spare_settings'] = update_network_warm_spare_settings
result = mx_warm_spare_settings_controller.update_network_warm_spare_settings(collect)
MalwareSettingsController
Get controller instance
An instance of the MalwareSettingsController
class can be accessed from the API Client.
malware_settings_controller = client.malware_settings
get_network_security_malware_settings
Returns all supported malware settings for an MX network
def get_network_security_malware_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = malware_settings_controller.get_network_security_malware_settings(network_id)
update_network_security_malware_settings
Set the supported malware settings for an MX network
def update_network_security_malware_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSecurityMalwareSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_security_malware_settings = UpdateNetworkSecurityMalwareSettingsModel()
collect['update_network_security_malware_settings'] = update_network_security_malware_settings
result = malware_settings_controller.update_network_security_malware_settings(collect)
ManagementInterfaceSettingsController
Get controller instance
An instance of the ManagementInterfaceSettingsController
class can be accessed from the API Client.
management_interface_settings_controller = client.management_interface_settings
get_network_device_management_interface_settings
Return the management interface settings for a device
def get_network_device_management_interface_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
result = management_interface_settings_controller.get_network_device_management_interface_settings(collect)
update_network_device_management_interface_settings
Update the management interface settings for a device
def update_network_device_management_interface_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
updateNetworkDeviceManagementInterfaceSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
update_network_device_management_interface_settings = UpdateNetworkDeviceManagementInterfaceSettingsModel()
collect['update_network_device_management_interface_settings'] = update_network_device_management_interface_settings
result = management_interface_settings_controller.update_network_device_management_interface_settings(collect)
MerakiAuthUsersController
Get controller instance
An instance of the MerakiAuthUsersController
class can be accessed from the API Client.
meraki_auth_users_controller = client.meraki_auth_users
get_network_meraki_auth_users
List the splash or RADIUS users configured under Meraki Authentication for a network
def get_network_meraki_auth_users(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = meraki_auth_users_controller.get_network_meraki_auth_users(network_id)
get_network_meraki_auth_user
Return the Meraki Auth splash or RADIUS user
def get_network_meraki_auth_user(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
merakiAuthUserId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
meraki_auth_user_id = 'merakiAuthUserId'
collect['meraki_auth_user_id'] = meraki_auth_user_id
result = meraki_auth_users_controller.get_network_meraki_auth_user(collect)
NamedTagScopeController
Get controller instance
An instance of the NamedTagScopeController
class can be accessed from the API Client.
named_tag_scope_controller = client.named_tag_scope
get_network_sm_target_groups
List the target groups in this network
def get_network_sm_target_groups(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
withDetails | Optional |
Boolean indicating if the the ids of the devices or users scoped by the target group should be included in the response |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
with_details = True
collect['with_details'] = with_details
result = named_tag_scope_controller.get_network_sm_target_groups(collect)
create_network_sm_target_group
Add a target group
def create_network_sm_target_group(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkSmTargetGroup | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_sm_target_group = CreateNetworkSmTargetGroupModel()
collect['create_network_sm_target_group'] = create_network_sm_target_group
result = named_tag_scope_controller.create_network_sm_target_group(collect)
get_network_sm_target_group
Return a target group
def get_network_sm_target_group(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
targetGroupId | Required |
TODO: Add a parameter description |
withDetails | Optional |
Boolean indicating if the the ids of the devices or users scoped by the target group should be included in the response |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
target_group_id = 'targetGroupId'
collect['target_group_id'] = target_group_id
with_details = True
collect['with_details'] = with_details
result = named_tag_scope_controller.get_network_sm_target_group(collect)
update_network_sm_target_group
Update a target group
def update_network_sm_target_group(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
targetGroupId | Required |
TODO: Add a parameter description |
updateNetworkSmTargetGroup | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
target_group_id = 'targetGroupId'
collect['target_group_id'] = target_group_id
update_network_sm_target_group = UpdateNetworkSmTargetGroupModel()
collect['update_network_sm_target_group'] = update_network_sm_target_group
result = named_tag_scope_controller.update_network_sm_target_group(collect)
delete_network_sm_target_group
Delete a target group from a network
def delete_network_sm_target_group(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
targetGroupId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
target_group_id = 'targetGroupId'
collect['target_group_id'] = target_group_id
named_tag_scope_controller.delete_network_sm_target_group(collect)
NetflowSettingsController
Get controller instance
An instance of the NetflowSettingsController
class can be accessed from the API Client.
netflow_settings_controller = client.netflow_settings
get_network_netflow_settings
Return the NetFlow traffic reporting settings for a network
def get_network_netflow_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = netflow_settings_controller.get_network_netflow_settings(network_id)
update_network_netflow_settings
Update the NetFlow traffic reporting settings for a network
def update_network_netflow_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetwork_netflow_Settings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_netflow_settings = UpdateNetworkNetflowSettingsModel()
collect['update_network_netflow_settings'] = update_network_netflow_settings
result = netflow_settings_controller.update_network_netflow_settings(collect)
NetworksController
Get controller instance
An instance of the NetworksController
class can be accessed from the API Client.
networks_controller = client.networks
get_network
Return a network
def get_network(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = networks_controller.get_network(network_id)
update_network
Update a network
def update_network(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetwork | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network = UpdateNetworkModel()
collect['update_network'] = update_network
result = networks_controller.update_network(collect)
delete_network
Delete a network
def delete_network(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
networks_controller.delete_network(network_id)
get_network_access_policies
List the access policies for this network. Only valid for MS networks.
def get_network_access_policies(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = networks_controller.get_network_access_policies(network_id)
get_network_air_marshal
List Air Marshal scan results from a network
def get_network_air_marshal(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 31 days from today. |
timespan | Optional |
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. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
timespan = 62.1122610718535
collect['timespan'] = timespan
result = networks_controller.get_network_air_marshal(collect)
bind_network
Bind a network to a template.
def bind_network(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
bindNetwork | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
bind_network = BindNetworkModel()
collect['bind_network'] = bind_network
networks_controller.bind_network(collect)
get_network_bluetooth_settings
Return the Bluetooth settings for a network. Bluetooth settings must be enabled on the network.
def get_network_bluetooth_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = networks_controller.get_network_bluetooth_settings(network_id)
update_network_bluetooth_settings
Update the Bluetooth settings for a network. See the docs page for Bluetooth settings.
def update_network_bluetooth_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkBluetoothSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_bluetooth_settings = UpdateNetworkBluetoothSettingsModel()
collect['update_network_bluetooth_settings'] = update_network_bluetooth_settings
result = networks_controller.update_network_bluetooth_settings(collect)
get_network_site_to_site_vpn
Return the site-to-site VPN settings of a network. Only valid for MX networks.
def get_network_site_to_site_vpn(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = networks_controller.get_network_site_to_site_vpn(network_id)
update_network_site_to_site_vpn
Update the site-to-site VPN settings of a network. Only valid for MX networks in NAT mode.
def update_network_site_to_site_vpn(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSiteToSiteVpn | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_site_to_site_vpn = UpdateNetworkSiteToSiteVpnModel()
collect['update_network_site_to_site_vpn'] = update_network_site_to_site_vpn
result = networks_controller.update_network_site_to_site_vpn(collect)
split_network
Split a combined network into individual networks for each type of device
def split_network(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = networks_controller.split_network(network_id)
get_network_traffic
The traffic analysis data for this network. <a href="https://documentation.meraki.com/MR/Monitoring_and_Reporting/Hostname_Visibility">Traffic Analysis with Hostname Visibility</a> must be enabled on the network.
def get_network_traffic(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 30 days from today. |
timespan | Optional |
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 | Optional |
Filter the data by device type: combined (default), wireless, switch, appliance. |
When using combined, for each rule the data will come from the device type with the most usage. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
timespan = 62.1122610718535
collect['timespan'] = timespan
device_type = 'deviceType'
collect['device_type'] = device_type
result = networks_controller.get_network_traffic(collect)
unbind_network
Unbind a network from a template.
def unbind_network(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
networks_controller.unbind_network(network_id)
get_organization_networks
List the networks in an organization
def get_organization_networks(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
configTemplateId | Optional |
An optional parameter that is the ID of a config template. Will return all networks bound to that template. |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
config_template_id = 'configTemplateId'
collect['config_template_id'] = config_template_id
result = networks_controller.get_organization_networks(collect)
create_organization_network
Create a network
def create_organization_network(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
createOrganizationNetwork | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
create_organization_network = CreateOrganizationNetworkModel()
collect['create_organization_network'] = create_organization_network
result = networks_controller.create_organization_network(collect)
combine_organization_networks
Combine multiple networks into a single network
def combine_organization_networks(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
combineOrganizationNetworks | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
combine_organization_networks = CombineOrganizationNetworksModel()
collect['combine_organization_networks'] = combine_organization_networks
result = networks_controller.combine_organization_networks(collect)
OpenAPISpecController
Get controller instance
An instance of the OpenAPISpecController
class can be accessed from the API Client.
open_api_spec_controller = client.open_api_spec
get_organization_openapi_spec
Return the OpenAPI 2.0 Specification of the organization's API documentation in JSON
def get_organization_openapi_spec(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = open_api_spec_controller.get_organization_openapi_spec(organization_id)
OrganizationsController
Get controller instance
An instance of the OrganizationsController
class can be accessed from the API Client.
organizations_controller = client.organizations
get_organizations
List the organizations that the user has privileges on
def get_organizations(self)
Example Usage
result = organizations_controller.get_organizations()
create_organization
Create a new organization
def create_organization(self,
create_organization)
Parameters
Parameter | Tags | Description |
---|---|---|
createOrganization | Required |
TODO: Add a parameter description |
Example Usage
create_organization = CreateOrganizationModel()
result = organizations_controller.create_organization(create_organization)
get_organization
Return an organization
def get_organization(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = organizations_controller.get_organization(organization_id)
update_organization
Update an organization
def update_organization(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
updateOrganization | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
update_organization = UpdateOrganizationModel()
collect['update_organization'] = update_organization
result = organizations_controller.update_organization(collect)
delete_organization
Delete an organization
def delete_organization(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
organizations_controller.delete_organization(organization_id)
claim_organization
Claim a list of devices, licenses, and/or orders into an organization. When claiming by order, all devices and licenses in the order will be claimed; licenses will be added to the organization and devices will be placed in the organization's inventory.
def claim_organization(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
claimOrganization | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
claim_organization = ClaimOrganizationModel()
collect['claim_organization'] = claim_organization
result = organizations_controller.claim_organization(collect)
clone_organization
Create a new organization by cloning the addressed organization
def clone_organization(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
cloneOrganization | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
clone_organization = CloneOrganizationModel()
collect['clone_organization'] = clone_organization
result = organizations_controller.clone_organization(collect)
get_organization_device_statuses
List the status of every Meraki device in the organization
def get_organization_device_statuses(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = organizations_controller.get_organization_device_statuses(organization_id)
get_organization_inventory
Return the inventory for an organization
def get_organization_inventory(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = organizations_controller.get_organization_inventory(organization_id)
get_organization_license_state
Return the license state for an organization
def get_organization_license_state(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = organizations_controller.get_organization_license_state(organization_id)
get_organization_third_party_vpn_peers
Return the third party VPN peers for an organization
def get_organization_third_party_vpn_peers(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = organizations_controller.get_organization_third_party_vpn_peers(organization_id)
update_organization_third_party_vpn_peers
Update the third party VPN peers for an organization
def update_organization_third_party_vpn_peers(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
updateOrganizationThirdPartyVPNPeers | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
update_organization_third_party_vpn_peers = UpdateOrganizationThirdPartyVPNPeersModel()
collect['update_organization_third_party_vpn_peers'] = update_organization_third_party_vpn_peers
result = organizations_controller.update_organization_third_party_vpn_peers(collect)
get_organization_uplinks_loss_and_latency
Return the uplink loss and latency for every MX in the organization from at latest 2 minutes ago
def get_organization_uplinks_loss_and_latency(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 365 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 5 minutes after t0. The latest possible time that t1 can be is 2 minutes into the past. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 5 minutes. The default is 5 minutes. |
uplink | Optional |
Optional filter for a specific WAN uplink. Valid uplinks are wan1, wan2, cellular. Default will return all uplinks. |
ip | Optional |
Optional filter for a specific destination IP. Default will return all destination IPs. |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 62.1122610718535
collect['timespan'] = timespan
uplink = UplinkEnum.WAN1
collect['uplink'] = uplink
ip = 'ip'
collect['ip'] = ip
result = organizations_controller.get_organization_uplinks_loss_and_latency(collect)
PIIController
Get controller instance
An instance of the PIIController
class can be accessed from the API Client.
pii_controller = client.pii
get_network_pii_pii_keys
List the keys required to access Personally Identifiable Information (PII) for a given identifier. Exactly one identifier will be accepted. If the organization contains org-wide Systems Manager users matching the key provided then there will be an entry with the key "0" containing the applicable keys.
ALTERNATE PATH
/organizations/{organizationId}/pii/piiKeys
def get_network_pii_pii_keys(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
username | Optional |
The username of a Systems Manager user |
Optional |
The email of a network user account or a Systems Manager device | |
mac | Optional |
The MAC of a network client device or a Systems Manager device |
serial | Optional |
The serial of a Systems Manager device |
imei | Optional |
The IMEI of a Systems Manager device |
bluetoothMac | Optional |
The MAC of a Bluetooth client |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
username = 'username'
collect['username'] = username
email = 'email'
collect['email'] = email
mac = 'mac'
collect['mac'] = mac
serial = 'serial'
collect['serial'] = serial
imei = 'imei'
collect['imei'] = imei
bluetooth_mac = 'bluetoothMac'
collect['bluetooth_mac'] = bluetooth_mac
result = pii_controller.get_network_pii_pii_keys(collect)
get_network_pii_requests
List the PII requests for this network or organization
ALTERNATE PATH
/organizations/{organizationId}/pii/requests
def get_network_pii_requests(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = pii_controller.get_network_pii_requests(network_id)
create_network_pii_request
Submit a new delete or restrict processing PII request
ALTERNATE PATH
/organizations/{organizationId}/pii/requests
def create_network_pii_request(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkPiiRequest | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_pii_request = CreateNetworkPiiRequestModel()
collect['create_network_pii_request'] = create_network_pii_request
result = pii_controller.create_network_pii_request(collect)
get_network_pii_request
Return a PII request
ALTERNATE PATH
/organizations/{organizationId}/pii/requests/{requestId}
def get_network_pii_request(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
requestId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
request_id = 'requestId'
collect['request_id'] = request_id
result = pii_controller.get_network_pii_request(collect)
delete_network_pii_request
Delete a restrict processing PII request
ALTERNATE PATH
/organizations/{organizationId}/pii/requests/{requestId}
def delete_network_pii_request(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
requestId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
request_id = 'requestId'
collect['request_id'] = request_id
pii_controller.delete_network_pii_request(collect)
get_network_pii_sm_devices_for_key
Given a piece of Personally Identifiable Information (PII), return the Systems Manager device ID(s) associated with that identifier. These device IDs can be used with the Systems Manager API endpoints to retrieve device details. Exactly one identifier will be accepted.
ALTERNATE PATH
/organizations/{organizationId}/pii/smDevicesForKey
def get_network_pii_sm_devices_for_key(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
username | Optional |
The username of a Systems Manager user |
Optional |
The email of a network user account or a Systems Manager device | |
mac | Optional |
The MAC of a network client device or a Systems Manager device |
serial | Optional |
The serial of a Systems Manager device |
imei | Optional |
The IMEI of a Systems Manager device |
bluetoothMac | Optional |
The MAC of a Bluetooth client |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
username = 'username'
collect['username'] = username
email = 'email'
collect['email'] = email
mac = 'mac'
collect['mac'] = mac
serial = 'serial'
collect['serial'] = serial
imei = 'imei'
collect['imei'] = imei
bluetooth_mac = 'bluetoothMac'
collect['bluetooth_mac'] = bluetooth_mac
result = pii_controller.get_network_pii_sm_devices_for_key(collect)
get_network_pii_sm_owners_for_key
Given a piece of Personally Identifiable Information (PII), return the Systems Manager owner ID(s) associated with that identifier. These owner IDs can be used with the Systems Manager API endpoints to retrieve owner details. Exactly one identifier will be accepted.
ALTERNATE PATH
/organizations/{organizationId}/pii/smOwnersForKey
def get_network_pii_sm_owners_for_key(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
username | Optional |
The username of a Systems Manager user |
Optional |
The email of a network user account or a Systems Manager device | |
mac | Optional |
The MAC of a network client device or a Systems Manager device |
serial | Optional |
The serial of a Systems Manager device |
imei | Optional |
The IMEI of a Systems Manager device |
bluetoothMac | Optional |
The MAC of a Bluetooth client |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
username = 'username'
collect['username'] = username
email = 'email'
collect['email'] = email
mac = 'mac'
collect['mac'] = mac
serial = 'serial'
collect['serial'] = serial
imei = 'imei'
collect['imei'] = imei
bluetooth_mac = 'bluetoothMac'
collect['bluetooth_mac'] = bluetooth_mac
result = pii_controller.get_network_pii_sm_owners_for_key(collect)
RadioSettingsController
Get controller instance
An instance of the RadioSettingsController
class can be accessed from the API Client.
radio_settings_controller = client.radio_settings
get_network_device_wireless_radio_settings
Return the radio settings of a device
def get_network_device_wireless_radio_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
result = radio_settings_controller.get_network_device_wireless_radio_settings(collect)
update_network_device_wireless_radio_settings
Update the radio settings of a device
def update_network_device_wireless_radio_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
updateNetworkDeviceWirelessRadioSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
update_network_device_wireless_radio_settings = UpdateNetworkDeviceWirelessRadioSettingsModel()
collect['update_network_device_wireless_radio_settings'] = update_network_device_wireless_radio_settings
result = radio_settings_controller.update_network_device_wireless_radio_settings(collect)
get_network_wireless_rf_profiles
List the non-basic RF profiles for this network
def get_network_wireless_rf_profiles(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
includeTemplateProfiles | Optional |
If the network is bound to a template, this parameter controls whether or not the non-basic RF profiles defined on the template |
should be included in the response alongside the non-basic profiles defined on the bound network. Defaults to false. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
include_template_profiles = False
collect['include_template_profiles'] = include_template_profiles
result = radio_settings_controller.get_network_wireless_rf_profiles(collect)
create_network_wireless_rf_profile
Creates new RF profile for this network
def create_network_wireless_rf_profile(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkWirelessRfProfile | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_wireless_rf_profile = CreateNetworkWirelessRfProfileModel()
collect['create_network_wireless_rf_profile'] = create_network_wireless_rf_profile
result = radio_settings_controller.create_network_wireless_rf_profile(collect)
update_network_wireless_rf_profile
Updates specified RF profile for this network
def update_network_wireless_rf_profile(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
rfProfileId | Required |
TODO: Add a parameter description |
updateNetworkWirelessRfProfile | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
rf_profile_id = 'rfProfileId'
collect['rf_profile_id'] = rf_profile_id
update_network_wireless_rf_profile = UpdateNetworkWirelessRfProfileModel()
collect['update_network_wireless_rf_profile'] = update_network_wireless_rf_profile
result = radio_settings_controller.update_network_wireless_rf_profile(collect)
delete_network_wireless_rf_profile
Delete a RF Profile
def delete_network_wireless_rf_profile(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
rfProfileId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
rf_profile_id = 'rfProfileId'
collect['rf_profile_id'] = rf_profile_id
radio_settings_controller.delete_network_wireless_rf_profile(collect)
get_network_wireless_rf_profile
Return a RF profile
def get_network_wireless_rf_profile(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
rfProfileId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
rf_profile_id = 'rfProfileId'
collect['rf_profile_id'] = rf_profile_id
result = radio_settings_controller.get_network_wireless_rf_profile(collect)
SAMLRolesController
Get controller instance
An instance of the SAMLRolesController
class can be accessed from the API Client.
saml_roles_controller = client.saml_roles
get_organization_saml_roles
List the SAML roles for this organization
def get_organization_saml_roles(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = saml_roles_controller.get_organization_saml_roles(organization_id)
create_organization_saml_role
Create a SAML role
def create_organization_saml_role(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
createOrganizationSamlRole | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
create_organization_saml_role = CreateOrganizationSamlRoleModel()
collect['create_organization_saml_role'] = create_organization_saml_role
result = saml_roles_controller.create_organization_saml_role(collect)
get_organization_saml_role
Return a SAML role
def get_organization_saml_role(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
id = 'id'
collect['id'] = id
result = saml_roles_controller.get_organization_saml_role(collect)
update_organization_saml_role
Update a SAML role
def update_organization_saml_role(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
updateOrganizationSamlRole | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
id = 'id'
collect['id'] = id
update_organization_saml_role = UpdateOrganizationSamlRoleModel()
collect['update_organization_saml_role'] = update_organization_saml_role
result = saml_roles_controller.update_organization_saml_role(collect)
delete_organization_saml_role
Remove a SAML role
def delete_organization_saml_role(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
id = 'id'
collect['id'] = id
saml_roles_controller.delete_organization_saml_role(collect)
SMController
Get controller instance
An instance of the SMController
class can be accessed from the API Client.
sm_controller = client.sm
create_network_sm_app_polaris
Create a new Polaris app
def create_network_sm_app_polaris(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkSmAppPolaris | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_sm_app_polaris = CreateNetworkSmAppPolarisModel()
collect['create_network_sm_app_polaris'] = create_network_sm_app_polaris
result = sm_controller.create_network_sm_app_polaris(collect)
get_network_sm_app_polaris
Get details for a Cisco Polaris app if it exists
def get_network_sm_app_polaris(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
bundleId | Optional |
The bundle ID of the app to be found, defaults to com.cisco.ciscosecurity.app |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
bundle_id = 'bundleId'
collect['bundle_id'] = bundle_id
result = sm_controller.get_network_sm_app_polaris(collect)
update_network_sm_app_polaris
Update an existing Polaris app
def update_network_sm_app_polaris(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
appId | Required |
TODO: Add a parameter description |
updateNetworkSmAppPolaris | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
app_id = 'appId'
collect['app_id'] = app_id
update_network_sm_app_polaris = UpdateNetworkSmAppPolarisModel()
collect['update_network_sm_app_polaris'] = update_network_sm_app_polaris
result = sm_controller.update_network_sm_app_polaris(collect)
delete_network_sm_app_polaris
Delete a Cisco Polaris app
def delete_network_sm_app_polaris(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
appId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
app_id = 'appId'
collect['app_id'] = app_id
result = sm_controller.delete_network_sm_app_polaris(collect)
create_network_sm_bypass_activation_lock_attempt
Bypass activation lock attempt
def create_network_sm_bypass_activation_lock_attempt(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkSmBypassActivationLockAttempt | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_sm_bypass_activation_lock_attempt = CreateNetworkSmBypassActivationLockAttemptModel()
collect['create_network_sm_bypass_activation_lock_attempt'] = create_network_sm_bypass_activation_lock_attempt
result = sm_controller.create_network_sm_bypass_activation_lock_attempt(collect)
get_network_sm_bypass_activation_lock_attempt
Bypass activation lock attempt status
def get_network_sm_bypass_activation_lock_attempt(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
attemptId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
attempt_id = 'attemptId'
collect['attempt_id'] = attempt_id
result = sm_controller.get_network_sm_bypass_activation_lock_attempt(collect)
update_network_sm_device_fields
Modify the fields of a device
def update_network_sm_device_fields(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSmDeviceFields | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_sm_device_fields = UpdateNetworkSmDeviceFieldsModel()
collect['update_network_sm_device_fields'] = update_network_sm_device_fields
result = sm_controller.update_network_sm_device_fields(collect)
wipe_network_sm_device
Wipe a device
def wipe_network_sm_device(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
wipeNetworkSmDevice | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
wipe_network_sm_device = WipeNetworkSmDeviceModel()
collect['wipe_network_sm_device'] = wipe_network_sm_device
result = sm_controller.wipe_network_sm_device(collect)
refresh_network_sm_device_details
Refresh the details of a device
def refresh_network_sm_device_details(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
deviceId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
device_id = 'deviceId'
collect['device_id'] = device_id
sm_controller.refresh_network_sm_device_details(collect)
get_network_sm_devices
List the devices enrolled in an SM network with various specified fields and filters
def get_network_sm_devices(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
fields | Optional |
Additional fields that will be displayed for each device. Multiple fields can be passed in as comma separated values. |
The default fields are: id, name, tags, ssid, wifiMac, osName, systemModel, uuid, and serialNumber. The additional fields are: ip,
systemType, availableDeviceCapacity, kioskAppName, biosVersion, lastConnected, missingAppsCount, userSuppliedAddress, location, lastUser,
ownerEmail, ownerUsername, publicIp, phoneNumber, diskInfoJson, deviceCapacity, isManaged, hadMdm, isSupervised, meid, imei, iccid,
simCarrierNetwork, cellularDataUsed, isHotspotEnabled, createdAt, batteryEstCharge, quarantined, avName, avRunning, asName, fwName,
isRooted, loginRequired, screenLockEnabled, screenLockDelay, autoLoginDisabled, autoTags, hasMdm, hasDesktopAgent, diskEncryptionEnabled,
hardwareEncryptionCaps, passCodeLock, usesHardwareKeystore, and androidSecurityPatchVersion. |
| wifiMacs | Optional
| Filter devices by wifi mac(s). Multiple wifi macs can be passed in as comma separated values. |
| serials | Optional
| Filter devices by serial(s). Multiple serials can be passed in as comma separated values. |
| ids | Optional
| Filter devices by id(s). Multiple ids can be passed in as comma separated values. |
| scope | Optional
| Specify a scope (one of all, none, withAny, withAll, withoutAny, or withoutAll) and a set of tags as comma separated values. |
| batchSize | Optional
| Number of devices to return, 1000 is the default as well as the max. |
| batchToken | Optional
| If the network has more devices than the batch size, a batch token will be returned
as a part of the device list. To see the remainder of the devices, pass in the batchToken as a parameter in the next request.
Requests made with the batchToken do not require additional parameters as the batchToken includes the parameters passed in
with the original request. Additional parameters passed in with the batchToken will be ignored. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
fields = 'fields'
collect['fields'] = fields
wifi_macs = 'wifiMacs'
collect['wifi_macs'] = wifi_macs
serials = 'serials'
collect['serials'] = serials
ids = 'ids'
collect['ids'] = ids
scope = 'scope'
collect['scope'] = scope
batch_size = 225
collect['batch_size'] = batch_size
batch_token = 'batchToken'
collect['batch_token'] = batch_token
result = sm_controller.get_network_sm_devices(collect)
checkin_network_sm_devices
Force check-in a set of devices
def checkin_network_sm_devices(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
checkinNetworkSmDevices | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
checkin_network_sm_devices = CheckinNetworkSmDevicesModel()
collect['checkin_network_sm_devices'] = checkin_network_sm_devices
result = sm_controller.checkin_network_sm_devices(collect)
move_network_sm_devices
Move a set of devices to a new network
def move_network_sm_devices(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
moveNetworkSmDevices | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
move_network_sm_devices = MoveNetworkSmDevicesModel()
collect['move_network_sm_devices'] = move_network_sm_devices
result = sm_controller.move_network_sm_devices(collect)
update_network_sm_devices_tags
Add, delete, or update the tags of a set of devices
def update_network_sm_devices_tags(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSmDevicesTags | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_sm_devices_tags = UpdateNetworkSmDevicesTagsModel()
collect['update_network_sm_devices_tags'] = update_network_sm_devices_tags
result = sm_controller.update_network_sm_devices_tags(collect)
unenroll_network_sm_device
Unenroll a device
def unenroll_network_sm_device(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
deviceId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
device_id = 'deviceId'
collect['device_id'] = device_id
result = sm_controller.unenroll_network_sm_device(collect)
create_network_sm_profile_clarity
Create a new profile containing a Cisco Clarity payload
def create_network_sm_profile_clarity(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkSmProfileClarity | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_sm_profile_clarity = CreateNetworkSmProfileClarityModel()
collect['create_network_sm_profile_clarity'] = create_network_sm_profile_clarity
result = sm_controller.create_network_sm_profile_clarity(collect)
update_network_sm_profile_clarity
Update an existing profile containing a Cisco Clarity payload
def update_network_sm_profile_clarity(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
profileId | Required |
TODO: Add a parameter description |
updateNetworkSmProfileClarity | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
profile_id = 'profileId'
collect['profile_id'] = profile_id
update_network_sm_profile_clarity = UpdateNetworkSmProfileClarityModel()
collect['update_network_sm_profile_clarity'] = update_network_sm_profile_clarity
result = sm_controller.update_network_sm_profile_clarity(collect)
add_network_sm_profile_clarity
Add a Cisco Clarity payload to an existing profile
def add_network_sm_profile_clarity(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
profileId | Required |
TODO: Add a parameter description |
addNetworkSmProfileClarity | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
profile_id = 'profileId'
collect['profile_id'] = profile_id
add_network_sm_profile_clarity = AddNetworkSmProfileClarityModel()
collect['add_network_sm_profile_clarity'] = add_network_sm_profile_clarity
result = sm_controller.add_network_sm_profile_clarity(collect)
get_network_sm_profile_clarity
Get details for a Cisco Clarity payload
def get_network_sm_profile_clarity(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
profileId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
profile_id = 'profileId'
collect['profile_id'] = profile_id
result = sm_controller.get_network_sm_profile_clarity(collect)
delete_network_sm_profile_clarity
Delete a Cisco Clarity payload. Deletes the entire profile if it's empty after removing the payload.
def delete_network_sm_profile_clarity(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
profileId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
profile_id = 'profileId'
collect['profile_id'] = profile_id
result = sm_controller.delete_network_sm_profile_clarity(collect)
create_network_sm_profile_umbrella
Create a new profile containing a Cisco Umbrella payload
def create_network_sm_profile_umbrella(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkSmProfileUmbrella | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_sm_profile_umbrella = CreateNetworkSmProfileUmbrellaModel()
collect['create_network_sm_profile_umbrella'] = create_network_sm_profile_umbrella
result = sm_controller.create_network_sm_profile_umbrella(collect)
update_network_sm_profile_umbrella
Update an existing profile containing a Cisco Umbrella payload
def update_network_sm_profile_umbrella(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
profileId | Required |
TODO: Add a parameter description |
updateNetworkSmProfileUmbrella | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
profile_id = 'profileId'
collect['profile_id'] = profile_id
update_network_sm_profile_umbrella = UpdateNetworkSmProfileUmbrellaModel()
collect['update_network_sm_profile_umbrella'] = update_network_sm_profile_umbrella
result = sm_controller.update_network_sm_profile_umbrella(collect)
add_network_sm_profile_umbrella
Add a Cisco Umbrella payload to an existing profile
def add_network_sm_profile_umbrella(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
profileId | Required |
TODO: Add a parameter description |
addNetworkSmProfileUmbrella | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
profile_id = 'profileId'
collect['profile_id'] = profile_id
add_network_sm_profile_umbrella = AddNetworkSmProfileUmbrellaModel()
collect['add_network_sm_profile_umbrella'] = add_network_sm_profile_umbrella
result = sm_controller.add_network_sm_profile_umbrella(collect)
get_network_sm_profile_umbrella
Get details for a Cisco Umbrella payload
def get_network_sm_profile_umbrella(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
profileId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
profile_id = 'profileId'
collect['profile_id'] = profile_id
result = sm_controller.get_network_sm_profile_umbrella(collect)
delete_network_sm_profile_umbrella
Delete a Cisco Umbrella payload. Deletes the entire profile if it's empty after removing the payload
def delete_network_sm_profile_umbrella(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
profileId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
profile_id = 'profileId'
collect['profile_id'] = profile_id
result = sm_controller.delete_network_sm_profile_umbrella(collect)
get_network_sm_profiles
List all the profiles in the network
def get_network_sm_profiles(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = sm_controller.get_network_sm_profiles(network_id)
get_network_sm_user_device_profiles
Get the profiles associated with a user
def get_network_sm_user_device_profiles(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
userId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
user_id = 'userId'
collect['user_id'] = user_id
result = sm_controller.get_network_sm_user_device_profiles(collect)
get_network_sm_user_softwares
Get a list of softwares associated with a user
def get_network_sm_user_softwares(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
userId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
user_id = 'userId'
collect['user_id'] = user_id
result = sm_controller.get_network_sm_user_softwares(collect)
get_network_sm_users
List the owners in an SM network with various specified fields and filters
def get_network_sm_users(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
ids | Optional |
Filter users by id(s). Multiple ids can be passed in as comma separated values. |
usernames | Optional |
Filter users by username(s). Multiple usernames can be passed in as comma separated values. |
emails | Optional |
Filter users by email(s). Multiple emails can be passed in as comma separated values. |
scope | Optional |
Specifiy a scope (one of all, none, withAny, withAll, withoutAny, withoutAll) and a set of tags as comma separated values. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
ids = 'ids'
collect['ids'] = ids
usernames = 'usernames'
collect['usernames'] = usernames
emails = 'emails'
collect['emails'] = emails
scope = 'scope'
collect['scope'] = scope
result = sm_controller.get_network_sm_users(collect)
get_network_sm_cellular_usage_history
Return the client's daily cellular data usage history. Usage data is in kilobytes.
def get_network_sm_cellular_usage_history(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
deviceId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
device_id = 'deviceId'
collect['device_id'] = device_id
result = sm_controller.get_network_sm_cellular_usage_history(collect)
get_network_sm_certs
List the certs on a device
def get_network_sm_certs(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
deviceId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
device_id = 'deviceId'
collect['device_id'] = device_id
result = sm_controller.get_network_sm_certs(collect)
get_network_sm_device_profiles
Get the profiles associated with a device
def get_network_sm_device_profiles(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
deviceId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
device_id = 'deviceId'
collect['device_id'] = device_id
result = sm_controller.get_network_sm_device_profiles(collect)
get_network_sm_network_adapters
List the network adapters of a device
def get_network_sm_network_adapters(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
deviceId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
device_id = 'deviceId'
collect['device_id'] = device_id
result = sm_controller.get_network_sm_network_adapters(collect)
get_network_sm_restrictions
List the restrictions on a device
def get_network_sm_restrictions(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
deviceId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
device_id = 'deviceId'
collect['device_id'] = device_id
result = sm_controller.get_network_sm_restrictions(collect)
get_network_sm_security_centers
List the security centers on a device
def get_network_sm_security_centers(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
deviceId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
device_id = 'deviceId'
collect['device_id'] = device_id
result = sm_controller.get_network_sm_security_centers(collect)
get_network_sm_softwares
Get a list of softwares associated with a device
def get_network_sm_softwares(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
deviceId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
device_id = 'deviceId'
collect['device_id'] = device_id
result = sm_controller.get_network_sm_softwares(collect)
get_network_sm_wlan_lists
List the saved SSID names on a device
def get_network_sm_wlan_lists(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
deviceId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
device_id = 'deviceId'
collect['device_id'] = device_id
result = sm_controller.get_network_sm_wlan_lists(collect)
lock_network_sm_devices
Lock a set of devices
def lock_network_sm_devices(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
lockNetworkSmDevices | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'network_id'
collect['network_id'] = network_id
lock_network_sm_devices = LockNetworkSmDevicesModel()
collect['lock_network_sm_devices'] = lock_network_sm_devices
result = sm_controller.lock_network_sm_devices(collect)
get_network_sm_connectivity
Returns historical connectivity data (whether a device is regularly checking in to Dashboard).
def get_network_sm_connectivity(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
perPage | Optional |
The number of entries per page returned |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, next or prev page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, next or prev page in the HTTP Link header should define it. |
Example Usage
collect = {}
network_id = 'network_id'
collect['network_id'] = network_id
id = 'id'
collect['id'] = id
per_page = 'perPage'
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = sm_controller.get_network_sm_connectivity(collect)
get_network_sm_desktop_logs
Return historical records of various Systems Manager network connection details for desktop devices.
def get_network_sm_desktop_logs(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
perPage | Optional |
The number of entries per page returned |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, next or prev page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, next or prev page in the HTTP Link header should define it. |
Example Usage
collect = {}
network_id = 'network_id'
collect['network_id'] = network_id
id = 'id'
collect['id'] = id
per_page = 'perPage'
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = sm_controller.get_network_sm_desktop_logs(collect)
get_network_sm_device_command_logs
Return historical records of commands sent to Systems Manager devices. <p>Note that this will include the name of the Dashboard user who initiated the command if it was generated by a Dashboard admin rather than the automatic behavior of the system; you may wish to filter this out of any reports.</p>
def get_network_sm_device_command_logs(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
perPage | Optional |
The number of entries per page returned |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, next or prev page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, next or prev page in the HTTP Link header should define it. |
Example Usage
collect = {}
network_id = 'network_id'
collect['network_id'] = network_id
id = 'id'
collect['id'] = id
per_page = 'perPage'
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = sm_controller.get_network_sm_device_command_logs(collect)
get_network_sm_performance_history
Return historical records of various Systems Manager client metrics for desktop devices.
def get_network_sm_performance_history(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
id | Required |
TODO: Add a parameter description |
perPage | Optional |
The number of entries per page returned |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, next or prev page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, next or prev page in the HTTP Link header should define it. |
Example Usage
collect = {}
network_id = 'network_id'
collect['network_id'] = network_id
id = 'id'
collect['id'] = id
per_page = 'perPage'
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = sm_controller.get_network_sm_performance_history(collect)
SNMPSettingsController
Get controller instance
An instance of the SNMPSettingsController
class can be accessed from the API Client.
snmp_settings_controller = client.snmp_settings
get_network_snmp_settings
Return the SNMP settings for a network
def get_network_snmp_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = snmp_settings_controller.get_network_snmp_settings(network_id)
update_network_snmp_settings
Update the SNMP settings for a network
def update_network_snmp_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSnmpSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_snmp_settings = UpdateNetworkSnmpSettingsModel()
collect['update_network_snmp_settings'] = update_network_snmp_settings
result = snmp_settings_controller.update_network_snmp_settings(collect)
get_organization_snmp
Return the SNMP settings for an organization
def get_organization_snmp(self,
organization_id)
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
Example Usage
organization_id = 'organizationId'
result = snmp_settings_controller.get_organization_snmp(organization_id)
update_organization_snmp
Update the SNMP settings for an organization
def update_organization_snmp(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
updateOrganizationSnmp | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
update_organization_snmp = UpdateOrganizationSnmpModel()
collect['update_organization_snmp'] = update_organization_snmp
result = snmp_settings_controller.update_organization_snmp(collect)
SsidsController
Get controller instance
An instance of the SsidsController
class can be accessed from the API Client.
ssids_controller = client.ssids
get_network_device_wireless_status
Return the SSID statuses of an access point
def get_network_device_wireless_status(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
result = ssids_controller.get_network_device_wireless_status(collect)
get_network_ssids
List the SSIDs in a network. Supports networks with access points or wireless-enabled security appliances and teleworker gateways.
def get_network_ssids(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = ssids_controller.get_network_ssids(network_id)
get_network_ssid
Return a single SSID
def get_network_ssid(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
number | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
number = 'number'
collect['number'] = number
result = ssids_controller.get_network_ssid(collect)
update_network_ssid
Update the attributes of an SSID
def update_network_ssid(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
number | Required |
TODO: Add a parameter description |
updateNetworkSsid | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
number = 'number'
collect['number'] = number
update_network_ssid = UpdateNetworkSsidModel()
collect['update_network_ssid'] = update_network_ssid
result = ssids_controller.update_network_ssid(collect)
SecurityEventsController
Get controller instance
An instance of the SecurityEventsController
class can be accessed from the API Client.
security_events_controller = client.security_events
get_network_client_security_events
List the security events for a client. Clients can be identified by a client key or either the MAC or IP depending on whether the network uses Track-by-IP.
def get_network_client_security_events(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 791 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 791 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 791 days. The default is 31 days. |
perPage | Optional |
The number of entries per page returned. Acceptable range is 3 - 1000. Default is 100. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 12.3401524067578
collect['timespan'] = timespan
per_page = 12
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = security_events_controller.get_network_client_security_events(collect)
get_network_security_events
List the security events for a network
def get_network_security_events(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 365 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 365 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 365 days. The default is 31 days. |
perPage | Optional |
The number of entries per page returned. Acceptable range is 3 - 1000. Default is 100. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 12.3401524067578
collect['timespan'] = timespan
per_page = 12
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = security_events_controller.get_network_security_events(collect)
get_organization_security_events
List the security events for an organization
def get_organization_security_events(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 365 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 365 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 365 days. The default is 31 days. |
perPage | Optional |
The number of entries per page returned. Acceptable range is 3 - 1000. Default is 100. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 12.3401524067578
collect['timespan'] = timespan
per_page = 12
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
result = security_events_controller.get_organization_security_events(collect)
SplashLoginAttemptsController
Get controller instance
An instance of the SplashLoginAttemptsController
class can be accessed from the API Client.
splash_login_attempts_controller = client.splash_login_attempts
get_network_splash_login_attempts
List the splash login attempts for a network
def get_network_splash_login_attempts(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
ssidNumber | Optional |
Only return the login attempts for the specified SSID |
loginIdentifier | Optional |
The username, email, or phone number used during login |
timespan | Optional |
The timespan, in seconds, for the login attempts. The period will be from [timespan] seconds ago until now. The maximum timespan is 3 months |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
ssid_number = SsidNumberEnum.ENUM_0
collect['ssid_number'] = ssid_number
login_identifier = 'loginIdentifier'
collect['login_identifier'] = login_identifier
timespan = 12
collect['timespan'] = timespan
result = splash_login_attempts_controller.get_network_splash_login_attempts(collect)
SplashSettingsController
Get controller instance
An instance of the SplashSettingsController
class can be accessed from the API Client.
splash_settings_controller = client.splash_settings
get_network_ssids_plash_settings
Display the splash page settings for the given SSID
def get_network_ssids_plash_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
number | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
number = 'number'
collect['number'] = number
result = splash_settings_controller.get_network_ssids_plash_settings(collect)
update_network_ssids_plash_settings
Modify the splash page settings for the given SSID
def update_network_ssids_plash_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
number | Required |
TODO: Add a parameter description |
updateNetwork_ssids_PlashSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
number = 'number'
collect['number'] = number
update_network_ssids_plash_settings = UpdateNetworkSsidsPlashSettingsModel()
collect['update_network_ssids_plash_settings'] = update_network_ssids_plash_settings
result = splash_settings_controller.update_network_ssids_plash_settings(collect)
SwitchPortSchedulesController
Get controller instance
An instance of the SwitchPortSchedulesController
class can be accessed from the API Client.
switch_port_schedules_controller = client.switch_port_schedules
get_network_switch_port_schedules
List switch port schedules
def get_network_switch_port_schedules(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = switch_port_schedules_controller.get_network_switch_port_schedules(network_id)
create_network_switch_port_schedule
Add a switch port schedule
def create_network_switch_port_schedule(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkSwitchPortSchedule | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_switch_port_schedule = CreateNetworkSwitchPortScheduleModel()
collect['create_network_switch_port_schedule'] = create_network_switch_port_schedule
result = switch_port_schedules_controller.create_network_switch_port_schedule(collect)
delete_network_switch_port_schedule
Delete a switch port schedule
def delete_network_switch_port_schedule(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
portScheduleId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
port_schedule_id = 'portScheduleId'
collect['port_schedule_id'] = port_schedule_id
switch_port_schedules_controller.delete_network_switch_port_schedule(collect)
update_network_switch_port_schedule
Update a switch port schedule
def update_network_switch_port_schedule(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
portScheduleId | Required |
TODO: Add a parameter description |
updateNetworkSwitchPortSchedule | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
port_schedule_id = 'portScheduleId'
collect['port_schedule_id'] = port_schedule_id
update_network_switch_port_schedule = UpdateNetworkSwitchPortScheduleModel()
collect['update_network_switch_port_schedule'] = update_network_switch_port_schedule
result = switch_port_schedules_controller.update_network_switch_port_schedule(collect)
SwitchPortsController
Get controller instance
An instance of the SwitchPortsController
class can be accessed from the API Client.
switch_ports_controller = client.switch_ports
get_device_switch_ports
List the switch ports for a switch
def get_device_switch_ports(self,
serial)
Parameters
Parameter | Tags | Description |
---|---|---|
serial | Required |
TODO: Add a parameter description |
Example Usage
serial = 'serial'
result = switch_ports_controller.get_device_switch_ports(serial)
get_device_switch_port
Return a switch port
def get_device_switch_port(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
serial | Required |
TODO: Add a parameter description |
number | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
serial = 'serial'
collect['serial'] = serial
number = 'number'
collect['number'] = number
result = switch_ports_controller.get_device_switch_port(collect)
update_device_switch_port
Update a switch port
def update_device_switch_port(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
serial | Required |
TODO: Add a parameter description |
number | Required |
TODO: Add a parameter description |
updateDeviceSwitchPort | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
serial = 'serial'
collect['serial'] = serial
number = 'number'
collect['number'] = number
update_device_switch_port = UpdateDeviceSwitchPortModel()
collect['update_device_switch_port'] = update_device_switch_port
result = switch_ports_controller.update_device_switch_port(collect)
SwitchProfilesController
Get controller instance
An instance of the SwitchProfilesController
class can be accessed from the API Client.
switch_profiles_controller = client.switch_profiles
get_organization_config_template_switch_profiles
List the switch profiles for your switch template configuration
def get_organization_config_template_switch_profiles(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
configTemplateId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
config_template_id = 'configTemplateId'
collect['config_template_id'] = config_template_id
result = switch_profiles_controller.get_organization_config_template_switch_profiles(collect)
SwitchSettingsController
Get controller instance
An instance of the SwitchSettingsController
class can be accessed from the API Client.
switch_settings_controller = client.switch_settings
get_network_switch_settings
Returns the switch network settings
def get_network_switch_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = switch_settings_controller.get_network_switch_settings(network_id)
update_network_switch_settings
Update switch network settings
def update_network_switch_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSwitchSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_switch_settings = UpdateNetworkSwitchSettingsModel()
collect['update_network_switch_settings'] = update_network_switch_settings
result = switch_settings_controller.update_network_switch_settings(collect)
get_network_switch_settings_mtu
Return the MTU configuration
def get_network_switch_settings_mtu(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = switch_settings_controller.get_network_switch_settings_mtu(network_id)
update_network_switch_settings_mtu
Update the MTU configuration
def update_network_switch_settings_mtu(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSwitchSettingsMtu | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_switch_settings_mtu = UpdateNetworkSwitchSettingsMtuModel()
collect['update_network_switch_settings_mtu'] = update_network_switch_settings_mtu
result = switch_settings_controller.update_network_switch_settings_mtu(collect)
get_network_switch_settings_qos_rules
List quality of service rules
def get_network_switch_settings_qos_rules(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = switch_settings_controller.get_network_switch_settings_qos_rules(network_id)
create_network_switch_settings_qos_rule
Add a quality of service rule
def create_network_switch_settings_qos_rule(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkSwitchSettingsQosRule | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_switch_settings_qos_rule = CreateNetworkSwitchSettingsQosRuleModel()
collect['create_network_switch_settings_qos_rule'] = create_network_switch_settings_qos_rule
result = switch_settings_controller.create_network_switch_settings_qos_rule(collect)
get_network_switch_settings_qos_rules_order
Return the quality of service rule IDs by order in which they will be processed by the switch
def get_network_switch_settings_qos_rules_order(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = switch_settings_controller.get_network_switch_settings_qos_rules_order(network_id)
update_network_switch_settings_qos_rules_order
Update the order in which the rules should be processed by the switch
def update_network_switch_settings_qos_rules_order(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSwitchSettingsQosRulesOrder | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_switch_settings_qos_rules_order = UpdateNetworkSwitchSettingsQosRulesOrderModel()
collect['update_network_switch_settings_qos_rules_order'] = update_network_switch_settings_qos_rules_order
result = switch_settings_controller.update_network_switch_settings_qos_rules_order(collect)
get_network_switch_settings_qos_rule
Return a quality of service rule
def get_network_switch_settings_qos_rule(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
qosRuleId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
qos_rule_id = 'qosRuleId'
collect['qos_rule_id'] = qos_rule_id
result = switch_settings_controller.get_network_switch_settings_qos_rule(collect)
delete_network_switch_settings_qos_rule
Delete a quality of service rule
def delete_network_switch_settings_qos_rule(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
qosRuleId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
qos_rule_id = 'qosRuleId'
collect['qos_rule_id'] = qos_rule_id
switch_settings_controller.delete_network_switch_settings_qos_rule(collect)
update_network_switch_settings_qos_rule
Update a quality of service rule
def update_network_switch_settings_qos_rule(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
qosRuleId | Required |
TODO: Add a parameter description |
updateNetworkSwitchSettingsQosRule | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
qos_rule_id = 'qosRuleId'
collect['qos_rule_id'] = qos_rule_id
update_network_switch_settings_qos_rule = UpdateNetworkSwitchSettingsQosRuleModel()
collect['update_network_switch_settings_qos_rule'] = update_network_switch_settings_qos_rule
result = switch_settings_controller.update_network_switch_settings_qos_rule(collect)
get_network_switch_settings_storm_control
Return the global enhanced storm control configuration
def get_network_switch_settings_storm_control(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = switch_settings_controller.get_network_switch_settings_storm_control(network_id)
update_network_switch_settings_storm_control
Update the global enhanced storm control configuration
def update_network_switch_settings_storm_control(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSwitchSettingsStormControl | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_switch_settings_storm_control = UpdateNetworkSwitchSettingsStormControlModel()
collect['update_network_switch_settings_storm_control'] = update_network_switch_settings_storm_control
result = switch_settings_controller.update_network_switch_settings_storm_control(collect)
get_network_switch_settings_stp
Returns STP settings
def get_network_switch_settings_stp(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = switch_settings_controller.get_network_switch_settings_stp(network_id)
update_network_switch_settings_stp
Updates STP settings
def update_network_switch_settings_stp(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSwitchSettingsStp | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_switch_settings_stp = UpdateNetworkSwitchSettingsStpModel()
collect['update_network_switch_settings_stp'] = update_network_switch_settings_stp
result = switch_settings_controller.update_network_switch_settings_stp(collect)
SwitchStacksController
Get controller instance
An instance of the SwitchStacksController
class can be accessed from the API Client.
switch_stacks_controller = client.switch_stacks
get_network_switch_stacks
List the switch stacks in a network
def get_network_switch_stacks(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = switch_stacks_controller.get_network_switch_stacks(network_id)
create_network_switch_stack
Create a stack
def create_network_switch_stack(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkSwitchStack | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_switch_stack = CreateNetworkSwitchStackModel()
collect['create_network_switch_stack'] = create_network_switch_stack
result = switch_stacks_controller.create_network_switch_stack(collect)
get_network_switch_stack
Show a switch stack
def get_network_switch_stack(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
switchStackId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
switch_stack_id = 'switchStackId'
collect['switch_stack_id'] = switch_stack_id
result = switch_stacks_controller.get_network_switch_stack(collect)
delete_network_switch_stack
Delete a stack
def delete_network_switch_stack(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
switchStackId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
switch_stack_id = 'switchStackId'
collect['switch_stack_id'] = switch_stack_id
switch_stacks_controller.delete_network_switch_stack(collect)
add_network_switch_stack
Add a switch to a stack
def add_network_switch_stack(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
switchStackId | Required |
TODO: Add a parameter description |
addNetworkSwitchStack | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
switch_stack_id = 'switchStackId'
collect['switch_stack_id'] = switch_stack_id
add_network_switch_stack = AddNetworkSwitchStackModel()
collect['add_network_switch_stack'] = add_network_switch_stack
result = switch_stacks_controller.add_network_switch_stack(collect)
remove_network_switch_stack
Remove a switch from a stack
def remove_network_switch_stack(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
switchStackId | Required |
TODO: Add a parameter description |
removeNetworkSwitchStack | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
switch_stack_id = 'switchStackId'
collect['switch_stack_id'] = switch_stack_id
remove_network_switch_stack = RemoveNetworkSwitchStackModel()
collect['remove_network_switch_stack'] = remove_network_switch_stack
result = switch_stacks_controller.remove_network_switch_stack(collect)
SyslogServersController
Get controller instance
An instance of the SyslogServersController
class can be accessed from the API Client.
syslog_servers_controller = client.syslog_servers
get_network_syslog_servers
List the syslog servers for a network
def get_network_syslog_servers(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = syslog_servers_controller.get_network_syslog_servers(network_id)
update_network_syslog_servers
Update the syslog servers for a network
def update_network_syslog_servers(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkSyslogServers | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_syslog_servers = UpdateNetworkSyslogServersModel()
collect['update_network_syslog_servers'] = update_network_syslog_servers
result = syslog_servers_controller.update_network_syslog_servers(collect)
TrafficAnalysisSettingsController
Get controller instance
An instance of the TrafficAnalysisSettingsController
class can be accessed from the API Client.
traffic_analysis_settings_controller = client.traffic_analysis_settings
get_network_traffic_analysis_settings
Return the traffic analysis settings for a network
def get_network_traffic_analysis_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = traffic_analysis_settings_controller.get_network_traffic_analysis_settings(network_id)
update_network_traffic_analysis_settings
Update the traffic analysis settings for a network
def update_network_traffic_analysis_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkTrafficAnalysisSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_traffic_analysis_settings = UpdateNetworkTrafficAnalysisSettingsModel()
collect['update_network_traffic_analysis_settings'] = update_network_traffic_analysis_settings
result = traffic_analysis_settings_controller.update_network_traffic_analysis_settings(collect)
TrafficShapingController
Get controller instance
An instance of the TrafficShapingController
class can be accessed from the API Client.
traffic_shaping_controller = client.traffic_shaping
update_network_ssid_traffic_shaping
Update the traffic shaping settings for an SSID on an MR network
def update_network_ssid_traffic_shaping(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
number | Required |
TODO: Add a parameter description |
updateNetworkSsidTrafficShaping | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
number = 'number'
collect['number'] = number
update_network_ssid_traffic_shaping = UpdateNetworkSsidTrafficShapingModel()
collect['update_network_ssid_traffic_shaping'] = update_network_ssid_traffic_shaping
result = traffic_shaping_controller.update_network_ssid_traffic_shaping(collect)
get_network_ssid_traffic_shaping
Display the traffic shaping settings for a SSID on an MR network
def get_network_ssid_traffic_shaping(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
number | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
number = 'number'
collect['number'] = number
result = traffic_shaping_controller.get_network_ssid_traffic_shaping(collect)
update_network_traffic_shaping
Update the traffic shaping settings for an MX network
def update_network_traffic_shaping(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkTrafficShaping | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_traffic_shaping = UpdateNetworkTrafficShapingModel()
collect['update_network_traffic_shaping'] = update_network_traffic_shaping
result = traffic_shaping_controller.update_network_traffic_shaping(collect)
get_network_traffic_shaping
Display the traffic shaping settings for an MX network
def get_network_traffic_shaping(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = traffic_shaping_controller.get_network_traffic_shaping(network_id)
get_network_traffic_shaping_application_categories
Returns the application categories for traffic shaping rules.
def get_network_traffic_shaping_application_categories(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = traffic_shaping_controller.get_network_traffic_shaping_application_categories(network_id)
get_network_traffic_shaping_dscp_tagging_options
Returns the available DSCP tagging options for your traffic shaping rules.
def get_network_traffic_shaping_dscp_tagging_options(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = traffic_shaping_controller.get_network_traffic_shaping_dscp_tagging_options(network_id)
UplinkSettingsController
Get controller instance
An instance of the UplinkSettingsController
class can be accessed from the API Client.
uplink_settings_controller = client.uplink_settings
get_network_uplink_settings
Returns the uplink settings for your MX network.
def get_network_uplink_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = uplink_settings_controller.get_network_uplink_settings(network_id)
update_network_uplink_settings
Updates the uplink settings for your MX network.
def update_network_uplink_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkUplinkSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_uplink_settings = UpdateNetworkUplinkSettingsModel()
collect['update_network_uplink_settings'] = update_network_uplink_settings
result = uplink_settings_controller.update_network_uplink_settings(collect)
VlansController
Get controller instance
An instance of the VlansController
class can be accessed from the API Client.
vlans_controller = client.vlans
get_network_vlans
List the VLANs for an MX network
def get_network_vlans(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = vlans_controller.get_network_vlans(network_id)
create_network_vlan
Add a VLAN
def create_network_vlan(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
createNetworkVlan | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
create_network_vlan = CreateNetworkVlanModel()
collect['create_network_vlan'] = create_network_vlan
result = vlans_controller.create_network_vlan(collect)
get_network_vlan
Return a VLAN
def get_network_vlan(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
vlanId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
vlan_id = 'vlanId'
collect['vlan_id'] = vlan_id
result = vlans_controller.get_network_vlan(collect)
update_network_vlan
Update a VLAN
def update_network_vlan(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
vlanId | Required |
TODO: Add a parameter description |
updateNetworkVlan | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
vlan_id = 'vlanId'
collect['vlan_id'] = vlan_id
update_network_vlan = UpdateNetworkVlanModel()
collect['update_network_vlan'] = update_network_vlan
result = vlans_controller.update_network_vlan(collect)
delete_network_vlan
Delete a VLAN from a network
def delete_network_vlan(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
vlanId | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
vlan_id = 'vlanId'
collect['vlan_id'] = vlan_id
vlans_controller.delete_network_vlan(collect)
get_network_vlans_enabled_state
Returns the enabled status of VLANs for the network
def get_network_vlans_enabled_state(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = vlans_controller.get_network_vlans_enabled_state(network_id)
update_network_vlans_enabled_state
Enable/Disable VLANs for the given network
def update_network_vlans_enabled_state(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetwork_vlans_EnabledState | Required |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_vlans_enabled_state = UpdateNetworkVlansEnabledStateModel()
collect['update_network_vlans_enabled_state'] = update_network_vlans_enabled_state
result = vlans_controller.update_network_vlans_enabled_state(collect)
WebhookLogsController
Get controller instance
An instance of the WebhookLogsController
class can be accessed from the API Client.
webhook_logs_controller = client.webhook_logs
get_organization_webhook_logs
Return the log of webhook POSTs sent
def get_organization_webhook_logs(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
organizationId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 90 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 31 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 31 days. The default is 1 day. |
perPage | Optional |
The number of entries per page returned. Acceptable range is 3 - 1000. Default is 50. |
startingAfter | Optional |
A token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
endingBefore | Optional |
A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it. |
url | Optional |
The URL the webhook was sent to |
Example Usage
collect = {}
organization_id = 'organizationId'
collect['organization_id'] = organization_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
per_page = 175
collect['per_page'] = per_page
starting_after = 'startingAfter'
collect['starting_after'] = starting_after
ending_before = 'endingBefore'
collect['ending_before'] = ending_before
url = 'url'
collect['url'] = url
result = webhook_logs_controller.get_organization_webhook_logs(collect)
WirelessHealthController
Get controller instance
An instance of the WirelessHealthController
class can be accessed from the API Client.
wireless_health_controller = client.wireless_health
get_network_clients_connection_stats
Aggregated connectivity info for this network, grouped by clients
def get_network_clients_connection_stats(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
ssid = 175
collect['ssid'] = ssid
vlan = 175
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
result = wireless_health_controller.get_network_clients_connection_stats(collect)
get_network_clients_latency_stats
Aggregated latency info for this network, grouped by clients
def get_network_clients_latency_stats(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
fields | Optional |
Partial selection: If present, this call will return only the selected fields of ["rawDistribution", "avg"]. All fields will be returned by default. Selected fields must be entered as a comma separated string. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
ssid = 175
collect['ssid'] = ssid
vlan = 175
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
fields = 'fields'
collect['fields'] = fields
result = wireless_health_controller.get_network_clients_latency_stats(collect)
get_network_client_connection_stats
Aggregated connectivity info for a given client on this network. Clients are identified by their MAC.
def get_network_client_connection_stats(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
ssid = 175
collect['ssid'] = ssid
vlan = 175
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
result = wireless_health_controller.get_network_client_connection_stats(collect)
get_network_client_latency_stats
Aggregated latency info for a given client on this network. Clients are identified by their MAC.
def get_network_client_latency_stats(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
clientId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
fields | Optional |
Partial selection: If present, this call will return only the selected fields of ["rawDistribution", "avg"]. All fields will be returned by default. Selected fields must be entered as a comma separated string. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
client_id = 'clientId'
collect['client_id'] = client_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
ssid = 175
collect['ssid'] = ssid
vlan = 175
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
fields = 'fields'
collect['fields'] = fields
result = wireless_health_controller.get_network_client_latency_stats(collect)
get_network_connection_stats
Aggregated connectivity info for this network
def get_network_connection_stats(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
ssid = 175
collect['ssid'] = ssid
vlan = 175
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
result = wireless_health_controller.get_network_connection_stats(collect)
get_network_devices_connection_stats
Aggregated connectivity info for this network, grouped by node
def get_network_devices_connection_stats(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
ssid = 175
collect['ssid'] = ssid
vlan = 175
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
result = wireless_health_controller.get_network_devices_connection_stats(collect)
get_network_devices_latency_stats
Aggregated latency info for this network, grouped by node
def get_network_devices_latency_stats(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
fields | Optional |
Partial selection: If present, this call will return only the selected fields of ["rawDistribution", "avg"]. All fields will be returned by default. Selected fields must be entered as a comma separated string. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
ssid = 175
collect['ssid'] = ssid
vlan = 175
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
fields = 'fields'
collect['fields'] = fields
result = wireless_health_controller.get_network_devices_latency_stats(collect)
get_network_device_connection_stats
Aggregated connectivity info for a given AP on this network
def get_network_device_connection_stats(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
ssid = 175
collect['ssid'] = ssid
vlan = 175
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
result = wireless_health_controller.get_network_device_connection_stats(collect)
get_network_device_latency_stats
Aggregated latency info for a given AP on this network
def get_network_device_latency_stats(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
serial | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
fields | Optional |
Partial selection: If present, this call will return only the selected fields of ["rawDistribution", "avg"]. All fields will be returned by default. Selected fields must be entered as a comma separated string. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
serial = 'serial'
collect['serial'] = serial
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
ssid = 175
collect['ssid'] = ssid
vlan = 175
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
fields = 'fields'
collect['fields'] = fields
result = wireless_health_controller.get_network_device_latency_stats(collect)
get_network_failed_connections
List of all failed client connection events on this network in a given time range
def get_network_failed_connections(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
serial | Optional |
Filter by AP |
clientId | Optional |
Filter by client MAC |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 175.844870515095
collect['timespan'] = timespan
ssid = 175
collect['ssid'] = ssid
vlan = 175
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
serial = 'serial'
collect['serial'] = serial
client_id = 'clientId'
collect['client_id'] = client_id
result = wireless_health_controller.get_network_failed_connections(collect)
get_network_latency_stats
Aggregated latency info for this network
def get_network_latency_stats(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
t0 | Optional |
The beginning of the timespan for the data. The maximum lookback period is 180 days from today. |
t1 | Optional |
The end of the timespan for the data. t1 can be a maximum of 7 days after t0. |
timespan | Optional |
The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. |
ssid | Optional |
Filter results by SSID |
vlan | Optional |
Filter results by VLAN |
apTag | Optional |
Filter results by AP Tag |
fields | Optional |
Partial selection: If present, this call will return only the selected fields of ["rawDistribution", "avg"]. All fields will be returned by default. Selected fields must be entered as a comma separated string. |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
t_0 = 't0'
collect['t_0'] = t_0
t_1 = 't1'
collect['t_1'] = t_1
timespan = 217.568043741662
collect['timespan'] = timespan
ssid = 217
collect['ssid'] = ssid
vlan = 217
collect['vlan'] = vlan
ap_tag = 'apTag'
collect['ap_tag'] = ap_tag
fields = 'fields'
collect['fields'] = fields
result = wireless_health_controller.get_network_latency_stats(collect)
WirelessSettingsController
Get controller instance
An instance of the WirelessSettingsController
class can be accessed from the API Client.
wireless_settings_controller = client.wireless_settings
get_network_wireless_settings
Return the wireless settings for a network
def get_network_wireless_settings(self,
network_id)
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
Example Usage
network_id = 'networkId'
result = wireless_settings_controller.get_network_wireless_settings(network_id)
update_network_wireless_settings
Update the wireless settings for a network
def update_network_wireless_settings(self,
options=dict())
Parameters
Parameter | Tags | Description |
---|---|---|
networkId | Required |
TODO: Add a parameter description |
updateNetworkWirelessSettings | Optional |
TODO: Add a parameter description |
Example Usage
collect = {}
network_id = 'networkId'
collect['network_id'] = network_id
update_network_wireless_settings = UpdateNetworkWirelessSettingsModel()
collect['update_network_wireless_settings'] = update_network_wireless_settings
result = wireless_settings_controller.update_network_wireless_settings(collect)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for meraki_sdk-1.5.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e74fb5e0bccc496b382f8aa8767b4a49204c786d52b856cca211a5ab7f3a3363 |
|
MD5 | 2727af6756ba47d7847b267c6c3f536a |
|
BLAKE2b-256 | 79de061a574b5bcfcc84102dd62f6765070c9c99fcda7eb1423776b4fa5fe29d |