greenbyteapi 2.2.5

Python client library for Greenbyte API

Getting started

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 Greenbyteapi 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 greenbyteapi.greenbyteapi_client import GreenbyteapiClient

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:

1. From terminal/cmd navigate to the root directory of the SDK.
2. Invoke pip install -r test-requirements.txt
3. Invoke nosetests

Initialization

Authentication

In order to setup authentication and initialization of the API client, you need the following information.

Parameter	Description
x_api_key	TODO: add a description

API client can be initialized as following.

# Configuration parameters and credentials
x_api_key = 'x_api_key'

client = GreenbyteapiClient(x_api_key)

Class Reference

List of Controllers

• DataController
• StatusesController
• ConfigurationDataController
• AssetsController
• AlertsController
• PlanController
• PredictController

DataController

Get controller instance

An instance of the DataController class can be accessed from the API Client.

 data_controller = client.data

get_data_signals

Gets authorized data signals for one or more devices.

🔐 This endpoint requires the Data endpoint permission.

This request can also be made using the POST method, with a request to datasignals.json and a JSON request body instead of query parameters.

def get_data_signals(self,
                         device_ids)

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	What devices to get data signals for.

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)

result = data_controller.get_data_signals(device_ids)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_data

Gets data for multiple devices and data signals in the given resolution. The timestamps are in the time zone configured in the Greenbyte Platform. Use the useUtc flag to get timestamps in UTC for all resolutions other than daily, weekly, monthly and yearly.

🔐 This endpoint requires the Data endpoint permission.

This request can also be made using the POST method, with a request to data.json and a JSON request body instead of query parameters.

def get_data(self,
                 device_ids,
                 data_signal_ids,
                 timestamp_start,
                 timestamp_end,
                 use_utc=False,
                 resolution='10minute',
                 aggregate='device',
                 aggregate_level=0,
                 calculation=None)

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	Which devices to get data for.
dataSignalIds	Required Collection	Which data signals to get data for.
timestampStart	Required	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Required | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | useUtc | Optional DefaultValue | Set to true to get timestamps in UTC. UTC timestamps are available for all resolutions other than daily, weekly, monthly and yearly. | | resolution | Optional DefaultValue | The desired data resolution. | | aggregate | Optional DefaultValue | How the data should be aggregated with regards to device(s) or site(s). | | aggregateLevel | Optional DefaultValue | When AggregateMode siteLevel is used this parameter controls down to which level in the hierarchy to aggregate. | | calculation | Optional | The calculation used when aggregating data, both over time and across devices. The default is the data signal default. |

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
data_signal_ids_value = "[1,5]"
data_signal_ids = json.loads(data_signal_ids_value)
timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z
use_utc = False
resolution = ResolutionEnum.ENUM_10MINUTE
aggregate = AggregateModeEnum.DEVICE
aggregate_level = 0
calculation = CalculationModeEnum.SUM

result = data_controller.get_data(device_ids, data_signal_ids, timestamp_start, timestamp_end, use_utc, resolution, aggregate, aggregate_level, calculation)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_real_time_data

Gets the most recent data point for each specified device and data signal. The timestamps are in UTC.

🔐 This endpoint requires the Data endpoint permission.

This request can also be made using the POST method, with a request to realtimedata.json and a JSON request body instead of query parameters.

def get_real_time_data(self,
                           device_ids,
                           data_signal_ids,
                           aggregate='device',
                           aggregate_level=0,
                           calculation=None)

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	Which devices to get data for.
dataSignalIds	Required Collection	Which data signals to get data for.
aggregate	Optional DefaultValue	How the data should be aggregated with regards to device(s) or site(s).
aggregateLevel	Optional DefaultValue	When AggregateMode siteLevel is used this parameter controls down to which level in the hierarchy to aggregate.
calculation	Optional	The calculation used when aggregating data, both over time and across devices. The default is the data signal default.

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
data_signal_ids_value = "[1,5]"
data_signal_ids = json.loads(data_signal_ids_value)
aggregate = AggregateModeEnum.DEVICE
aggregate_level = 0
calculation = CalculationModeRealTimeEnum.SUM

result = data_controller.get_real_time_data(device_ids, data_signal_ids, aggregate, aggregate_level, calculation)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_data_per_category

Gets signal data aggregated per availability contract category.

🔐 This endpoint requires the Data and Statuses endpoint permissions.

This request can also be made using the POST method, with a request to datapercategory.json and a JSON request body instead of query parameters.

