IndividualEnrollmentsClient.RunBulkOperationAsync Método

Definição

Namespace:

Microsoft.Azure.Devices.Provisioning.Service

Assembly:

Microsoft.Azure.Devices.Provisioning.Service.dll

Pacote:

Microsoft.Azure.Devices.Provisioning.Service v2.0.0-preview002

Criar, atualizar ou excluir um conjunto de grupos de registro individuais.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Service.BulkEnrollmentOperationResult> RunBulkOperationAsync (Microsoft.Azure.Devices.Provisioning.Service.BulkOperationMode bulkOperationMode, System.Collections.Generic.IEnumerable<Microsoft.Azure.Devices.Provisioning.Service.IndividualEnrollment> individualEnrollments, System.Threading.CancellationToken cancellationToken = default);

member this.RunBulkOperationAsync : Microsoft.Azure.Devices.Provisioning.Service.BulkOperationMode * seq<Microsoft.Azure.Devices.Provisioning.Service.IndividualEnrollment> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Service.BulkEnrollmentOperationResult>

Public Function RunBulkOperationAsync (bulkOperationMode As BulkOperationMode, individualEnrollments As IEnumerable(Of IndividualEnrollment), Optional cancellationToken As CancellationToken = Nothing) As Task(Of BulkEnrollmentOperationResult)

Parâmetros

bulkOperationMode

BulkOperationMode

O BulkOperationMode que define a única operação a ser feito sobre individualEnrollments. Não pode ser nulo.

individualEnrollments

IEnumerable<IndividualEnrollment>

A coleção de IndividualEnrollment que contém a descrição de cada individualEnrollment. Não pode ser nulo ou vazio.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<BulkEnrollmentOperationResult>

Um objeto com o resultado de cada operação.

Exceções

Microsoft.Azure.Devices.Provisioning.Service.DeviceProvisioningServiceException

Se o cliente não conseguiu enviar a solicitação ou o serviço não pôde executar a operação em massa.

ArgumentNullException

Se o fornecido individualEnrollments for nulo.

ArgumentException

Se o fornecido individualEnrollments for uma coleção vazia.

ProvisioningServiceException

Se o cliente não conseguiu enviar a solicitação ou o serviço não pôde executar a operação em massa.

OperationCanceledException

Se o fornecido cancellationToken tiver solicitado o cancelamento.

Comentários

Essa API fornece os meios para fazer uma única operação em vários registros individuais. Uma operação válida é determinada por BulkOperationModee pode ser 'create', 'update', 'updateIfMatchETag' ou 'delete'.