Skip to content

Commit 246f9c6

Browse files
committed
Update HTTP connector
1 parent 3af315a commit 246f9c6

File tree

2 files changed

+15
-9
lines changed

2 files changed

+15
-9
lines changed

articles/iot-operations/discover-manage-assets/concept-assets-devices.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -105,8 +105,6 @@ An *event* is a notification of a state changes to your asset. For example, a ph
105105

106106
### Streams
107107

108-
<!-- TODO: Add more information about streams. -->
109-
110108
A *stream* is streaming data from a physical device. For example, a camera connected to the media connector can stream video data. Streams include the following properties:
111109

112110
| Property | Description |

articles/iot-operations/discover-manage-assets/overview-http-connector.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,17 +14,25 @@ ms.date: 11/12/2024
1414

1515
This article introduces the connector for REST/HTTP (preview) in Azure IoT Operations. The connector for REST/HTTP calls REST endpoints to retrieve data to share with other Azure IoT Operations components. The connector for REST/HTTP is secure and performant.
1616

17-
## HTTP source types
17+
The connector for REST/HTTP enables integration with RESTful endpoints by periodically performing GET requests to devices, sensors, or systems that expose REST APIs. The connector can register the data's schema with the Azure Device Registry service, and forward the data to destinations such as MQTT broker or the state store for further processing and observability.
1818

19-
The connector for REST/HTTP can connect to various sources.
19+
The connector for REST/HTTP supports the following features:
2020

21-
<!-- TODO: Add details here when we have more information -->
21+
- Automatic retries when sampling failures occur. Reports a failed status for errors that can't be retried.
22+
- Integration with OpenTelemetry.
23+
- Use of _device endpoints_ and _namespace assets_.
24+
- Device endpoint and asset definition validation for REST compatibility.
25+
- Multiple authentication methods:
26+
- Username/password basic HTTP authentication
27+
- x509 client certificates
28+
- Anonymous access for testing purposes
29+
- Certificate trust bundle to specify additional certificate authorities
2230

23-
## Example uses
31+
For each configured dataset, the connector for REST/HTTP:
2432

25-
Example uses of the connector for REST/HTTP include calling REST APIs to retrieve data from industrial devices such as cameras, sensors, and other devices that expose data over HTTP.
26-
27-
<!-- TODO: Add details here when we have more information -->
33+
- Performs a GET request to the address specified in the device endpoint and appends the dataset's data source from the namespace asset.
34+
- Generates a message schema for each dataset based on the data it receives, and registers it with Schema Registry and Azure Device Registry.
35+
- Forwards the data to the specified destination.
2836

2937
## How does it relate to Azure IoT Operations?
3038

0 commit comments

Comments
 (0)