EnrollmentGroup Classe

Referência

Definição

Namespace:: Microsoft.Azure.Devices.Provisioning.Service

Assembly:: Microsoft.Azure.Devices.Provisioning.Service.dll

Pacote:: Microsoft.Azure.Devices.Provisioning.Service v1.18.1

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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representação de um único grupo de registro do Serviço de Provisionamento de Dispositivos com um serializador JSON e desserializador.

public class EnrollmentGroup : Microsoft.Azure.Devices.Shared.IETagHolder

public class EnrollmentGroup

type EnrollmentGroup = class
    interface IETagHolder

type EnrollmentGroup = class

Public Class EnrollmentGroup
Implements IETagHolder

Public Class EnrollmentGroup

Herança: Object
EnrollmentGroup

Implementações: IETagHolder

Exemplos

Quando serializado, um EnrollmentGroup terá a seguinte aparência:

{
   "enrollmentGroupId":"validEnrollmentGroupId",
   "attestation":{
       "type":"x509",
       "signingCertificates":{
           "primary":{
               "certificate":"[valid certificate]"
           }
       }
   },
   "iotHubHostName":"ContosoIoTHub.azure-devices.net",
   "provisioningStatus":"enabled"
}

O JSON a seguir é um exemplo da resposta EnrollmentGroup, recebida do serviço de provisionamento.

{
   "enrollmentGroupId":"validEnrollmentGroupId",
   "attestation":{
       "type":"x509",
       "signingCertificates":{
           "primary":{
               "certificate":"[valid certificate]",
               "info": {
                   "subjectName": "CN=ROOT_00000000-0000-0000-0000-000000000000, OU=Azure IoT, O=MSFT, C=US",
                   "sha1Thumbprint": "0000000000000000000000000000000000",
                   "sha256Thumbprint": "validEnrollmentGroupId",
                   "issuerName": "CN=ROOT_00000000-0000-0000-0000-000000000000, OU=Azure IoT, O=MSFT, C=US",
                   "notBeforeUtc": "2017-11-14T12:34:18Z",
                   "notAfterUtc": "2017-11-20T12:34:18Z",
                   "serialNumber": "000000000000000000",
                   "version": 3
               }
           }
       }
   },
   "iotHubHostName":"ContosoIoTHub.azure-devices.net",
   "provisioningStatus":"enabled",
   "createdDateTimeUtc": "2017-09-28T16:29:42.3447817Z",
   "lastUpdatedDateTimeUtc": "2017-09-28T16:29:42.3447817Z",
   "etag": "\"00000000-0000-0000-0000-00000000000\""
}

Comentários

Esse objeto é usado para enviar informações de EnrollmentGroup para o serviço de provisionamento ou receber informações de EnrollmentGroup do serviço de provisionamento.

Para criar ou atualizar um EnrollmentGroup no serviço de provisionamento, você deve preencher esse objeto e chamar a API pública {@link ProvisioningServiceClient#createOrUpdateEnrollmentGroup(EnrollmentGroup)}. As informações mínimas exigidas pelo serviço de provisionamento são {@link #enrollmentGroupId} e {@link #attestation}.

Para provisionar um dispositivo usando EnrollmentGroup, ele deve conter um chip X509 com um signingCertificate para o mecanismo {@link X509Attestation}.

O conteúdo dessa classe será serializado em um formato JSON e enviado como um corpo da API rest para o serviço de provisionamento.

O conteúdo dessa classe pode ser preenchido por um JSON, recebido do serviço de provisionamento, como resultado de uma operação EnrollmentGroup, como criar, atualizar ou consultar EnrollmentGroup.

Construtores

EnrollmentGroup(String, Attestation)

Cria uma nova instância de EnrollmentGroup.

Propriedades

AllocationPolicy	A política de alocação desse recurso. Substitui a política de alocação no nível do locatário.
Attestation	Getter e setter para Atestado.
Capabilities	Funcionalidades do dispositivo.
CreatedDateTimeUtc	O DateTime em que esse recurso foi criado.
CreatedOnUtc	O DateTime em que esse recurso foi criado.
CustomAllocationDefinition	Definição de alocação personalizada.
EnrollmentGroupId	ID do Grupo de Registro.
ETag	ETag do registro.
InitialTwinState	Estado do gêmeo inicial.
IotHubHostName	Hub IoT desejado ao qual atribuir o dispositivo.
IotHubs	A lista de nomes de hubs IoT aos quais os dispositivos neste recurso podem ser alocados. Deve ser um subconjunto da lista de nível de locatário de hubs IoT
LastUpdatedDateTimeUtc	O DateTime em que esse recurso foi atualizado pela última vez.
LastUpdatedOnUtc	O DateTime em que esse recurso foi atualizado pela última vez.
ProvisioningStatus	O status de provisionamento.
RegistrationState	Estado de registro atual.
ReprovisionPolicy	O comportamento quando um dispositivo é provisionado novamente em um hub IoT.

Métodos

ToString()

Converta esse objeto em um formato de impressão bonito.

Aplica-se a

Partilhar via