Condividi tramite


Device class

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 spedita con un errore di digitazione sul nome della proprietà symmetricKey (era pascal-cased anziché camel-cased). L'SDK mantiene questa classe per non interrompere il codice esistente, ma questo verrà rimosso in un futuro aggiornamento della versione principale e i clienti devono invece usare oggetti JSON semplici.

Costruttori

Device(any)

Creare un'istanza di un nuovo oggetto Device.

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 in questo momento, poiché la connessione del dispositivo potrebbe avere avuto un timeout 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 o 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 oggetto Device.

new Device(jsonData?: any)

Parametri

jsonData

any

Rappresentazione JSON facoltativa del dispositivo, che verrà mappata 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à

capabilities

Contiene le funzionalità di questo dispositivo.

capabilities?: Capabilities

Valore della proprietà

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 in questo momento, poiché la connessione del dispositivo potrebbe avere avuto un timeout 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à

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 o 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à

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