IndividualEnrollment Classe

Definição

Namespace:

Microsoft.Azure.Devices.Provisioning.Service

Assembly:

Microsoft.Azure.Devices.Provisioning.Service.dll

Pacote:

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

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

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

type IndividualEnrollment = class
    interface IETagHolder

Public Class IndividualEnrollment
Implements IETagHolder

Herança

Object

IndividualEnrollment

Implementações

IETagHolder

Exemplos

Quando serializado, um individualEnrollment será semelhante ao seguinte exemplo:

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

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

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

Comentários

Esse objeto é usado para enviar e receber informações de individualEnrollment de e para o serviço de provisionamento.

Para criar ou atualizar um Registro no serviço de provisionamento, você deve preencher esse objeto e chamar a API CreateOrUpdateAsync(IndividualEnrollment, CancellationToken)pública .

As informações mínimas exigidas pelo serviço de provisionamento são RegistrationId e Atestado.

Um novo dispositivo pode ser provisionado por três mecanismos de atestado, X509 (X509Attestation), Chave Simétrica (consulte SymmetricKeyAttestatione TPM (TpmAttestation). A definição de cada um que você deve usar dependendo do hardware de autenticação física que o dispositivo contém.

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. Ou o conteúdo dessa classe pode ser preenchido por um JSON, recebido do serviço de provisionamento, como resultado de uma operação individualEnrollment, como criar, atualizar ou consultar.

Construtores

IndividualEnrollment(String, Attestation)

Cria uma nova instância de IndividualEnrollment.

Propriedades

AllocationPolicy	A política de alocação desse recurso. Substitui a política de alocação no nível do locatário.
Attestation	Atestado.
Capabilities	Funcionalidades do dispositivo.
CreatedDateTimeUtc	O DateTime em que esse recurso foi criado.
CustomAllocationDefinition	Definição de alocação personalizada.
DeviceId	ID do dispositivo do Hub IoT desejado (opcional).
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 o dispositivo nesse recurso pode ser alocado. Deve ser um subconjunto da lista de nível de locatário de hubs IoT.
LastUpdatedDateTimeUtc	O DateTime em que este recurso foi atualizado pela última vez.
ProvisioningStatus	O status de provisionamento.
RegistrationId	ID do registro.
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 bastante bonito.