EnrollmentGroup Clase

Definición

Espacio de nombres:

Microsoft.Azure.Devices.Provisioning.Service

Ensamblado:

Microsoft.Azure.Devices.Provisioning.Service.dll

Paquete:

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

Representación de un único grupo de inscripción de Device Provisioning Service con un serializador JSON y deserializador.

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

type EnrollmentGroup = class
    interface IETagHolder

Public Class EnrollmentGroup
Implements IETagHolder

Herencia

Object

EnrollmentGroup

Implementaciones

IETagHolder

Ejemplos

Cuando se serializa, un EnrollmentGroup tendrá un aspecto similar al del ejemplo siguiente:

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

El siguiente JSON es un ejemplo de la respuesta EnrollmentGroup, recibida del servicio de aprovisionamiento.

{
   "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\""
}

Comentarios

Este objeto se usa para enviar información de EnrollmentGroup al servicio de aprovisionamiento o recibir información enrollmentGroup del servicio de aprovisionamiento.

Para crear o actualizar un EnrollmentGroup en el servicio de aprovisionamiento, debe rellenar este objeto y llamar a la API pública {@link ProvisioningServiceClient#createOrUpdateEnrollmentGroup(EnrollmentGroup)}. La información mínima requerida por el servicio de aprovisionamiento es {@link #enrollmentGroupId} y {@link #attestation}.

Para aprovisionar un dispositivo mediante EnrollmentGroup, debe contener un chip X509 con un signingCertificate para el mecanismo {@link X509Attestation}.

El contenido de esta clase se serializará en un formato JSON y se enviará como cuerpo de la API rest al servicio de aprovisionamiento.

El contenido de esta clase se puede rellenar mediante un JSON, recibido del servicio de aprovisionamiento, como resultado de una operación EnrollmentGroup como crear, actualizar o consultar EnrollmentGroup.

Constructores

EnrollmentGroup(String, Attestation)

Crea una nueva instancia de EnrollmentGroup.

Propiedades

AllocationPolicy	Directiva de asignación de este recurso. Invalida la directiva de asignación de nivel de inquilino.
Attestation	Captador y establecedor para atestación.
Capabilities	Funcionalidades del dispositivo.
CreatedDateTimeUtc	DateTime que se creó este recurso.
CustomAllocationDefinition	Definición de asignación personalizada.
EnrollmentGroupId	Identificador de grupo de inscripción.
ETag	ETag de inscripción.
InitialTwinState	Estado inicial del gemelo.
IotHubHostName	IoT Hub deseado para asignar el dispositivo.
IotHubs	La lista de nombres de centros de IoT a los que se pueden asignar los dispositivos de este recurso. Debe ser un subconjunto de la lista de niveles de inquilino de centros de IoT
LastUpdatedDateTimeUtc	Fecha y hora en que este recurso se actualizó por última vez.
ProvisioningStatus	Estado de aprovisionamiento.
RegistrationState	Estado de registro actual.
ReprovisionPolicy	Comportamiento cuando se vuelve a aprovisionar un dispositivo en un centro de IoT.

Métodos

ToString()

Convierta este objeto en un formato de impresión bonito.