Twin Osztály

Az eszköz vagy modul állapotinformációi. Ez implicit módon jön létre és törlődik, amikor a megfelelő eszköz- vagy modulidentitást létrehozza vagy törli a IoT Hub.

Öröklődés

Model

Twin

Konstruktor

Twin(**kwargs)

Paraméterek

device_id

str

Kötelező

Az eszköz egyedi azonosítója a IoT Hub identitásjegyzékében. Ez egy kis- és nagybetűket megkülönböztető sztring (legfeljebb 128 karakter hosszú) ASCII 7 bites alfanumerikus karakterből, és a következő speciális karakterek: {'-', ':', '.', '+', '%', '_', '#', '*', '?', '!', '(', ')', ',', '=', '@', ';', '$', ''}.

module_id

str

Kötelező

A modul egyedi azonosítója a IoT Hub identitásjegyzékében. Ez egy kis- és nagybetűket megkülönböztető sztring (legfeljebb 128 karakter hosszú) ASCII 7 bites alfanumerikus karakterből, és a következő speciális karakterek: {'-', ':', '.', '+', '%', '_', '#', '*', '?', '!', '(', ')', ',', '=', '@', ';', '$', ''}.

tags

dict[str, object]

Kötelező

A megoldás háttérrendszere által beolvasott és írt kulcs-érték párok gyűjteménye. Nem láthatók az eszközalkalmazások számára. Ezek a kulcsok UTF-8 kódolásúak, megkülönböztetik a kis- és nagybetűket, és akár 1 KB hosszúak is. Az engedélyezett karakterek nem tartalmazzák a UNICODE-vezérlőkaraktereket (C0 és C1 szegmensek), a ".", a "$" és a szóközt. Az értékek JSON-objektumok, legfeljebb 4 KB hosszúságúak.

properties

TwinProperties

Kötelező

Az ikerpéldány kívánt és jelentett tulajdonságai.

etag

str

Kötelező

Az ikereszköz ETag-jének sztringje az RFC7232 szerint.

version

<xref:long>

Kötelező

Az ikereszköz verziója, beleértve a címkéket és a kívánt tulajdonságokat

device_etag

str

Kötelező

Az eszköz ETag-jének sztringje az RFC7232 szerint.

status

str vagy <xref:protocol.models.enum>

Kötelező

Az eszköz engedélyezett állapota. Ha le van tiltva, az eszköz nem tud csatlakozni a szolgáltatáshoz. A lehetséges értékek a következők: "engedélyezve", "letiltva"

status_reason

str

Kötelező

Az eszköz aktuális állapotának oka, ha van ilyen.

status_update_time

datetime

Kötelező

Az eszköz állapotának legutóbbi frissítésének dátuma és időpontja.

connection_state

str vagy <xref:protocol.models.enum>

Kötelező

Az eszköz kapcsolati állapota. A lehetséges értékek a következők: "Leválasztva", "Csatlakoztatva"

last_activity_time

datetime

Kötelező

Az a dátum és idő, amikor az eszköz utoljára csatlakozik, illetve üzenetet kapott vagy küldött. A dátum és az idő ISO8601 dátum/idő formátumban van megadva UTC formátumban, például 2015-01-28T16:24:48.789Z. Ez az érték nem frissül, ha az eszköz a HTTP/1 protokollt használja az üzenetkezelési műveletek végrehajtásához.

cloud_to_device_message_count

int

Kötelező

A felhőből az eszközre küldött üzenetek száma.

authentication_type

str vagy <xref:protocol.models.enum>

Kötelező

Az eszköz által használt hitelesítési típus. Lehetséges értékek: "sas", "selfSigned", "certificateAuthority", "none"

x509_thumbprint

X509Thumbprint

Kötelező

Az eszköz X509 ujjlenyomata.

capabilities

DeviceCapabilities

Kötelező

device_scope

str

Kötelező

Az eszköz hatóköre.

