Partilhar via


IndividualEnrollment Classe

Definição

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
public class IndividualEnrollment
type IndividualEnrollment = class
    interface IETagHolder
type IndividualEnrollment = class
Public Class IndividualEnrollment
Implements IETagHolder
Public Class IndividualEnrollment
Herança
IndividualEnrollment
Implementações

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.

CreatedOnUtc

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.

LastUpdatedOnUtc

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.

Aplica-se a