Sign in
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

Changes

Changed in 2 of the 7 revisions of this API.244

  • 2020-05-31-preview6a7b947fa760121See the full diff
    • ▲

      added the new required header request parameter dt-id

      new-required-request-parameter

    • ●

      deleted the header request parameter Message-Id

      request-parameter-removed

    • ●

      deleted the header request parameter Telemetry-Source-Time

      request-parameter-removed

    • ○

      added the new optional header request parameter dt-timestamp

      new-optional-request-parameter

  • 2020-05-31-previewd47143e47755123See the full diff
    • ▲

      added the new required header request parameter Message-Id

      new-required-request-parameter

    • ●

      deleted the header request parameter dt-id

      request-parameter-removed

    • ●

      deleted the header request parameter dt-timestamp

      request-parameter-removed

    • ○

      added the new optional header request parameter traceparent to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional header request parameter tracestate to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional header request parameter Telemetry-Source-Time

      new-optional-request-parameter