Freigeben über


DigitalTwinsClient.PublishTelemetry Methode

Definition

Veröffentlicht Telemetriedaten aus einem digitalen Zwilling synchron. Das Ergebnis wird dann von einem oder mehreren Zielendpunkten (Abonnenten) genutzt, die unter DigitalTwinsEventRoutedefiniert sind. Diese Ereignisrouten müssen vor dem Veröffentlichen einer Telemetrienachricht festgelegt werden, damit die Telemetrienachricht genutzt werden kann.

public virtual Azure.Response PublishTelemetry (string digitalTwinId, string messageId, string payload, DateTimeOffset? timestamp = default, System.Threading.CancellationToken cancellationToken = default);
abstract member PublishTelemetry : string * string * string * Nullable<DateTimeOffset> * System.Threading.CancellationToken -> Azure.Response
override this.PublishTelemetry : string * string * string * Nullable<DateTimeOffset> * System.Threading.CancellationToken -> Azure.Response
Public Overridable Function PublishTelemetry (digitalTwinId As String, messageId As String, payload As String, Optional timestamp As Nullable(Of DateTimeOffset) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response

Parameter

digitalTwinId
String

Die ID des digitalen Zwillings.

messageId
String

Ein eindeutiger Nachrichtenbezeichner (innerhalb des Bereichs der digitalen Zwillings-ID), der häufig zum Deduplizieren von Nachrichten verwendet wird. Standardmäßig wird eine zufällige GUID verwendet, wenn das Argument NULL ist.

payload
String

Die zu sendende Anwendungs-/JSON-Telemetrienutzlast.

timestamp
Nullable<DateTimeOffset>

Ein RFC 3339-Zeitstempel, der die Uhrzeit der Telemetriemessung angibt. Standardmäßig wird das aktuelle Datum/Uhrzeit UTC verwendet.

cancellationToken
CancellationToken

Das Abbruchtoken.

Gibt zurück

Die HTTP-Antwort Response.

Ausnahmen

Die Ausnahme, die die Fehler des Diensts erfasst. Weitere Details finden Sie in den ErrorCode Eigenschaften und Status .

Die Ausnahme wird ausgelöst, wenn digitalTwinId oder payload ist null.

Hinweise

Weitere Beispiele finden Sie in unseren Repositorybeispielen.

Gilt für:

Weitere Informationen