DigitalTwinsClient.PublishComponentTelemetryAsync 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 der Komponente eines digitalen Zwillings 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> PublishComponentTelemetryAsync (string digitalTwinId, string componentName, string messageId, string payload, DateTimeOffset? timestamp = default, System.Threading.CancellationToken cancellationToken = default);

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

Public Overridable Function PublishComponentTelemetryAsync (digitalTwinId As String, componentName 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.

componentName: String

Der Name der DTDL-Komponente.

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 oder payloadcomponentName istnull.

Beispiele

// construct your json telemetry payload by serializing a dictionary.
var telemetryPayload = new Dictionary<string, int>
{
    { "ComponentTelemetry1", 9 }
};
await client.PublishComponentTelemetryAsync(
    twinId,
    "Component1",
    Guid.NewGuid().ToString(),
    JsonSerializer.Serialize(telemetryPayload));
Console.WriteLine($"Published component telemetry message to twin '{twinId}'.");

Hinweise

Weitere Beispiele finden Sie in unseren Repositorybeispielen.

Gilt für:

Weitere Informationen

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

Freigeben über