DigitalTwinsClient.PublishComponentTelemetryAsync Método

Referência

Definição

Namespace:: Azure.DigitalTwins.Core

Assembly:: Azure.DigitalTwins.Core.dll

Pacote:: Azure.DigitalTwins.Core v1.4.0

Origem:: DigitalTwinsClient.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Publica a telemetria do componente de um gêmeo digital de forma assíncrona. Em seguida, o resultado é consumido por um ou muitos pontos de extremidade de destino (assinantes) definidos em DigitalTwinsEventRoute. Essas rotas de evento precisam ser definidas antes de publicar uma mensagem de telemetria para que a mensagem de telemetria seja consumida.

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)

Parâmetros

digitalTwinId: String

A ID do gêmeo digital.

componentName: String

O nome do componente DTDL.

messageId: String

Um identificador de mensagem exclusivo (dentro do escopo da ID do gêmeo digital) que normalmente é usado para duplicar mensagens. O padrão será um GUID aleatório se o argumento for nulo.

payload: String

A carga de telemetria de aplicativo/json a ser enviada.

timestamp: Nullable<DateTimeOffset>

Um carimbo de data/hora RFC 3339 que identifica a hora em que a telemetria foi medida. Ele usa como padrão a data/hora atual UTC.

cancellationToken: CancellationToken

O token de cancelamento.

Retornos

Task<Response>

A resposta ResponseHTTP .

Exceções

RequestFailedException

A exceção que captura os erros do serviço. Verifique as ErrorCode propriedades e Status para obter mais detalhes.

ArgumentNullException

A exceção é gerada quando digitalTwinId ou componentNamepayload é null.

Exemplos

// 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}'.");

Comentários

Para obter mais exemplos, confira nossos exemplos de repositório.

Aplica-se a

Confira também

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

Compartilhar via