Python SDK

Use the Python SDK to get started quickly with using the REST APIs. You can use the SDK for device types that were created in versions earlier than 8.8. The SDK cannot be used with device types that were created in version 8.8 or later.

Using the modules, you can interact with the REST APIs to:

Manage device types
Manage dimensions
Manage metrics
Manage constants
Load metric data

Modules

Description	Module	Input	Output	Script
Read metric data for an existing device type	load_metrics_data_from_csv	`entity_type_name`: Name of device type in string format `file_path`: Path to the file `credentials`: See Adding credentials	None	Loading data from csv script
Delete a device type	remove_entity_type	`entity_type_name`: Name of device type in string format `credentials`: See Adding credentials	API response	Removing device type, functions, constants, dimensions script
Add metric (KPI) functions to a device type	add_functions	`json_payload`: See sample payload `credentials`: See Adding credentials	None	Creating entities, adding functions, constants, dimensions script
Get all of the metric (KPI) functions of a device type	get_functions	`credentials`: See Adding credentials `entity_type_name`: Name of device type in string format	List of dict with metric (KPI) functions (API response)	Getting functions, constants, and dimensions script
Delete a metric (KPI) function of a device type	remove_function	`credentials`: See Adding credentials `entity_type_name`: Name of device type in string format `kpi_name` Name of metric (KPI) function in string format `credentials`:See Adding credentials	API response	Removing device type, functions, constants, dimensions script
Register a constant globally	create_constants	`json_payload`: See sample payload `credentials`: See Adding credentials	API response	None
Get all of constants for a tenant	get_constants	`entity_type_name` Name of device type in string format `credentials`: See Adding credentials	list of dict with constants information (API response)	Get functions, constants, and dimensions script
Update constants for a tenant	update_constants	`json_payload`See sample payload `credentials`: See Adding credentials	API response	None
Unregister constants by name	remove_constants	`constant_names`: List of constant names to delete `credentials`: See Adding credentials	API response	None
Add dimension data to entities	add_dimensions_data	`json_payload`: See sample payload `credentials`: See Adding credentials	API response	Creating entities, adding functions, constants, dimensions script
Get all the dimensional data for a device type	get_dimensions_data	`entity_type_name` Name of device type in string format `credentials`: See Adding credentials	List of dict with dimension data information (API response)	Getting functions, constants, and dimensions script
Update dimension data	update_dimensions_data	`json_payload`: See sample payload `credentials`: See Adding credentials	API response	None
Delete a dimension by name	remove_dimensions	`dimension_names`: List of dimension names to delete `entity_type_name`: Name of device type in string format `credentials`: See Adding credentials	API response	Removing device type, functions, constants, dimensions script
Get all alerts using a json payload	get_alerts	`json_payload`: See sample payload `credentials`: See Adding credentials	API response	Get alerts and update status and severity script
Update the alert status using the alert ID	update_alert_status	`alert_id`: Find the alert ID using the get_alerts method `new_status`: Available values are New, Acknowledged, Resolved, and Dismissed `credentials`: See Adding credentials	None	None
Update the alert severity using alert ID	update_alert_severity	`alert_id` Find the alert ID using the get_alerts method `new_status`: Available values are Low, Medium, and High `credentials`: See Adding credentials	None	None

Installing the SDK

Complete these steps to create a copy of the Python SDK and run it on your local system for development and testing purposes.

Create a virtual environment
```
python3 -m venv env
```
Activate virtual environment
```
source env/bin/activate
```

Install sdk from GitHub

pip install git+https://github.com/ibm-watson-iot/maximo-asset-monitor-sdk.git

On a MAS OS X environment, if the IBM database (ibm_db) fails, complete these steps:

Activate the virtual environment to set up the $VIRTUAL_ENV variable
```
source env/bin/activate
```

Run the following command to download the driver:

pip install git+https://github.com/ibm-watson-iot/maximo-asset-monitor-sdk.git

Run the following command once to fix the driver:
```
bash ./dev_resources/mac_ibmdb_fix.sh
```

For more information about the workaround, see https://github.com/ibmdb/python-ibmdb/issues/187#issuecomment-310765420