Compartir a través de

DigitalTwinsClient.PublishTelemetryAsync Método

  • Referencia

Definición

Espacio de nombres:
Azure.DigitalTwins.Core
Ensamblado:
Azure.DigitalTwins.Core.dll
Paquete:
Azure.DigitalTwins.Core v1.4.0
Source:
DigitalTwinsClient.cs

Publica telemetría desde un gemelo digital de forma asincrónica. Después, uno o varios puntos de conexión de destino (suscriptores) definidos en DigitalTwinsEventRoute. Estas rutas de eventos deben establecerse antes de publicar un mensaje de telemetría para que se consuma el mensaje de telemetría.

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)

Parámetros

digitalTwinId
String

Identificador del gemelo digital.

messageId
String

Identificador de mensaje único (dentro del ámbito del identificador de gemelo digital) que se usa normalmente para desduplicar mensajes. El valor predeterminado es un GUID aleatorio si el argumento es NULL.

payload
String

Carga de telemetría application/json que se va a enviar.

timestamp
Nullable<DateTimeOffset>

Marca de tiempo RFC 3339 que identifica la hora en que se midió la telemetría. El valor predeterminado es la fecha y hora UTC actuales.

cancellationToken
CancellationToken

Token de cancelación.

Devoluciones

Task<Response>

Respuesta HTTP Response.

Excepciones

RequestFailedException

Excepción que captura los errores del servicio. Consulte las ErrorCode propiedades y Status para obtener más detalles.

ArgumentNullException

La excepción se produce cuando digitalTwinId o payload es null.

Ejemplos

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

Comentarios

Para obtener más ejemplos, consulte nuestros ejemplos de repositorio.

Se aplica a

Consulte también