DigitalTwinsClient.PublishTelemetryAsync Methode

Referenz

Definition

Namespace:: Azure.DigitalTwins.Core

Assembly:: Azure.DigitalTwins.Core.dll

Paket:: Azure.DigitalTwins.Core v1.4.0

Source:: DigitalTwinsClient.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Veröffentlicht Telemetriedaten aus einem digitalen Zwilling asynchron. 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 verwendet werden kann.

public virtual System.Threading.Tasks.Task<Azure.Response> PublishTelemetryAsync (string digitalTwinId, string messageId, string payload, DateTimeOffset? timestamp = default, System.Threading.CancellationToken cancellationToken = default);

abstract member PublishTelemetryAsync : string * string * string * Nullable<DateTimeOffset> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
override this.PublishTelemetryAsync : string * string * string * Nullable<DateTimeOffset> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function PublishTelemetryAsync (digitalTwinId As String, messageId As String, payload As String, Optional timestamp As Nullable(Of DateTimeOffset) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response)

Parameter

digitalTwinId: String

Die ID des digitalen Zwillings.

messageId: String

Ein eindeutiger Nachrichtenbezeichner (im Bereich der id des digitalen Zwillings), 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 den Zeitpunkt identifiziert, zu dem die Telemetriedaten gemessen wurden. Standardmäßig wird das aktuelle Datum/Uhrzeit UTC verwendet.

cancellationToken: CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<Response>

Die HTTP-Antwort Response.

Ausnahmen

RequestFailedException

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

ArgumentNullException

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

Beispiele

// construct your json telemetry payload by hand.
await client.PublishTelemetryAsync(twinId, Guid.NewGuid().ToString(), "{\"Telemetry1\": 5}");
Console.WriteLine($"Published telemetry message to twin '{twinId}'.");

Hinweise

Weitere Beispiele finden Sie in unseren Repositorybeispielen.

Gilt für:

Weitere Informationen

PublishTelemetry(String, String, String, Nullable<DateTimeOffset>, CancellationToken)

Freigeben über