Connection Service Overview


The connection service APIs provide management operations for products, devices, and commands. For more information on device management in EnOS™, see Device Connectivity & Management Service.


The APIs in the connection service are some of the APIs EnOS provides that cover the core business processes of the system. For more information on EnOS APIs and the different APIs that EnOS provides, see About EnOS API.


For more information on how to invoke EnOS APIs, see Get Started with EnOS API.


Refer to the table below for the list of APIs, and whether they can be used by EnOS™ Cloud and EnOS™ Edge.

Product

Operation Name Description EnOS Cloud EnOS Edge
Create Product Create a product ×
Delete Product Delete a product ×
Get Product Get the details of a product via its productKey ×
Search Product Search for products based on the search criteria ×
Update Product Update a product ×

Device

Operation Name Description EnOS Cloud EnOS Edge
Create Device Create a device ×
Batch Create Devices Batch create devices ×
Delete Device Delete a device ×
Disable Device Disable a device ×
Enable Device Activate a device ×
Get Device Get the information of a device
Replace Device Replace the deviceKey of a device without changing its assetId ×
Search Device Search for devices based on the search criteria ×
Update Device Update a device ×

Certificate

Operation Name Description EnOS Cloud EnOS Edge
Apply Certificate Apply for a certificate and bind it to a device ×
Renew Certificate Update a certificate and bind it to a device ×
Revoke Certificate Revoke a certificate bound to a device ×
List Certificate List the certificates bound to a device ×

Gateway and Sub-Device

Operation Name Description EnOS Cloud EnOS Edge
Add Sub-Device Add new sub-devices to the gateway device ×
Get Gateway Get the gateway information based on the specified sub-device ×
Remove Sub-Device Remove sub-devices from the gateway ×
Search Sub-Device Search for sub-devices under the specified gateway ×

Device Data

Operation Name Description EnOS Cloud EnOS Edge
Cancel Command Cancel cached commands ×
Get Command Get the details of a command ×
Get Event Get the details of an event via eventId ×
Invoke Service Service invocation interface for the device ×
Search Command Search for commands ×
Search Event Search for events based on the search criteria ×
Set Measurement Point Measurepoint setting interface
Get File Get the information of a file ×
Download File Download a file from a device ×
Delete File Delete a file from a device ×

HTTP Message Integration

Operation Name Description EnOS Cloud EnOS Edge
Upload Attributes Upload the attribute data of a device, including file-type data ×
Upload Events Upload the event data of a device, including file-type data ×
Upload Measurement Points Upload the measurement point data of a device, including file-type data ×

Firmware Management

Operation Name Description EnOS Cloud EnOS Edge
Create Firmware File Create a firmware file for a product. ×
Get Firmware File Get the file of the specified firmware. ×
List Device Current Firmware List the firmware versions of all devices under the specified product. ×
Search Firmware File Search for firmware files under an OU based on the search criteria. ×
Search Device Upgrade Search for the firmware and upgrade status of the device based on the search criteria. ×
Delete Firmware Delete a firmware. ×

Firmware OTA Upgrade Management

Operation Name Description EnOS Cloud EnOS Edge
Create OTA Job Create an OTA job for batch verification or upgrading. ×
Get OTA Job Get the details of an OTA job. ×
Search OTA Job Search for OTA jobs based on the search criteria. ×
Search OTA Task Search for OTA tasks based on the search criteria. ×
Start OTA Job Start an OTA job. ×
Stop OTA Job Stop an OTA job. ×
Delete OTA Job Delete an OTA job. ×
Cancel OTA Task Cancel OTA tasks under the specified OTA job. ×
Retry OTA Task Retry OTA tasks under the specified OTA job. ×