EnrollmentGroupsClient.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.

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.EnrollmentGroup> enrollmentGroups, System.Threading.CancellationToken cancellationToken = default);

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

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

Parâmetros

bulkOperationMode

BulkOperationMode

O BulkOperationMode que define a única operação a ser feito no grupo de registro. Não pode ser nulo.

enrollmentGroups

IEnumerable<EnrollmentGroup>

A coleção de EnrollmentGroup que contém a descrição de cada grupo de registro. 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 enrollmentGroups for nulo.

ArgumentException

Se o fornecido enrollmentGroups 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 grupos de registro. Uma operação válida é determinada por BulkOperationModee pode ser 'create', 'update', 'updateIfMatchETag' ou 'delete'.