IoT Edge Connect will be decommissioned on December 10, 2024.
IoT Edge Connect uses the Akamai Platform to provide communication and data processing for millions of connected devices. It's a scalable, reliable, and distributed real-time publish-subscribe mechanism that organizes data into logical categories called topics.
IoT Edge Connect has two interfaces: the message queuing telemetry transport (MQTT) and HTTP interfaces. Together these create a logical system that deploys across multiple geographic jurisdictions.
-
MQTT interface. Provides an MQTT brokering service that lets you publish messages to and read messages from topics. It also provides topic-based filtering by distributing all incoming messages to users based on their subscribed topics.
-
HTTP interface. Provides an HTTP mechanism that lets you publish messages to and read messages from topics processed by the MQTT interface.
The IoT Edge Connect API provides namespace configurations for both the MQTT and HTTP interfaces. It allows you to reserve namespaces and configure them in selected geographic jurisdictions. Within a configuration, you can specify paths to topics and define authorization groups that can publish or subscribe to these topics. You create topics by publishing or subscribing to them.
Who should use this API
Use this API if you want to create your own automated mechanism to manage your namespace configurations outside of Akamai Control Center.
With these namespace configurations, your users can leverage the Akamai Platform to publish messages to and read messages from specified topics. This fully managed service for MQTT and HTTP messaging enables real-time communication between IoT devices and data centers.
API Summary
See the API's various operations for details on their request parameters and response data:
Operation | Method | Endpoint |
---|---|---|
Namespace | ||
List reserved namespaces | GET | /namespaces |
Reserve a namespace | POST | /namespaces |
List all reserved namespaces | GET | /namespaces/search |
Remove a namespace | DELETE | /namespaces/{namespace} |
List all namespace configurations | GET | /namespaces/{namespace}/configurations |
Create a namespace configuration | POST | /namespaces/{namespace}/configurations |
Delete a namespace configuration | DELETE | /namespaces/{namespace}/configurations/{jurisdiction} |
Get a namespace configuration | GET | /namespaces/{namespace}/configurations/{jurisdiction} |
Update a namespace configuration | PUT | /namespaces/{namespace}/configurations/{jurisdiction} |
List versions of a namespace configuration | GET | /namespaces/{namespace}/configurations/{jurisdiction}/versions |
Create a version of a namespace configuration | POST | /namespaces/{namespace}/configurations/{jurisdiction}/versions |
List all operations for configuration versions | GET | /namespaces/{namespace}/configurations/{jurisdiction}/versions/activations |
Deactivate a version of a namespace configuration | PUT | /namespaces/{namespace}/configurations/{jurisdiction}/versions/active |
Activate a version of a namespace configuration | PUT | /namespaces/{namespace}/configurations/{jurisdiction}/versions/{version} |