Twin class

Paket:

azure-iothub

En enhetstvilling är ett dokument som beskriver tillståndet för en enhet som lagras av en Azure IoT-hubb och är tillgänglig även om enheten är offline. Den är byggd i tre avsnitt:

• Taggar: nyckel-/värdepar som endast är tillgängliga från tjänstsidan
• Önskade egenskaper: uppdateras av en tjänst och tas emot av enheten
• Rapporterade egenskaper: uppdaterades av enheten och togs emot av tjänsten.

Observera att även om det är en möjlighet, behöver önskade och rapporterade egenskaper inte matcha och att logiken för att synkronisera dessa två samlingar, om det behövs, lämnas till användaren av SDK: et.

Mer information finns i Förstå enhetstvillingar.

Det rekommenderade sättet att hämta en Twin för en viss enhet är att använda getTwin(string, HttpResponseCallback<Twin>) metoden.

Konstruktorer

Twin(string | DeviceIdentity, Registry)

Instansierar en ny Twin. Det rekommenderade sättet att hämta ett nytt Twin objekt är att använda getTwin(string, HttpResponseCallback<Twin>) metoden .

Egenskaper

deviceId	Unik identifierare för enhetsidentiteten som är associerad med tvillingen, eftersom den finns i enhetsidentitetsregistret.
etag	Tagg som används i optimistisk samtidighet för att undvika flera parallella utgåvor av enhetstvillingen.
modelId	Modell-ID för enhetsidentiteten som är associerad med tvillingen, eftersom det finns i enhetsidentitetsregistret.
moduleId	Modulidentifierare för modulen som är associerad med tvillingen, eftersom den finns i enhetsidentitetsregistret.
properties	Önskade och rapporterade egenskaper dictionnaries (respektive i properties.desired och properties.reported).
tags	Samling nyckel-/värdepar som endast är tillgängliga på tjänstsidan och som kan användas i frågor för att hitta specifika enheter.

Metoder

get()
get(IncomingMessageCallback<Twin>)	Hämtar den senaste versionen av den här enhetstvillingen från IoT Hub-tjänsten.
toJSON()
update(any)
update(any, IncomingMessageCallback<Twin>)	Uppdatera enhetstvillingen med korrigeringen som anges som argument.

Konstruktorinformation

Twin(string | DeviceIdentity, Registry)

Instansierar en ny Twin. Det rekommenderade sättet att hämta ett nytt Twin objekt är att använda getTwin(string, HttpResponseCallback<Twin>) metoden .

new Twin(device: string | DeviceIdentity, registryClient: Registry)

Parametrar

device

string | DeviceIdentity

En enhetsidentifierarsträng eller ett objekt som beskriver enheten. Om ett objekt måste det innehålla en deviceId-egenskap.

registryClient

Registry

HTTP-registerklienten som används för att köra REST API-anrop.

Egenskapsinformation

deviceId

Unik identifierare för enhetsidentiteten som är associerad med tvillingen, eftersom den finns i enhetsidentitetsregistret.

deviceId: string

Egenskapsvärde

string

etag

Tagg som används i optimistisk samtidighet för att undvika flera parallella utgåvor av enhetstvillingen.

etag: string

Egenskapsvärde

string

modelId

Modell-ID för enhetsidentiteten som är associerad med tvillingen, eftersom det finns i enhetsidentitetsregistret.

modelId?: string

Egenskapsvärde

string

moduleId

Modulidentifierare för modulen som är associerad med tvillingen, eftersom den finns i enhetsidentitetsregistret.

moduleId?: string

Egenskapsvärde

string

properties

Önskade och rapporterade egenskaper dictionnaries (respektive i properties.desired och properties.reported).

properties: { desired: {[key: string]: any}, reported: {[key: string]: any} }

Egenskapsvärde

{ desired: {[key: string]: any}, reported: {[key: string]: any} }

tags

Samling nyckel-/värdepar som endast är tillgängliga på tjänstsidan och som kan användas i frågor för att hitta specifika enheter.

tags: {[key: string]: string}

Egenskapsvärde

{[key: string]: string}

Metodinformation

get()

function get(): Promise<ResultWithIncomingMessage<Twin>>

Returer

Promise<ResultWithIncomingMessage<Twin>>

get(IncomingMessageCallback<Twin>)

Hämtar den senaste versionen av den här enhetstvillingen från IoT Hub-tjänsten.

function get(done?: IncomingMessageCallback<Twin>)

Parametrar

done

IncomingMessageCallback<Twin>

Den valfria funktionen att anropa när åtgärden är klar. done anropas med tre argument: ett felobjekt (kan vara null), ett tvillingobjekt som representerar den skapade enhetsidentiteten och ett transportspecifikt svarsobjekt som är användbart för loggning eller felsökning.

toJSON()

function toJSON(): object

Returer

object

update(any)

function update(patch: any): Promise<ResultWithIncomingMessage<Twin>>

Parametrar

patch

any

Returer

Promise<ResultWithIncomingMessage<Twin>>

update(any, IncomingMessageCallback<Twin>)

Uppdatera enhetstvillingen med korrigeringen som anges som argument.

function update(patch: any, done?: IncomingMessageCallback<Twin>)

Parametrar

patch

any

Objekt som innehåller de nya värden som ska tillämpas på den här enhetstvillingen.

done

IncomingMessageCallback<Twin>

Den valfria funktionen att anropa när åtgärden är klar. done anropas med tre argument: ett felobjekt (kan vara null), ett tvillingobjekt som representerar den skapade enhetsidentiteten och ett transportspecifikt svarsobjekt som är användbart för loggning eller felsökning.