def get_data_per_category(self,
                              device_ids,
                              data_signal_id,
                              timestamp_start,
                              timestamp_end,
                              aggregate='device',
                              aggregate_level=0,
                              category=None,
                              contract_type='service')

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	Which devices to get data for.
dataSignalId	Required	Which signal to get data for; only Lost Production signals are supported at the moment.
timestampStart	Required	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Required | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | aggregate | Optional DefaultValue | How the data should be aggregated with regards to device(s) or site(s). | | aggregateLevel | Optional DefaultValue | When AggregateMode siteLevel is used this parameter controls down to which level in the hierarchy to aggregate. | | category | Optional Collection | Which status categories to include. By default all categories are included. | | contractType | Optional DefaultValue | Which contract type to use if using multiple availability contracts. |

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
data_signal_id = 248
timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z
aggregate = AggregateModeEnum.DEVICE
aggregate_level = 0
category = [StatusCategoryEnum.STOP]
contract_type = ContractTypeEnum.SERVICE

result = data_controller.get_data_per_category(device_ids, data_signal_id, timestamp_start, timestamp_end, aggregate, aggregate_level, category, contract_type)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_high_res_data

Gets high resolution data for a data signal for each specified device. The timestamps are in UTC.

The endpoint returns up to an hour's worth of high resolution data for the provided device IDs and data signal ID. It is possible to request data for up to 10 separate devices and one data signal ID. Timestamp start and end are optional. The default time span returned is the latest hour. If supplied, timestamp start must be within the past 12 hours. Timestamp end will by default be an hour after timestamp start but can be set for shorter intervals.

There is no high resolution data available for data signals that are calculated. The data for those signals can be retrieved through the data endpoint.

🔐 This endpoint requires the HighResolution endpoint permission.

def get_high_res_data(self,
                          device_ids,
                          data_signal_id,
                          timestamp_start=None,
                          timestamp_end=None)

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	Which devices to get data for.
dataSignalId	Required	Which data signal to get data for.
timestampStart	Optional	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Optional | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. |

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
data_signal_id = 1
timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z

result = data_controller.get_high_res_data(device_ids, data_signal_id, timestamp_start, timestamp_end)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

Back to List of Controllers

StatusesController

Get controller instance

An instance of the StatusesController class can be accessed from the API Client.

 statuses_controller = client.statuses

get_statuses

Gets statuses for multiple devices during the given time period. The timestamps are in the time zone configured in the Greenbyte Platform. Use the useUtc flag to get timestamps in UTC.

🔐 This endpoint requires the Statuses endpoint permission.

This request can also be made using the POST method, with a request to status.json and a JSON request body instead of query parameters.

def get_statuses(self,
                     device_ids,
                     timestamp_start,
                     timestamp_end,
                     category=None,
                     lost_production_signal_id=None,
                     fields=None,
                     sort_by=None,
                     sort_asc=False,
                     page_size=50,
                     page=1,
                     use_utc=False,
                     contract_type='service')

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	Which devices to get statuses for.
timestampStart	Required	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Required | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | category | Optional Collection | Which status categories to get statuses for. | | lostProductionSignalId | Optional | Which data signal to use for calculating lost production. Defaults to the configured default lost production signal. | | fields | Optional Collection | Which fields to include in the response. Valid fields are those defined in the StatusItem schema (See Response Type). By default all fields are included. | | sortBy | Optional Collection | Which fields to sort the response items by. | | sortAsc | Optional DefaultValue | Whether to sort the items in ascending order. | | pageSize | Optional DefaultValue | The number of items to return per page. | | page | Optional DefaultValue | Which page to return when the number of items exceed the page size. | | useUtc | Optional DefaultValue | Set to true to get timestamps in UTC. | | contractType | Optional DefaultValue | Which contract type to use if using multiple availability contracts. |

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z
category = [StatusCategoryEnum.STOP]
lost_production_signal_id = 432
fields_value = '["deviceId","message","lostProduction"]'
fields = json.loads(fields_value)
sort_by = ['sortBy']
sort_asc = False
page_size = 50
page = 1
use_utc = False
contract_type = ContractTypeEnum.SERVICE

result = statuses_controller.get_statuses(device_ids, timestamp_start, timestamp_end, category, lost_production_signal_id, fields, sort_by, sort_asc, page_size, page, use_utc, contract_type)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_active_statuses

