DigitalTwinsClient.CreateModelsAsync 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 ou muitos modelos de forma assíncrona.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.DigitalTwins.Core.DigitalTwinsModelData[]>> CreateModelsAsync (System.Collections.Generic.IEnumerable<string> dtdlModels, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateModelsAsync : seq<string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.DigitalTwins.Core.DigitalTwinsModelData[]>>
override this.CreateModelsAsync : seq<string> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.DigitalTwins.Core.DigitalTwinsModelData[]>>

Public Overridable Function CreateModelsAsync (dtdlModels As IEnumerable(Of String), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of DigitalTwinsModelData()))

Parâmetros

dtdlModels

IEnumerable<String>

O conjunto de modelos em conformidade com a DTDL (Linguagem de Definição de Gêmeos Digitais) v2 a ser criado. Cada cadeia de caracteres corresponde a exatamente um modelo.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<Response<DigitalTwinsModelData[]>>

Os modelos criados 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.

Exemplos

await client.CreateModelsAsync(new[] { newComponentModelPayload, newModelPayload });
Console.WriteLine($"Created models '{componentModelId}' and '{sampleModelId}'.");

Comentários

A criação de modelo em massa é útil quando vários modelos têm referências entre si. Ele simplifica a criação para o cliente porque, caso contrário, os modelos teriam que ser criados em uma ordem muito específica. O serviço avalia todos os modelos para garantir que todas as referências sejam atendidas e, em seguida, aceita ou rejeita o conjunto. Portanto, usando esse método, a criação de modelo é transacional.

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

Entenda os modelos gêmeos nos Gêmeos Digitais do Azure.

Confira também

• CreateModels(IEnumerable<String>, CancellationToken)