v7

latestSwagger 2.02026-07-13322074.5 KB
Twins

Sends telemetry on behalf of a component in a digital twin. Status codes:

  • 204 No Content
  • 400 Bad Request
    • InvalidArgument - The digital twin id, message id, or component path is invalid.
    • ValidationFailed - The telemetry content is invalid.
  • 404 Not Found
    • DigitalTwinNotFound - The digital twin was not found.
    • ComponentNotFound - The component path was not found.
post/digitaltwins/{id}/components/{componentPath}/telemetry

Path parameters

idstring required

The id of the digital twin. The id is unique within the service and case sensitive.

componentPathstring required

The name of the DTDL component.

Query parameters

api-versionstring required

The requested API version.

Headers

Message-Idstring required

A unique message identifier (in the scope of the digital twin id) that is commonly used for de-duplicating messages.

Telemetry-Source-Timestring

An RFC 3339 timestamp that identifies the time the telemetry was measured.

Request body

object required

Response

Success