EnrollmentGroupsClient.CreateOrUpdateAsync 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 ou atualizar um grupo de registro.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Service.EnrollmentGroup> CreateOrUpdateAsync (Microsoft.Azure.Devices.Provisioning.Service.EnrollmentGroup enrollmentGroup, System.Threading.CancellationToken cancellationToken = default);

member this.CreateOrUpdateAsync : Microsoft.Azure.Devices.Provisioning.Service.EnrollmentGroup * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Service.EnrollmentGroup>

Public Function CreateOrUpdateAsync (enrollmentGroup As EnrollmentGroup, Optional cancellationToken As CancellationToken = Nothing) As Task(Of EnrollmentGroup)

Parâmetros

enrollmentGroup

EnrollmentGroup

O grupo de registro a ser criado ou atualizado.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<EnrollmentGroup>

O grupo de registro criado ou atualizado.

Exceções

Microsoft.Azure.Devices.Provisioning.Service.DeviceProvisioningServiceException

Se o serviço não foi capaz de criar ou atualizar o registro.

ArgumentNullException

Se o fornecido enrollmentGroup for nulo.

ProvisioningServiceException

Se o serviço não foi capaz de criar ou atualizar o registro.

OperationCanceledException

Se o fornecido cancellationToken tiver solicitado o cancelamento.

Comentários

Essa API cria um novo grupo de registro ou atualiza um existente. Todo o grupo de registro no Serviço de Provisionamento de Dispositivos contém um identificador exclusivo chamado enrollmentGroupId. Se essa API for chamada com um enrollmentGroupId que já existe, ela substituirá as informações existentes do grupo de registro pelo novo. Por outro lado, se o enrollmentGroupId não for encerrado, ele será criado.