Sign in
Twins

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

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

Path parameters

idstring required

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

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