Condividi tramite

Device class

  • Riferimento
Pacchetto:
azure-iothub

Avviso

Questa API è ora deprecata.

Crea una rappresentazione di un dispositivo da usare con le API del registro delle identità del dispositivo .

Questa classe è deprecata perché il registro delle identità del dispositivo può funzionare direttamente con oggetti JSON contenenti una descrizione parziale del dispositivo, non necessariamente l'oggetto completo. In cima a questo inizialmente questa classe è stata fornita con un errore di digitazione sul nome della symmetricKey proprietà (è stato cased pascal invece di camel-cased). L'SDK mantiene questa classe per non interrompere il codice esistente, ma verrà rimosso in un futuro aggiornamento della versione principale e i clienti devono usare invece oggetti JSON semplici.

Costruttori

Device(any)

Creare un'istanza di un nuovo Device oggetto.

Proprietà

authentication

Contiene le chiavi simmetriche usate per autenticare il dispositivo.
capabilities

Contiene le funzionalità di questo dispositivo.
cloudToDeviceMessageCount

Numero di messaggi c2d in attesa da recapitati al dispositivo.
connectionState

Indica se il dispositivo è "connesso" o "disconnesso". Non è consigliabile usare questa proprietà per determinare se il dispositivo è effettivamente connesso al momento, poiché la connessione al dispositivo potrebbe essere scaduta e l'hub IoT potrebbe non averla rilevata o se il dispositivo usa HTTPS per connettersi. Se è necessario monitorare le connessioni dei dispositivi, il modo consigliato consiste nell'usare la funzionalità di monitoraggio delle operazioni dell'hub.
connectionStateUpdatedTime

Timestamp che rappresenta l'ultima volta connectionState modificata.
deviceId

Identificatore univoco del dispositivo esistente nel registro dei dispositivi dell'hub IoT di Azure.
etag

Tag di entità debole assegnato a questa descrizione dell'identità del dispositivo
generationId

Usato per disambiguare i dispositivi che sono stati eliminati/ricreati con lo stesso deviceId
lastActivityTime

Timestamp che rappresenta l'ultima volta che il dispositivo ha autenticato, inviato un messaggio o ricevuto un messaggio.
status

'enabled' (dispositivo autorizzato a connettersi, può inviare/ricevere messaggi) o 'disabilitato'.
statusReason

Stringa di 128 caratteri impostata quando il dispositivo è disabilitato.
statusUpdatedTime

Timestamp che rappresenta l'ultima volta status modificata.

Dettagli costruttore

Device(any)

Creare un'istanza di un nuovo Device oggetto.

new Device(jsonData?: any)

Parametri

jsonData

any

Rappresentazione JSON facoltativa del dispositivo, di cui verrà eseguito il mapping alle proprietà nell'oggetto . Se non viene specificato alcun argomento, alle proprietà del dispositivo verranno assegnati valori predefiniti.

Dettagli proprietà

authentication

Contiene le chiavi simmetriche usate per autenticare il dispositivo.

authentication?: Authentication

Valore della proprietà

Authentication

capabilities

Contiene le funzionalità di questo dispositivo.

capabilities?: Capabilities

Valore della proprietà

Capabilities

cloudToDeviceMessageCount

Numero di messaggi c2d in attesa da recapitati al dispositivo.

cloudToDeviceMessageCount?: string

Valore della proprietà

string

connectionState

Indica se il dispositivo è "connesso" o "disconnesso". Non è consigliabile usare questa proprietà per determinare se il dispositivo è effettivamente connesso al momento, poiché la connessione al dispositivo potrebbe essere scaduta e l'hub IoT potrebbe non averla rilevata o se il dispositivo usa HTTPS per connettersi. Se è necessario monitorare le connessioni dei dispositivi, il modo consigliato consiste nell'usare la funzionalità di monitoraggio delle operazioni dell'hub.

connectionState?: ConnectionState

Valore della proprietà

ConnectionState

connectionStateUpdatedTime

Timestamp che rappresenta l'ultima volta connectionState modificata.

connectionStateUpdatedTime?: string

Valore della proprietà

string

deviceId

Identificatore univoco del dispositivo esistente nel registro dei dispositivi dell'hub IoT di Azure.

deviceId: string

Valore della proprietà

string

etag

Tag di entità debole assegnato a questa descrizione dell'identità del dispositivo

etag?: string

Valore della proprietà

string

generationId

Usato per disambiguare i dispositivi che sono stati eliminati/ricreati con lo stesso deviceId

generationId?: string

Valore della proprietà

string

lastActivityTime

Timestamp che rappresenta l'ultima volta che il dispositivo ha autenticato, inviato un messaggio o ricevuto un messaggio.

lastActivityTime?: string

Valore della proprietà

string

status

'enabled' (dispositivo autorizzato a connettersi, può inviare/ricevere messaggi) o 'disabilitato'.

status?: DeviceStatus

Valore della proprietà

DeviceStatus

statusReason

Stringa di 128 caratteri impostata quando il dispositivo è disabilitato.

statusReason?: string

Valore della proprietà

string

statusUpdatedTime

Timestamp che rappresenta l'ultima volta status modificata.

statusUpdatedTime?: string

Valore della proprietà

string