Gets active statuses for multiple devices. The timestamps are in the time zone configured in the Greenbyte Platform. Use the useUtc flag to get timestamps in UTC.

🔐 This endpoint requires the Statuses endpoint permission.

This request can also be made using the POST method, with a request to activestatus.json and a JSON request body instead of query parameters.

def get_active_statuses(self,
                            device_ids,
                            category=None,
                            lost_production_signal_id=None,
                            fields=None,
                            sort_by=None,
                            sort_asc=False,
                            page_size=50,
                            page=1,
                            use_utc=False,
                            contract_type='service')

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	Which devices to get statuses for.
category	Optional Collection	Which status categories to get statuses for.
lostProductionSignalId	Optional	Which data signal to use for calculating lost production. Defaults to the configured default lost production signal.
fields	Optional Collection	Which fields to include in the response. Valid fields are those defined in the StatusItem schema (See Response Type). By default all fields are included.
sortBy	Optional Collection	Which fields to sort the response items by.
sortAsc	Optional DefaultValue	Whether to sort the items in ascending order.
pageSize	Optional DefaultValue	The number of items to return per page.
page	Optional DefaultValue	Which page to return when the number of items exceed the page size.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.
contractType	Optional DefaultValue	Which contract type to use if using multiple availability contracts.

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
category = [StatusCategoryEnum.STOP]
lost_production_signal_id = 432
fields_value = '["deviceId","message","lostProduction"]'
fields = json.loads(fields_value)
sort_by = ['sortBy']
sort_asc = False
page_size = 50
page = 1
use_utc = False
contract_type = ContractTypeEnum.SERVICE

result = statuses_controller.get_active_statuses(device_ids, category, lost_production_signal_id, fields, sort_by, sort_asc, page_size, page, use_utc, contract_type)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

Back to List of Controllers

ConfigurationDataController

Get controller instance

An instance of the ConfigurationDataController class can be accessed from the API Client.

 configuration_data_controller = client.configuration_data

get_configuration

Gets your system-wide configuration data.

🔐 This endpoint requires the Configuration endpoint permission.

This request can also be made using the POST method, with a request to configuration.json and a JSON request body instead of query parameters.

def get_configuration(self)

Example Usage

result = configuration_data_controller.get_configuration()

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

Back to List of Controllers

AssetsController

Get controller instance

An instance of the AssetsController class can be accessed from the API Client.

 assets_controller = client.assets

get_devices

Gets a list of devices that the API key has permissions for.

🔐 This endpoint requires the Assets endpoint permission.

This request can also be made using the POST method, with a request to devices.json and a JSON request body instead of query parameters.

def get_devices(self,
                    device_type_ids=None,
                    site_ids=None,
                    parent_ids=None,
                    fields=None,
                    page_size=50,
                    page=1,
                    use_utc=False)

Parameters

Parameter	Tags	Description
deviceTypeIds	Optional Collection	Only include devices of these types.
Examples:

• 1 - Wind turbine
• 2 - Production meter
• 3 - Met mast
• 4 - Inverter
• 10 - Device group
• 11 - Grid meter
• 12 - Combiner box
• 23 - String
• 27 - Virtual Meteo Sensor | | siteIds | Optional Collection | Only include devices at these sites. | | parentIds | Optional Collection | Only include devices with these parent devices. | | fields | Optional Collection | Which fields to include in the response. Valid fields are those defined in the Device schema (See Response Type). By default all fields are included. | | pageSize | Optional DefaultValue | The number of items to return per page. | | page | Optional DefaultValue | Which page to return when the number of items exceed the page size. | | useUtc | Optional DefaultValue | Set to true to get timestamps in UTC. |

Example Usage

device_type_ids_value = "[1,2,3]"
device_type_ids = json.loads(device_type_ids_value)
site_ids_value = "[1,2,3]"
site_ids = json.loads(site_ids_value)
parent_ids_value = "[1,2,3]"
parent_ids = json.loads(parent_ids_value)
fields = ['fields']
page_size = 50
page = 1
use_utc = False

