DigitalTwinsClient.CreateOrReplaceDigitalTwinAsync<T> Método

Definição

Namespace:

Azure.DigitalTwins.Core

Assembly:

Azure.DigitalTwins.Core.dll

Pacote:

Azure.DigitalTwins.Core v1.4.0

Origem:

DigitalTwinsClient.cs

Cria um gêmeo digital de forma assíncrona. Se a ID de gêmeo digital fornecida já estiver em uso, isso tentará substituir o gêmeo digital existente pelo gêmeo digital fornecido.

public virtual System.Threading.Tasks.Task<Azure.Response<T>> CreateOrReplaceDigitalTwinAsync<T> (string digitalTwinId, T digitalTwin, Azure.ETag? ifNoneMatch = default, System.Threading.CancellationToken cancellationToken = default);

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

Public Overridable Function CreateOrReplaceDigitalTwinAsync(Of T) (digitalTwinId As String, digitalTwin As T, Optional ifNoneMatch As Nullable(Of ETag) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of T))

Parâmetros de tipo

T

O tipo para o qual desserializar o gêmeo digital.

Parâmetros

digitalTwinId

String

A ID do gêmeo digital.

digitalTwin

T

O aplicativo/json gêmeo digital a ser criado.

ifNoneMatch

Nullable<ETag>

O cabeçalho If-None-Match que torna o método de solicitação condicional em um cache de destinatário ou servidor de origem não tem nenhuma representação atual do recurso de destino. Para obter mais informações sobre essa propriedade, consulte RFC 7232. Os valores aceitáveis são nulos ou "". Se a opção ifNonMatch for nula, o serviço substituirá a entidade existente pela nova entidade. Se a opção ifNoneMatch for "" (ou All), o serviço rejeitará a solicitação se a entidade já existir. Uma ETag opcional só fará a solicitação se o valor não corresponder ao serviço.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<Response<T>>

O aplicativo/json gêmeo digital criado e a resposta Response<T>HTTP .

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 digitalTwin é null.

Exemplos

var customTwin = new CustomDigitalTwin
{
    Id = customDtId,
    Metadata = { ModelId = modelId },
    Prop1 = "Prop1 val",
    Prop2 = 987,
    Component1 = new MyCustomComponent
    {
        ComponentProp1 = "Component prop1 val",
        ComponentProp2 = 123,
    },
};
Response<CustomDigitalTwin> createCustomDigitalTwinResponse = await client.CreateOrReplaceDigitalTwinAsync(customDtId, customTwin);
Console.WriteLine($"Created digital twin '{createCustomDigitalTwinResponse.Value.Id}'.");

Comentários

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