DigitalTwinsClient.UpdateComponentAsync 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.

Atualizações propriedades de um componente em um gêmeo digital de forma assíncrona.

public virtual System.Threading.Tasks.Task<Azure.Response> UpdateComponentAsync (string digitalTwinId, string componentName, Azure.JsonPatchDocument jsonPatchDocument, Azure.ETag? ifMatch = default, System.Threading.CancellationToken cancellationToken = default);

abstract member UpdateComponentAsync : string * string * Azure.JsonPatchDocument * Nullable<Azure.ETag> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
override this.UpdateComponentAsync : string * string * Azure.JsonPatchDocument * Nullable<Azure.ETag> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function UpdateComponentAsync (digitalTwinId As String, componentName As String, jsonPatchDocument As JsonPatchDocument, Optional ifMatch As Nullable(Of ETag) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response)

Parâmetros

digitalTwinId: String

A ID do gêmeo digital.

componentName: String

O componente que está sendo modificado.

jsonPatchDocument: JsonPatchDocument

As operações application/json-patch+json a serem executadas no componente do gêmeo digital especificado.

ifMatch: Nullable<ETag>

Opcional. Execute a operação somente se a ETag da entidade corresponder a essa ETag opcional ou * (All) for fornecida.

cancellationToken: CancellationToken

O token de cancelamento.

Retornos

Task<Response>

A resposta Response<T>HTTP . Esse objeto de resposta inclui um cabeçalho HTTP que fornece a ETag atualizada para esse recurso.

Exceções

RequestFailedException

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

Exemplos

// Update Component1 by replacing the property ComponentProp1 value,
// using an optional utility to build the payload.
var componentJsonPatchDocument = new JsonPatchDocument();
componentJsonPatchDocument.AppendReplace("/ComponentProp1", "Some new value");
await client.UpdateComponentAsync(basicDtId, "Component1", componentJsonPatchDocument);
Console.WriteLine($"Updated component for digital twin '{basicDtId}'.");

Comentários

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

Aplica-se a

Confira também

UpdateComponent(String, String, JsonPatchDocument, Nullable<ETag>, CancellationToken)

Compartilhar via