parent_scopes

list[str]

Kötelező

A felső szintű peremeszközök hatókörei, ha vannak. Csak peremeszközökhöz érhető el.

Metódusok

as_dict	Adjon vissza egy JSONify típusú diktáltot a json.dump használatával. A speciális használat opcionálisan visszahívást is használhat paraméterként: A kulcs a Pythonban használt attribútumnév. Attr_desc a metaadatok diktálása. Jelenleg a "type" az msrest típussal, a "key" pedig a RestAPI kódolású kulccsal. Az érték az objektum aktuális értéke. A visszaadott sztring a kulcs szerializálására szolgál. Ha a visszatérési típus lista, akkor a rendszer hierarchikus eredménydiktátumnak tekinti. Tekintse meg a fájl három példáját: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket.
deserialize	Elemezhet egy str-t a RestAPI szintaxissal, és visszaad egy modellt.
enable_additional_properties_sending
from_dict	A diktálás adott kulcselszívóval történő elemzése modell visszaadása. Alapértelmezés szerint vegye figyelembe a kulcselszívókat (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor és last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	A modellből az Azure-ba küldendő JSON-t adja vissza. Ez a as_dict(full_restapi_key_transformer, keep_readonly=Hamis) alias. Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket.
validate	Ellenőrizze a modellt rekurzív módon, és adja vissza a ValidationError listáját.

as_dict

Adjon vissza egy JSONify típusú diktáltot a json.dump használatával.

A speciális használat opcionálisan visszahívást is használhat paraméterként:

A kulcs a Pythonban használt attribútumnév. Attr_desc a metaadatok diktálása. Jelenleg a "type" az msrest típussal, a "key" pedig a RestAPI kódolású kulccsal. Az érték az objektum aktuális értéke.

A visszaadott sztring a kulcs szerializálására szolgál. Ha a visszatérési típus lista, akkor a rendszer hierarchikus eredménydiktátumnak tekinti.

Tekintse meg a fájl három példáját:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

Paraméterek

key_transformer

<xref:function>

Egy kulcsátalakító függvény.

keep_readonly

alapértelmezett érték: True

Válaszok

A dict JSON-kompatibilis objektum

Visszatérési típus

dict

deserialize

Elemezhet egy str-t a RestAPI szintaxissal, és visszaad egy modellt.

deserialize(data, content_type=None)

Paraméterek

data

str

Kötelező

RestAPI-struktúrát használó struktúra. JSON alapértelmezés szerint.

content_type

str

alapértelmezett érték: None

A JSON alapértelmezés szerint az alkalmazás/xml beállítása XML esetén.

Válaszok

A modell egy példánya

Kivételek

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

A diktálás adott kulcselszívóval történő elemzése modell visszaadása.

Alapértelmezés szerint vegye figyelembe a kulcselszívókat (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor és last_rest_key_case_insensitive_extractor)

from_dict(data, key_extractors=None, content_type=None)

Paraméterek

data

dict

Kötelező

Egy restAPI-struktúrát használó diktálás

content_type

str

alapértelmezett érték: None

A JSON alapértelmezés szerint az alkalmazás/xml beállítása XML esetén.

key_extractors

alapértelmezett érték: None

Válaszok

A modell egy példánya

Kivételek

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

A modellből az Azure-ba küldendő JSON-t adja vissza.

Ez a as_dict(full_restapi_key_transformer, keep_readonly=Hamis) alias.

Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket.

serialize(keep_readonly=False, **kwargs)

Paraméterek

keep_readonly

bool

alapértelmezett érték: False

Ha szerializálni szeretné az olvasható attribútumokat

Válaszok

A dict JSON-kompatibilis objektum

Visszatérési típus

dict

validate

Ellenőrizze a modellt rekurzív módon, és adja vissza a ValidationError listáját.

validate()

Válaszok

Az érvényesítési hiba listája

Visszatérési típus

list