result = assets_controller.get_devices(device_type_ids, site_ids, parent_ids, fields, page_size, page, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_devices_published_after_date

Gets the number of devices published on a site after a certain date as well as the IDs of the authorized devices.

🔐 This endpoint requires the Assets endpoint permission.

def get_devices_published_after_date(self,
                                         site_id,
                                         date)

Parameters

Parameter	Tags	Description
siteId	Required	TODO: Add a parameter description
date	Required	Date after which published devices will be fetched.

Example Usage

site_id = 200
date = datetime.now()

result = assets_controller.get_devices_published_after_date(site_id, date)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_sites

Gets a list of sites that the API key has permissions for.

🔐 This endpoint requires the Assets endpoint permission.

This request can also be made using the POST method, with a request to sites.json and a JSON request body instead of query parameters.

def get_sites(self,
                  fields=None,
                  page_size=50,
                  page=1)

Parameters

Parameter	Tags	Description
fields	Optional Collection	Which fields to include in the response. Valid fields are those defined in the SiteWithData schema (See Response Type). By default all fields are included.
pageSize	Optional DefaultValue	The number of items to return per page.
page	Optional DefaultValue	Which page to return when the number of items exceed the page size.

Example Usage

fields_value = '["siteId","title"]'
fields = json.loads(fields_value)
page_size = 50
page = 1

result = assets_controller.get_sites(fields, page_size, page)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_power_curves

Gets the default or learned power curves for wind turbines. Other device types are not supported.

🔐 This endpoint requires the PowerCurves endpoint permission.

This request can also be made using the POST method, with a request to powercurves.json and a JSON request body instead of query parameters.

def get_power_curves(self,
                         device_ids,
                         timestamp=None,
                         learned=False)

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	What devices to get power curves for. Only wind turbines are supported.
timestamp	Optional	The date for which to get power curves. The default is the current date.
learned	Optional DefaultValue	Whether to get learned power curves instead of default power curves.

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
timestamp = 2023-03-01
learned = False

result = assets_controller.get_power_curves(device_ids, timestamp, learned)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

Back to List of Controllers

AlertsController

Get controller instance

An instance of the AlertsController class can be accessed from the API Client.

 alerts_controller = client.alerts

get_active_alerts

Gets active alerts for multiple devices. The timestamps are in the time zone configured in the Greenbyte Platform. Use the useUtc flag to get timestamps in UTC.

🔐 This endpoint requires the Alerts endpoint permission.

This request can also be made using the POST method, with a request to activealerts.json and a JSON request body instead of query parameters.

def get_active_alerts(self,
                          device_ids,
                          fields=None,
                          sort_by=None,
                          sort_asc=False,
                          page_size=50,
                          page=1,
                          use_utc=False)

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	What devices to get alerts for.
fields	Optional Collection	Which fields to include in the response. Valid fields are those defined in the AlertItem schema (See Response Type). By default all fields are included.
sortBy	Optional Collection	Which fields to sort the response items by.
sortAsc	Optional DefaultValue	Whether to sort the items in ascending order.
pageSize	Optional DefaultValue	The number of items to return per page.
page	Optional DefaultValue	Which page to return when the number of items exceed the page size.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
fields_value = '["ruleId","timestampStart"]'
fields = json.loads(fields_value)
sort_by = ['sortBy']
sort_asc = False
page_size = 50
page = 1
use_utc = False

result = alerts_controller.get_active_alerts(device_ids, fields, sort_by, sort_asc, page_size, page, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_alerts

Gets alerts for multiple devices and the given time period. The timestamps are in the time zone configured in the Greenbyte Platform. Use the useUtc flag to get timestamps in UTC.

🔐 This endpoint requires the Alerts endpoint permission.

This request can also be made using the POST method, with a request to alerts.json and a JSON request body instead of query parameters.

def get_alerts(self,
                   device_ids,
                   timestamp_start,
                   timestamp_end,
                   fields=None,
                   sort_by=None,
                   sort_asc=False,
                   page_size=50,
                   page=1,
                   use_utc=False)

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	What devices to get alerts for.
timestampStart	Required	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Required | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | fields | Optional Collection | Which fields to include in the response. Valid fields are those defined in the AlertItem schema (See Response Type). By default all fields are included. | | sortBy | Optional Collection | Which fields to sort the response items by. | | sortAsc | Optional DefaultValue | Whether to sort the items in ascending order. | | pageSize | Optional DefaultValue | The number of items to return per page. | | page | Optional DefaultValue | Which page to return when the number of items exceed the page size. | | useUtc | Optional DefaultValue | Set to true to get timestamps in UTC. |

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z
fields_value = '["ruleId","timestampStart"]'
fields = json.loads(fields_value)
sort_by = ['sortBy']
sort_asc = False
page_size = 50
page = 1
use_utc = False

result = alerts_controller.get_alerts(device_ids, timestamp_start, timestamp_end, fields, sort_by, sort_asc, page_size, page, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

Back to List of Controllers

PlanController

Get controller instance

An instance of the PlanController class can be accessed from the API Client.

 plan_controller = client.plan

list_tasks

Gets a list of tasks.

🔐 This endpoint requires the Plan endpoint permission.

def list_tasks(self,
                   timestamp_start,
                   timestamp_end,
                   device_ids=None,
                   site_ids=None,
                   category_ids=None,
                   state=None,
                   fields=None,
                   page_size=50,
                   page=1,
                   use_utc=False)

Parameters

Parameter	Tags	Description
timestampStart	Required	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Required | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | deviceIds | Optional Collection | What devices to get tasks for. | | siteIds | Optional Collection | What sites to get tasks for. | | categoryIds | Optional Collection | What task categories to include. | | state | Optional | What state of tasks to get: resolved and unresolved. If not set, both resolved and unresolved tasks are included. | | fields | Optional Collection | Which fields to include in the response. Valid fields are those defined in the Task schema (See Response Type). By default all fields are included. | | pageSize | Optional DefaultValue | The number of items to return per page. | | page | Optional DefaultValue | Which page to return when the number of items exceed the page size. | | useUtc | Optional DefaultValue | Set to true to get timestamps in UTC. |

Example Usage

timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z
device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
site_ids_value = "[1,2,3]"
site_ids = json.loads(site_ids_value)
category_ids_value = "[1,2,3]"
category_ids = json.loads(category_ids_value)
state = TaskStateEnum.UNRESOLVED
fields_value = '["taskId","title"]'
fields = json.loads(fields_value)
page_size = 50
page = 1
use_utc = False

result = plan_controller.list_tasks(timestamp_start, timestamp_end, device_ids, site_ids, category_ids, state, fields, page_size, page, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_task

Get a single task by ID.

🔐 This endpoint requires the Plan endpoint permission.

def get_task(self,
                 task_id,
                 use_utc=False)

Parameters

Parameter	Tags	Description
taskId	Required	The id of the task to get.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.

Example Usage

task_id = 200
use_utc = False

result = plan_controller.get_task(task_id, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
404	The requested resource could not be found.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

list_task_categories

Gets a list of task categories.

🔐 This endpoint requires the Plan endpoint permission.

def list_task_categories(self)

Example Usage

result = plan_controller.list_task_categories()

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

list_comments_for_multiple_tasks

Gets a list of comments belonging to one or more tasks with given taskIds.

🔐 This endpoint requires the Plan endpoint permission.

def list_comments_for_multiple_tasks(self,
                                         task_ids,
                                         fields=None,
                                         page_size=50,
                                         page=1,
                                         use_utc=False)

Parameters

Parameter	Tags	Description
taskIds	Required Collection	An array of taskIds.
fields	Optional Collection	Which fields to include in the response. Valid fields are those defined in the TaskComment schema (See Response Type). By default all fields are included.
pageSize	Optional DefaultValue	The number of items to return per page.
page	Optional DefaultValue	Which page to return when the number of items exceed the page size.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.

Example Usage

task_ids_value = "[1,2,3]"
task_ids = json.loads(task_ids_value)
fields_value = '["commentId","text"]'
fields = json.loads(fields_value)
page_size = 50
page = 1
use_utc = False

result = plan_controller.list_comments_for_multiple_tasks(task_ids, fields, page_size, page, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

list_task_files

Gets a list of files belonging to a task.

🔐 This endpoint requires the Plan endpoint permission.

def list_task_files(self,
                        task_id,
                        fields=None,
                        page_size=50,
                        page=1,
                        use_utc=False)

Parameters

Parameter	Tags	Description
taskId	Required	The id of the task.
fields	Optional Collection	Which fields to include in the response. Valid fields are those defined in the TaskFile schema (See Response Type). By default all fields are included.
pageSize	Optional DefaultValue	The number of items to return per page.
page	Optional DefaultValue	Which page to return when the number of items exceed the page size.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.

Example Usage

task_id = 200
fields = ['fields']
page_size = 50
page = 1
use_utc = False

result = plan_controller.list_task_files(task_id, fields, page_size, page, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
404	The requested resource could not be found.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

download_task_file

Downloads a file belonging to a task.

🔐 This endpoint requires the Plan endpoint permission.

def download_task_file(self,
                           task_id,
                           file_id)

Parameters

Parameter	Tags	Description
taskId	Required	The id of the task.
fileId	Required	The id of the file.

Example Usage

task_id = 200
file_id = 200

result = plan_controller.download_task_file(task_id, file_id)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
404	The requested resource could not be found.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

list_site_accesses

Gets a list of site accesses.

🔐 This endpoint requires the Plan endpoint permission.

def list_site_accesses(self,
                           timestamp_start,
                           timestamp_end,
                           device_ids=None,
                           site_ids=None,
                           fields=None,
                           page_size=50,
                           page=1,
                           use_utc=False)

Parameters

Parameter	Tags	Description
timestampStart	Required	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Required | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | deviceIds | Optional Collection | What devices to get site accesses for. | | siteIds | Optional Collection | What sites to get site accesses for. | | fields | Optional Collection | Which fields to include in the response. Valid fields are those defined in the SiteAccess schema (See Response Type). By default all fields are included. | | pageSize | Optional DefaultValue | The number of items to return per page. | | page | Optional DefaultValue | Which page to return when the number of items exceed the page size. | | useUtc | Optional DefaultValue | Set to true to get timestamps in UTC. |

Example Usage

timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z
device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
site_ids_value = "[1,2,3]"
site_ids = json.loads(site_ids_value)
fields_value = '["siteAccessId","timestampStart"]'
fields = json.loads(fields_value)
page_size = 50
page = 1
use_utc = False

result = plan_controller.list_site_accesses(timestamp_start, timestamp_end, device_ids, site_ids, fields, page_size, page, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_site_access

Gets a specific site access.

🔐 This endpoint requires the Plan endpoint permission.

def get_site_access(self,
                        site_access_id,
                        use_utc=False)

Parameters

Parameter	Tags	Description
siteAccessId	Required	The id of the site access.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.

Example Usage

site_access_id = 200
use_utc = False

result = plan_controller.get_site_access(site_access_id, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
404	The requested resource could not be found.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

list_device_accesses_for_multiple_site_accesses

Gets a list of device accesses belonging to site accesses with specified SiteAccessIds.

🔐 This endpoint requires the Plan endpoint permission.

def list_device_accesses_for_multiple_site_accesses(self,
                                                        site_access_ids,
                                                        fields=None,
                                                        page_size=50,
                                                        page=1,
                                                        use_utc=False)

Parameters

Parameter	Tags	Description
siteAccessIds	Required Collection	An array of siteAccessIds.
fields	Optional Collection	Which fields to include in the response. Valid fields are those defined in the DeviceAccess schema (See Response Type). By default all fields are included.
pageSize	Optional DefaultValue	The number of items to return per page.
page	Optional DefaultValue	Which page to return when the number of items exceed the page size.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.

Example Usage

site_access_ids_value = "[1,2]"
site_access_ids = json.loads(site_access_ids_value)
fields_value = '["deviceAccessId","siteId"]'
fields = json.loads(fields_value)
page_size = 50
page = 1
use_utc = False

result = plan_controller.list_device_accesses_for_multiple_site_accesses(site_access_ids, fields, page_size, page, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_device_access

Get a single device access by ID.

🔐 This endpoint requires the Plan endpoint permission.

def get_device_access(self,
                          device_access_id,
                          use_utc=False)

Parameters

Parameter	Tags	Description
deviceAccessId	Required	The id of the device access to get.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.

Example Usage

device_access_id = 200
use_utc = False

result = plan_controller.get_device_access(device_access_id, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
404	The requested resource could not be found.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

list_downtime_events

Gets a list of downtime events.

🔐 This endpoint requires the Plan endpoint permission.

def list_downtime_events(self,
                             timestamp_start,
                             timestamp_end,
                             device_ids=None,
                             site_ids=None,
                             fields=None,
                             page_size=50,
                             page=1,
                             use_utc=False)

Parameters

Parameter	Tags	Description
timestampStart	Required	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Required | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | deviceIds | Optional Collection | What devices to get downtime events for. | | siteIds | Optional Collection | What sites to get downtime events for. | | fields | Optional Collection | Which fields to include in the response. Valid fields are those defined in the DowntimeEvent schema (See Response Type). By default all fields are included. | | pageSize | Optional DefaultValue | The number of items to return per page. | | page | Optional DefaultValue | Which page to return when the number of items exceed the page size. | | useUtc | Optional DefaultValue | Set to true to get timestamps in UTC. |

Example Usage

timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z
device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
site_ids_value = "[1,2,3]"
site_ids = json.loads(site_ids_value)
fields_value = '["deviceIds","timestampStart"]'
fields = json.loads(fields_value)
page_size = 50
page = 1
use_utc = False

result = plan_controller.list_downtime_events(timestamp_start, timestamp_end, device_ids, site_ids, fields, page_size, page, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_downtime_event

Gets a single downtime event by ID.

🔐 This endpoint requires the Plan endpoint permission.

def get_downtime_event(self,
                           downtime_event_id,
                           use_utc=False)

Parameters

Parameter	Tags	Description
downtimeEventId	Required	The id of the downtime event to get.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.

Example Usage

downtime_event_id = 109
use_utc = False

result = plan_controller.get_downtime_event(downtime_event_id, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
404	The requested resource could not be found.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

list_personnel

Gets a list of personnel.

🔐 This endpoint requires the Plan endpoint permission.

def list_personnel(self,
                       fields=None,
                       page_size=50,
                       page=1)

Parameters

Parameter	Tags	Description
fields	Optional Collection	Which fields to include in the response. Valid fields are those defined in the Personnel schema (See Response Type). By default all fields are included.
pageSize	Optional DefaultValue	The number of items to return per page.
page	Optional DefaultValue	Which page to return when the number of items exceed the page size.

Example Usage

fields_value = '["lastName","phone"]'
fields = json.loads(fields_value)
page_size = 50
page = 1

result = plan_controller.list_personnel(fields, page_size, page)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_personnel

Gets a single personnel by ID.

🔐 This endpoint requires the Plan endpoint permission.

def get_personnel(self,
                      personnel_id)

Parameters

Parameter	Tags	Description
personnelId	Required	The id of the personnel to get.

Example Usage

personnel_id = 109

result = plan_controller.get_personnel(personnel_id)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
404	The requested resource could not be found.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

list_organizations

Gets a list of organizations.

🔐 This endpoint requires the Plan endpoint permission.

def list_organizations(self)

Example Usage

result = plan_controller.list_organizations()

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

list_hse_incidents

Gets a list of HSE incidents.

🔐 This endpoint requires the Plan endpoint permission.

This is a beta feature. Some details might change before it is released as a stable version.

def list_hse_incidents(self,
                           timestamp_start,
                           timestamp_end,
                           site_ids=None,
                           state=None,
                           category=None,
                           use_utc=False)

Parameters

Parameter	Tags	Description
timestampStart	Required	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Required | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | siteIds | Optional Collection | Which sites to get HSE incidents for. | | state | Optional | Retrieve HSE incidents with state: resolved or unresolved. If not set, both resolved and unresolved HSE incidents are included. | | category | Optional | Retrieve HSE incidents with a specific category. If not set, HSE incidents of all categories are included. | | useUtc | Optional DefaultValue | Set to true to get timestamps in UTC. |

Example Usage

timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z
site_ids_value = "[1,2,3]"
site_ids = json.loads(site_ids_value)
state = StateEnum.UNRESOLVED
category = HSECategoryEnum.ACCIDENT
use_utc = False

result = plan_controller.list_hse_incidents(timestamp_start, timestamp_end, site_ids, state, category, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_hse_incident

Get a single HSE incident by ID.

🔐 This endpoint requires the Plan endpoint permission.

This is a beta feature. Some details might change before it is released as a stable version.

def get_hse_incident(self,
                         hse_incident_id,
                         use_utc=False)

Parameters

Parameter	Tags	Description
hseIncidentId	Required	The id of the HSE incident to get.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.

Example Usage

hse_incident_id = 109
use_utc = False

result = plan_controller.get_hse_incident(hse_incident_id, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
404	The requested resource could not be found.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

list_worklog_items

Gets a list of worklog items.

🔐 This endpoint requires the Plan endpoint permission.

This is a beta feature. Some details might change before it is released as a stable version.

def list_worklog_items(self,
                           timestamp_start,
                           timestamp_end,
                           site_ids=None,
                           use_utc=False)

Parameters

Parameter	Tags	Description
timestampStart	Required	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Required | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | siteIds | Optional Collection | What sites to get worklog items for. | | useUtc | Optional DefaultValue | Set to true to get timestamps in UTC. |

Example Usage

timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z
site_ids_value = "[1,2,3]"
site_ids = json.loads(site_ids_value)
use_utc = False

result = plan_controller.list_worklog_items(timestamp_start, timestamp_end, site_ids, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

get_worklog_item

Get a single worklog item by ID.

🔐 This endpoint requires the Plan endpoint permission.

This is a beta feature. Some details might change before it is released as a stable version.

def get_worklog_item(self,
                         worklog_item_id,
                         use_utc=False)

Parameters

Parameter	Tags	Description
worklogItemId	Required	The id of the worklog item to get.
useUtc	Optional DefaultValue	Set to true to get timestamps in UTC.

Example Usage

worklog_item_id = 109
use_utc = False

result = plan_controller.get_worklog_item(worklog_item_id, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
404	The requested resource could not be found.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

Back to List of Controllers

PredictController

Get controller instance

An instance of the PredictController class can be accessed from the API Client.

 predict_controller = client.predict

get_predict_alerts

Gets a list of Predict alerts based on filter criteria. The timestamps are in the time zone configured in the Greenbyte Platform. Use the useUtc flag to get timestamps in UTC.

🔐 This endpoint requires the Predict endpoint permission.

This is a beta feature. Some details might change before it is released as a stable version.

def get_predict_alerts(self,
                           device_ids,
                           timestamp_start,
                           timestamp_end,
                           site_ids=None,
                           component_ids=None,
                           status=None,
                           severity=None,
                           fields=None,
                           page_size=50,
                           page=1,
                           use_utc=False)

Parameters

Parameter	Tags	Description
deviceIds	Required Collection	What devices to get alerts for.
timestampStart	Required	The beginning of the time interval to get data for (inclusive),
in RFC 3339, section 5.6
date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The start timestamp is included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | timestampEnd | Required | The end of the time interval to get data for (exclusive), in RFC 3339, section 5.6 date-time format:

• Timestamps ending with 'Z' are treated as UTC. Example: "2020-01-01T00:00:00Z"
• Time zone (UTC) offset timestamps ending with '+HH:mm'/"-HH:mm" are also supported. Example: "2020-01-01T02:00:00-02:00"
• Other timestamps are treated as being in the time zone configured in the Greenbyte Platform. Example: "2020-01-01T00:00:00"

The end timestamp is not included in the time interval: for example, to select the full month of March 2020, set timestampStart to "2020-03-01T00:00:00" and timestampEnd to "2020-04-01T00:00:00".

Timestamps selected in the portal will by default be in UTC. | | siteIds | Optional Collection | What sites to get alerts for. | | componentIds | Optional Collection | What components to get alerts for. | | status | Optional | Which alert status to get alerts for. | | severity | Optional | What severity of alerts to get: high severity or low severity. If not set, both high and low severity alerts are included. | | fields | Optional Collection | Which fields to include in the response. Valid fields are those defined in the PredictAlert schema (See Response Type). By default all fields are included. | | pageSize | Optional DefaultValue | The number of items to return per page. | | page | Optional DefaultValue | Which page to return when the number of items exceed the page size. | | useUtc | Optional DefaultValue | Set to true to get timestamps in UTC. |

Example Usage

device_ids_value = "[1,2,3]"
device_ids = json.loads(device_ids_value)
timestamp_start = 2023-04-01T00:00:00Z
timestamp_end = 2023-04-08T00:00:00Z
site_ids_value = "[1,2,3]"
site_ids = json.loads(site_ids_value)
component_ids_value = "[1,2,3]"
component_ids = json.loads(component_ids_value)
status = PredictStatusEnum.ACTIVE
severity = PredictSeverityEnum.HIGH
fields_value = '["deviceId","highSeverity"]'
fields = json.loads(fields_value)
page_size = 50
page = 1
use_utc = False

result = predict_controller.get_predict_alerts(device_ids, timestamp_start, timestamp_end, site_ids, component_ids, status, severity, fields, page_size, page, use_utc)

Errors

Error Code	Error Description
400	The request cannot be fulfilled due to bad syntax.
401	The request is missing a valid API key.
403	One of the following: * The API key does not authorize access to the requested endpoint because of a missing endpoint permission. * The API key does not authorize access to the requested data. Devices, sites or data signals can be limited.
405	The HTTP method is not allowed for the endpoint.
429	The API key has been used in too many requests in a given amount of time. The following headers will be set in the response: * X-Rate-Limit-Limit – The rate limit period (for example "1m", "12h", or "1d"). * X-Rate-Limit-Remaining – The remaining number of requests for this period. * X-Rate-Limit-Reset – The UTC timestamp string (in ISO 8601 format) when the remaining number of requests resets. The limit is currently 1,000 requests/minute per API key and IP address.

Back to List of Controllers