IndividualEnrollment 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 una única inscripción de Device Provisioning Service y sus descriptores de acceso con un serializador y deserializador JSON.

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

type IndividualEnrollment = class
    interface IETagHolder

Public Class IndividualEnrollment
Implements IETagHolder

Herencia

Object

IndividualEnrollment

Implementaciones

IETagHolder

Ejemplos

Cuando se serializa, una inscripción individual tendrá un aspecto similar al del ejemplo siguiente:

{
    "registrationId":"validRegistrationId",
    "deviceId":"ContosoDevice-123",
    "attestation":{
        "type":"tpm",
        "tpm":{
               "endorsementKey":"validEndorsementKey"
        }
    },
    "iotHubHostName":"ContosoIoTHub.azure-devices.net",
    "provisioningStatus":"enabled"
}

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

{
    "registrationId":"validRegistrationId",
    "deviceId":"ContosoDevice-123",
    "attestation":{
        "type":"tpm",
        "tpm":{
            "endorsementKey":"validEndorsementKey"
        }
    },
    "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 y recibir información de individualEnrollment hacia y desde el servicio de aprovisionamiento.

Para crear o actualizar una inscripción en el servicio de aprovisionamiento, debe rellenar este objeto y llamar a la API CreateOrUpdateAsync(IndividualEnrollment, CancellationToken)pública .

La información mínima requerida por el servicio de aprovisionamiento es RegistrationId y atestación.

Un nuevo dispositivo se puede aprovisionar mediante tres mecanismos de atestación, X509 (X509Attestation), Clave simétrica (consulte SymmetricKeyAttestationy TPM (TpmAttestation). La definición de cada una de las que debe usar en función del hardware de autenticación físico que contenga el dispositivo.

El contenido de esta clase se serializará en un formato JSON y se enviará como cuerpo de la API rest al servicio de aprovisionamiento. O bien, el contenido de esta clase se puede rellenar mediante un JSON, recibido del servicio de aprovisionamiento, como resultado de una operación individualEnrollment, como crear, actualizar o consultar.

Constructores

IndividualEnrollment(String, Attestation)

Crea una nueva instancia de IndividualEnrollment.

Propiedades

AllocationPolicy	Directiva de asignación de este recurso. Invalida la directiva de asignación de nivel de inquilino.
Attestation	Certificación.
Capabilities	Funcionalidades del dispositivo.
CreatedDateTimeUtc	DateTime que se creó este recurso.
CustomAllocationDefinition	Definición de asignación personalizada.
DeviceId	Identificador de dispositivo de IoT Hub deseado (opcional).
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 puede asignar el dispositivo en este recurso. Debe ser un subconjunto de la lista de nivel de inquilino de los centros de IoT.
LastUpdatedDateTimeUtc	DateTime este recurso se actualizó por última vez.
ProvisioningStatus	Estado de aprovisionamiento.
RegistrationId	Id. de registro.
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.