DigitalTwinsClient.PublishComponentTelemetry Methode
Definition
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 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 PublishComponentTelemetry (string digitalTwinId, string componentName, string messageId, string payload, DateTimeOffset? timestamp = default, System.Threading.CancellationToken cancellationToken = default);
abstract member PublishComponentTelemetry : string * string * string * string * Nullable<DateTimeOffset> * System.Threading.CancellationToken -> Azure.Response
override this.PublishComponentTelemetry : string * string * string * string * Nullable<DateTimeOffset> * System.Threading.CancellationToken -> Azure.Response
Public Overridable Function PublishComponentTelemetry (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 Response
Parameter
- digitalTwinId
- String
Die ID des digitalen Zwillings.
- componentName
- String
Der Name der DTDL-Komponente.
- 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 componentName
oder payload
ist null
.
Hinweise
Weitere Beispiele finden Sie in unseren Repositorybeispielen.
Gilt für:
Weitere Informationen
Azure SDK for .NET