import urllib class ActionBatchSensor(object): def __init__(self): super(ActionBatchSensor, self).__init__() def createDeviceSensorCommand(self, serial: str, operation: str): """ **Sends a command to a sensor** https://developer.cisco.com/meraki/api-v1/#!create-device-sensor-command - serial (string): Serial - operation (string): Operation to run on the sensor. 'enableDownstreamPower', 'disableDownstreamPower', and 'cycleDownstreamPower' turn power on/off to the device that is connected downstream of an MT40 power monitor. 'refreshData' causes an MT15 or MT40 device to upload its latest readings so that they are immediately available in the Dashboard API. """ kwargs = locals() if 'operation' in kwargs: options = ['cycleDownstreamPower', 'disableDownstreamPower', 'enableDownstreamPower', 'refreshData'] assert kwargs['operation'] in options, f'''"operation" cannot be "{kwargs['operation']}", & must be set to one of: {options}''' metadata = { 'tags': ['sensor', 'configure', 'commands'], 'operation': 'createDeviceSensorCommand' } resource = f'/devices/{serial}/sensor/commands' body_params = ['operation', ] payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params} action = { "resource": resource, "operation": "create", "body": payload } return action def updateDeviceSensorRelationships(self, serial: str, **kwargs): """ **Assign one or more sensor roles to a given sensor or camera device.** https://developer.cisco.com/meraki/api-v1/#!update-device-sensor-relationships - serial (string): Serial - livestream (object): A role defined between an MT sensor and an MV camera that adds the camera's livestream to the sensor's details page. Snapshots from the camera will also appear in alert notifications that the sensor triggers. """ kwargs.update(locals()) metadata = { 'tags': ['sensor', 'configure', 'relationships'], 'operation': 'updateDeviceSensorRelationships' } resource = f'/devices/{serial}/sensor/relationships' body_params = ['livestream', ] payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params} action = { "resource": resource, "operation": "update", "body": payload } return action def createNetworkSensorAlertsProfile(self, networkId: str, name: str, conditions: list, **kwargs): """ **Creates a sensor alert profile for a network.** https://developer.cisco.com/meraki/api-v1/#!create-network-sensor-alerts-profile - networkId (string): Network ID - name (string): Name of the sensor alert profile. - conditions (array): List of conditions that will cause the profile to send an alert. - schedule (object): The sensor schedule to use with the alert profile. - recipients (object): List of recipients that will receive the alert. - serials (array): List of device serials assigned to this sensor alert profile. - includeSensorUrl (boolean): Include dashboard link to sensor in messages (default: true). - message (string): A custom message that will appear in email and text message alerts. """ kwargs.update(locals()) metadata = { 'tags': ['sensor', 'configure', 'alerts', 'profiles'], 'operation': 'createNetworkSensorAlertsProfile' } resource = f'/networks/{networkId}/sensor/alerts/profiles' body_params = ['name', 'schedule', 'conditions', 'recipients', 'serials', 'includeSensorUrl', 'message', ] payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params} action = { "resource": resource, "operation": "create", "body": payload } return action def updateNetworkSensorAlertsProfile(self, networkId: str, id: str, **kwargs): """ **Updates a sensor alert profile for a network.** https://developer.cisco.com/meraki/api-v1/#!update-network-sensor-alerts-profile - networkId (string): Network ID - id (string): ID - name (string): Name of the sensor alert profile. - schedule (object): The sensor schedule to use with the alert profile. - conditions (array): List of conditions that will cause the profile to send an alert. - recipients (object): List of recipients that will receive the alert. - serials (array): List of device serials assigned to this sensor alert profile. - includeSensorUrl (boolean): Include dashboard link to sensor in messages (default: true). - message (string): A custom message that will appear in email and text message alerts. """ kwargs.update(locals()) metadata = { 'tags': ['sensor', 'configure', 'alerts', 'profiles'], 'operation': 'updateNetworkSensorAlertsProfile' } resource = f'/networks/{networkId}/sensor/alerts/profiles/{id}' body_params = ['name', 'schedule', 'conditions', 'recipients', 'serials', 'includeSensorUrl', 'message', ] payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params} action = { "resource": resource, "operation": "update", "body": payload } return action def deleteNetworkSensorAlertsProfile(self, networkId: str, id: str): """ **Deletes a sensor alert profile from a network.** https://developer.cisco.com/meraki/api-v1/#!delete-network-sensor-alerts-profile - networkId (string): Network ID - id (string): ID """ metadata = { 'tags': ['sensor', 'configure', 'alerts', 'profiles'], 'operation': 'deleteNetworkSensorAlertsProfile' } resource = f'/networks/{networkId}/sensor/alerts/profiles/{id}' action = { "resource": resource, "operation": "destroy", } return action def updateNetworkSensorMqttBroker(self, networkId: str, mqttBrokerId: str, enabled: bool): """ **Update the sensor settings of an MQTT broker. To update the broker itself, use /networks/{networkId}/mqttBrokers/{mqttBrokerId}.** https://developer.cisco.com/meraki/api-v1/#!update-network-sensor-mqtt-broker - networkId (string): Network ID - mqttBrokerId (string): Mqtt broker ID - enabled (boolean): Set to true to enable MQTT broker for sensor network """ kwargs = locals() metadata = { 'tags': ['sensor', 'configure', 'mqttBrokers'], 'operation': 'updateNetworkSensorMqttBroker' } resource = f'/networks/{networkId}/sensor/mqttBrokers/{mqttBrokerId}' body_params = ['enabled', ] payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params} action = { "resource": resource, "operation": "update", "body": payload } return action