Freigeben über

DigitalTwinsClient.PublishComponentTelemetryAsync Methode

  • Referenz

Definition

Namespace:
Azure.DigitalTwins.Core
Assembly:
Azure.DigitalTwins.Core.dll
Paket:
Azure.DigitalTwins.Core v1.4.0
Source:
DigitalTwinsClient.cs

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