IoTHubDeviceClient Osztály
Szinkron eszközügyfél, amely egy Azure IoT Hub-példányhoz csatlakozik.
IoTHubDeviceClient inicializálója.
Ezt az inicializálót nem szabad közvetlenül meghívni. Ehelyett használja az egyik ">>create_from_<<" osztálymethodot a példányosításhoz
- Öröklődés
-
azure.iot.device.iothub.sync_clients.GenericIoTHubClientIoTHubDeviceClientazure.iot.device.iothub.abstract_clients.AbstractIoTHubDeviceClientIoTHubDeviceClient
Konstruktor
IoTHubDeviceClient(mqtt_pipeline, http_pipeline)Paraméterek
- mqtt_pipeline
- <xref:azure.iot.device.iothub.pipeline.MQTTPipeline>
Az IoTHub-végponthoz való csatlakozáshoz használt folyamat.
- http_pipeline
Metódusok
| connect |
Csatlakoztatja az ügyfelet egy Azure IoT Hub vagy Azure IoT Edge Hub-példányhoz. A célhelyet az objektum inicializálásakor megadott auth_provider paraméteren keresztül átadott hitelesítő adatok alapján választja ki. Ez egy szinkron hívás, ami azt jelenti, hogy ez a függvény addig nem tér vissza, amíg a szolgáltatáshoz való kapcsolat teljesen létre nem jön. |
| create_from_connection_string |
Példányosíthatja az ügyfelet egy IoTHub-eszközről vagy modulból kapcsolati sztring. |
| create_from_sastoken |
Az ügyfél példányosítása előre létrehozott SAS-jogkivonat-sztringből |
| create_from_symmetric_key |
Ügyfél példányosítása szimmetrikus kulcsos hitelesítéssel. |
| create_from_x509_certificate |
Ügyfél példányosítása X509-tanúsítványhitelesítéssel. |
| disconnect |
Válassza le az ügyfelet a Azure IoT Hub vagy az Azure IoT Edge Hub-példányról. Javasoljuk, hogy mindenképpen hívja meg ezt a függvényt, ha teljesen elkészült az ügyfélpéldányával. Ez egy szinkron hívás, ami azt jelenti, hogy ez a függvény csak akkor tér vissza, ha a szolgáltatáshoz való kapcsolat teljesen lezárult. |
| get_storage_info_for_blob |
POST-kérést küld HTTP-en keresztül egy IoTHub-végpontnak, amely az eszközéhez csatlakoztatott IoTHubhoz társított Azure Storage-fiókon keresztüli feltöltéssel kapcsolatos információkat ad vissza. |
| get_twin |
Lekéri az ikereszközt vagy modult a Azure IoT Hub vagy az Azure IoT Edge Hub szolgáltatásból. Ez egy szinkron hívás, ami azt jelenti, hogy ez a függvény addig nem tér vissza, amíg az ikerpéldányt le nem kérik a szolgáltatásból. |
| notify_blob_upload_status |
Amikor a feltöltés befejeződött, az eszköz POST kérést küld a IoT Hub végpontnak, amely információkat tartalmaz a blobba való feltöltési kísérlet állapotáról. Ezt a IoT Hub használja a figyelési ügyfelek értesítésére. |
| patch_twin_reported_properties |
Frissítse a jelentett tulajdonságokat a Azure IoT Hub vagy az Azure IoT Edge Hub szolgáltatással. Ez egy szinkron hívás, ami azt jelenti, hogy ez a függvény addig nem tér vissza, amíg a javítást el nem küldik a szolgáltatásnak, és nyugtázták. Ha a szolgáltatás hibát ad vissza a javítási művelettel kapcsolatban, ez a függvény a megfelelő hibát eredményezi. |
| receive_message |
A Azure IoT Hub küldött üzenet fogadása. Elavult a 2.3.0-s verzió óta: Javasoljuk, hogy a .on_message_received tulajdonság használatával állítson be kezelőt |
| receive_method_request |
Metóduskérés fogadása a Azure IoT Hub vagy az Azure IoT Edge Hubon keresztül. Elavult a 2.3.0-s verzió óta: Javasoljuk, hogy a .on_method_request_received tulajdonság használatával állítson be kezelőt. |
| receive_twin_desired_properties_patch |
A kívánt tulajdonságjavítást az Azure IoT Hub vagy az Azure IoT Edge Hubon keresztül kaphatja meg. Ez egy szinkron hívás, ami a következőket jelenti:
Elavult a 2.3.0-s verzió óta: Javasoljuk, hogy a .on_twin_desired_properties_patch_received tulajdonság használatával állítson be kezelőt |
| send_message |
Üzenetet küld a Azure IoT Hub vagy az Azure IoT Edge Hub-példány alapértelmezett eseményvégpontjának. Ez egy szinkron esemény, ami azt jelenti, hogy ez a függvény addig nem tér vissza, amíg az eseményt el nem küldik a szolgáltatásnak, és a szolgáltatás nem nyugtázta az esemény fogadását. Ha a szolgáltatáshoz való csatlakozást korábban nem nyitotta meg egy csatlakozási hívás, ez a függvény az esemény elküldése előtt megnyitja a kapcsolatot. |
| send_method_response |
Válasz küldése metóduskérésre a Azure IoT Hub vagy az Azure IoT Edge Hubon keresztül. Ez egy szinkron esemény, ami azt jelenti, hogy ez a függvény addig nem tér vissza, amíg az eseményt el nem küldik a szolgáltatásnak, és a szolgáltatás nem nyugtázta az esemény fogadását. Ha a szolgáltatáshoz való csatlakozást korábban nem nyitotta meg egy csatlakozási hívás, ez a függvény az esemény elküldése előtt megnyitja a kapcsolatot. |
| shutdown |
Állítsa le az ügyfelet a türelmes kilépéshez. A metódus meghívása után a további ügyfélhívásokra tett kísérletek a ClientError indítását eredményezik. |
| update_sastoken |
Frissítse az ügyfél hitelesítéshez használt SAS-tokenjét, majd újrahitelesíti a kapcsolatot. Ez az API csak akkor használható, ha az ügyfél eredetileg SAS-jogkivonattal lett létrehozva. |
connect
Csatlakoztatja az ügyfelet egy Azure IoT Hub vagy Azure IoT Edge Hub-példányhoz.
A célhelyet az objektum inicializálásakor megadott auth_provider paraméteren keresztül átadott hitelesítő adatok alapján választja ki.
Ez egy szinkron hívás, ami azt jelenti, hogy ez a függvény addig nem tér vissza, amíg a szolgáltatáshoz való kapcsolat teljesen létre nem jön.
connect()Kivételek
ha a hitelesítő adatok érvénytelenek, és nem hozható létre kapcsolat.
ha egy kapcsolat létrehozása sikertelenséget eredményez.
ha a kapcsolat megszakad a végrehajtás során.
ha a kapcsolat túllépi az időkorlátot.
ha a végrehajtás során váratlan hiba történik.
create_from_connection_string
Példányosíthatja az ügyfelet egy IoTHub-eszközről vagy modulból kapcsolati sztring.
create_from_connection_string(connection_string, **kwargs)Paraméterek
- server_verification_cert
- str
Konfigurációs lehetőség. A megbízható tanúsítványlánc. Olyan végponthoz való csatlakozáshoz szükséges, amely nem szabványos megbízhatósági gyökerű, például protokollátjáróval rendelkezik.
- websockets
- bool
Konfigurációs lehetőség. Az alapértelmezett érték Hamis. Állítsa igaz értékre, ha az MQTT-t websocketeken keresztül használja.
Konfigurációs lehetőség. Titkosítási csomag(ok) TLS-hez/SSL-hez, "OpenSSL titkosítási listaformátumban" vagy titkosítócsomag-sztringek listájaként.
- product_info
- str
Konfigurációs lehetőség. Az alapértelmezett érték az üres sztring. A sztring tetszőleges termékadatokat tartalmaz, amelyek hozzá lesznek fűzve a felhasználói ügynök sztringjéhez.
- proxy_options
- ProxyOptions
A proxykiszolgálókon keresztüli forgalom küldésének lehetőségei.
- sastoken_ttl
- int
A hitelesítéshez használt létrehozott SasToken élettartama (másodpercben). Az alapértelmezett érték 3600 másodperc (1 óra).
- keep_alive
- int
A közvetítővel folytatott kommunikáció közötti maximális időtartam másodpercben. Ha nincs más üzenetváltás, ez szabályozza, hogy az ügyfél milyen sebességgel küld pingüzeneteket a közvetítőnek. Ha nem adja meg a 60 másodperces alapértelmezett értéket, akkor a rendszer az alapértelmezett értéket használja.
- auto_connect
- bool
Automatikusan csatlakoztassa az ügyfelet az IoTHubhoz egy metódus meghívásakor, amely megköveteli a kapcsolat létrehozását. (Alapértelmezett: Igaz)
- connection_retry_interval
- int
Megszakadt kapcsolat újbóli létesítésére tett kísérletek közötti időköz másodpercben (alapértelmezett: 10)
- ensure_desired_properties
- bool
Győződjön meg arról, hogy a legutóbbi kívánt tulajdonságjavítás érkezett az újracsatlakozásokkor (Alapértelmezett:Igaz)
Válaszok
Egy IoTHub-ügyfél egy példánya, amely kapcsolati sztring használ a hitelesítéshez.
Kivételek
create_from_sastoken
Az ügyfél példányosítása előre létrehozott SAS-jogkivonat-sztringből
create_from_sastoken(sastoken, **kwargs)Paraméterek
- server_verification_cert
- str
Konfigurációs lehetőség. A megbízható tanúsítványlánc. Olyan végponthoz való csatlakozáshoz szükséges, amely nem szabványos megbízhatósági gyökerű, például protokollátjáróval rendelkezik.
- websockets
- bool
Konfigurációs lehetőség. Az alapértelmezett érték Hamis. Állítsa igaz értékre, ha az MQTT-t websocketeken keresztül használja.
Konfigurációs lehetőség. Titkosítási csomag(ok) TLS-hez/SSL-hez, "OpenSSL titkosítási listaformátumban" vagy titkosítócsomag-sztringek listájaként.
- product_info
- str
Konfigurációs lehetőség. Az alapértelmezett érték az üres sztring. A sztring tetszőleges termékadatokat tartalmaz, amelyek hozzá lesznek fűzve a felhasználói ügynök sztringjéhez.
- proxy_options
- ProxyOptions
A proxykiszolgálókon keresztüli forgalom küldésének lehetőségei.
- keep_alive
- int
A közvetítővel folytatott kommunikáció közötti maximális időtartam másodpercben. Ha nincs más üzenetváltás, ez szabályozza, hogy az ügyfél milyen sebességgel küld pingüzeneteket a közvetítőnek. Ha nem adja meg a 60 másodperces alapértelmezett értéket, akkor a rendszer az alapértelmezett értéket használja.
- auto_connect
- bool
Automatikusan csatlakoztassa az ügyfelet az IoTHubhoz egy metódus meghívásakor, amely megköveteli a kapcsolat létrehozását. (Alapértelmezett: Igaz)
- connection_retry_interval
- int
Megszakadt kapcsolat újbóli létesítésére tett kísérletek közötti időköz másodpercben (alapértelmezett: 10)
- ensure_desired_properties
- bool
Győződjön meg arról, hogy a legutóbbi kívánt tulajdonságjavítás érkezett az újracsatlakozásokkor (Alapértelmezett:Igaz)
Kivételek
create_from_symmetric_key
Ügyfél példányosítása szimmetrikus kulcsos hitelesítéssel.
create_from_symmetric_key(symmetric_key, hostname, device_id, **kwargs)Paraméterek
- symmetric_key
A szimmetrikus kulcs.
- hostname
- str
Az IotHubot futtató gazdagép. A sztring gazdagépneveként az Áttekintés lapon található Azure Portal található.
- device_id
Az eszköz azonosítója
- server_verification_cert
- str
Konfigurációs lehetőség. A megbízható tanúsítványlánc. Olyan végponthoz való csatlakozáshoz szükséges, amely nem szabványos megbízhatósági gyökerű, például protokollátjáróval rendelkezik.
- websockets
- bool
Konfigurációs lehetőség. Az alapértelmezett érték Hamis. Állítsa igaz értékre, ha az MQTT-t websocketeken keresztül használja.
Konfigurációs lehetőség. Titkosítási csomag(ok) TLS-hez/SSL-hez, "OpenSSL titkosítási listaformátumban" vagy titkosítócsomag-sztringek listájaként.
- product_info
- str
Konfigurációs lehetőség. Az alapértelmezett érték az üres sztring. A sztring tetszőleges termékadatokat tartalmaz, amelyek hozzá lesznek fűzve a felhasználói ügynök sztringjéhez.
- proxy_options
- ProxyOptions
A proxykiszolgálókon keresztüli forgalom küldésének lehetőségei.
- sastoken_ttl
- int
A hitelesítéshez használt létrehozott SasToken élettartama (másodpercben). Az alapértelmezett érték 3600 másodperc (1 óra)
- keep_alive
- int
A közvetítővel folytatott kommunikáció közötti maximális időtartam másodpercben. Ha nincs más üzenetváltás, ez szabályozza, hogy az ügyfél milyen sebességgel küld pingüzeneteket a közvetítőnek. Ha nem adja meg a 60 másodperces alapértelmezett értéket, akkor a rendszer az alapértelmezett értéket használja.
- auto_connect
- bool
Automatikusan csatlakoztassa az ügyfelet az IoTHubhoz egy metódus meghívásakor, amely megköveteli a kapcsolat létrehozását. (Alapértelmezett: Igaz)
- connection_retry_interval
- int
Megszakadt kapcsolat újbóli létesítésére tett kísérletek közötti időköz másodpercben (alapértelmezett: 10)
- ensure_desired_properties
- bool
Győződjön meg arról, hogy a legutóbbi kívánt tulajdonságjavítás érkezett az újracsatlakozásokkor (Alapértelmezett:Igaz)
Válaszok
Egy IoTHub-ügyfél egy példánya, amely szimmetrikus kulcsot használ a hitelesítéshez.
Kivételek
create_from_x509_certificate
Ügyfél példányosítása X509-tanúsítványhitelesítéssel.
create_from_x509_certificate(x509, hostname, device_id, **kwargs)Paraméterek
- hostname
- str
Az IotHubot futtató gazdagép. A sztring gazdagépneveként az Áttekintés lapon található Azure Portal található.
- x509
- X509
A teljes x509-tanúsítványobjektum. A tanúsítvány használatához a regisztrációs objektumnak tartalmaznia kell a tanúsítványt (a főtanúsítványt vagy az egyik köztes hitelesítésszolgáltatói tanúsítványt). Ha a tanúsítvány egy CER-fájlból származik, akkor base64 kódolásúnak kell lennie.
- server_verification_cert
- str
Konfigurációs lehetőség. A megbízható tanúsítványlánc. Olyan végponthoz való csatlakozáshoz szükséges, amely nem szabványos megbízhatósági gyökerű, például protokollátjáróval rendelkezik.
- websockets
- bool
Konfigurációs lehetőség. Az alapértelmezett érték Hamis. Állítsa igaz értékre, ha az MQTT-t websocketeken keresztül használja.
Konfigurációs lehetőség. Titkosítási csomag(ok) TLS-hez/SSL-hez, "OpenSSL titkosítási listaformátumban" vagy titkosítócsomag-sztringek listájaként.
- product_info
- str
Konfigurációs lehetőség. Az alapértelmezett érték az üres sztring. A sztring tetszőleges termékadatokat tartalmaz, amelyek hozzá lesznek fűzve a felhasználói ügynök sztringjéhez.
- proxy_options
- ProxyOptions
A proxykiszolgálókon keresztüli forgalom küldésének lehetőségei.
- keep_alive
- int
A közvetítővel folytatott kommunikáció közötti maximális időtartam másodpercben. Ha nincs más üzenetváltás, ez szabályozza, hogy az ügyfél milyen sebességgel küld pingüzeneteket a közvetítőnek. Ha nem adja meg a 60 másodperces alapértelmezett értéket, akkor a rendszer az alapértelmezett értéket használja.
- auto_connect
- bool
Automatikusan csatlakoztassa az ügyfelet az IoTHubhoz egy metódus meghívásakor, amely megköveteli a kapcsolat létrehozását. (Alapértelmezett: Igaz)
- connection_retry_interval
- int
Megszakadt kapcsolat újbóli létesítésére tett kísérletek közötti időköz másodpercben (alapértelmezett: 10)
- ensure_desired_properties
- bool
Győződjön meg arról, hogy a legutóbbi kívánt tulajdonságjavítás érkezett az újracsatlakozásokkor (Alapértelmezett:Igaz)
Válaszok
Egy IoTHub-ügyfél egy példánya, amely X509-tanúsítványt használ a hitelesítéshez.
Kivételek
disconnect
Válassza le az ügyfelet a Azure IoT Hub vagy az Azure IoT Edge Hub-példányról.
Javasoljuk, hogy mindenképpen hívja meg ezt a függvényt, ha teljesen elkészült az ügyfélpéldányával.
Ez egy szinkron hívás, ami azt jelenti, hogy ez a függvény csak akkor tér vissza, ha a szolgáltatáshoz való kapcsolat teljesen lezárult.
disconnect()Kivételek
ha a végrehajtás során váratlan hiba történik.
get_storage_info_for_blob
POST-kérést küld HTTP-en keresztül egy IoTHub-végpontnak, amely az eszközéhez csatlakoztatott IoTHubhoz társított Azure Storage-fiókon keresztüli feltöltéssel kapcsolatos információkat ad vissza.
get_storage_info_for_blob(blob_name)Paraméterek
- blob_name
- str
A storage API használatával feltöltendő blob sztringformátumú neve. Ez a név fogja használni a storage megfelelő hitelesítő adatainak létrehozásához, és meg kell egyeznie az Azure Storage SDK-val a blobfeltöltés végrehajtásához használt adatokkal.
Válaszok
A IoT Hub JSON-szerű (szótárbeli) objektuma, amely a következő releváns információkat tartalmazza: correlationId, hostName, containerName, blobName, sasToken.
Kivételek
ha a hitelesítő adatok érvénytelenek, és nem hozható létre kapcsolat.
ha egy kapcsolat létrehozása sikertelenséget eredményez.
ha a kapcsolat megszakad a végrehajtás során.
ha a kapcsolat túllépi az időkorlátot.
ha a végrehajtás során váratlan hiba történik.
get_twin
Lekéri az ikereszközt vagy modult a Azure IoT Hub vagy az Azure IoT Edge Hub szolgáltatásból.
Ez egy szinkron hívás, ami azt jelenti, hogy ez a függvény addig nem tér vissza, amíg az ikerpéldányt le nem kérik a szolgáltatásból.
get_twin()Válaszok
Teljes ikerpéldány JSON-diktálásként
Visszatérési típus
Kivételek
ha a hitelesítő adatok érvénytelenek, és nem hozható létre kapcsolat.
ha egy kapcsolat létrehozása sikertelenséget eredményez.
ha a kapcsolat megszakad a végrehajtás során.
ha a csatlakozási kísérlet túllépi az időkorlátot
ha az ügyfél nincs csatlakoztatva (és nincs engedélyezve az automatikus csatlakozás)
ha a végrehajtás során váratlan hiba történik.
notify_blob_upload_status
Amikor a feltöltés befejeződött, az eszköz POST kérést küld a IoT Hub végpontnak, amely információkat tartalmaz a blobba való feltöltési kísérlet állapotáról. Ezt a IoT Hub használja a figyelési ügyfelek értesítésére.
notify_blob_upload_status(correlation_id, is_success, status_code, status_description)Paraméterek
Kivételek
ha a hitelesítő adatok érvénytelenek, és nem hozható létre kapcsolat.
ha egy kapcsolat létrehozása sikertelenséget eredményez.
ha a kapcsolat megszakad a végrehajtás során.
ha a kapcsolat túllépi az időkorlátot.
ha a végrehajtás során váratlan hiba történik.
patch_twin_reported_properties
Frissítse a jelentett tulajdonságokat a Azure IoT Hub vagy az Azure IoT Edge Hub szolgáltatással.
Ez egy szinkron hívás, ami azt jelenti, hogy ez a függvény addig nem tér vissza, amíg a javítást el nem küldik a szolgáltatásnak, és nyugtázták.
Ha a szolgáltatás hibát ad vissza a javítási művelettel kapcsolatban, ez a függvény a megfelelő hibát eredményezi.
patch_twin_reported_properties(reported_properties_patch)Paraméterek
Kivételek
ha a hitelesítő adatok érvénytelenek, és nem hozható létre kapcsolat.
ha egy kapcsolat létrehozása sikertelenséget eredményez.
ha a kapcsolat megszakad a végrehajtás során.
ha a csatlakozási kísérlet túllépi az időkorlátot
ha az ügyfél nincs csatlakoztatva (és nincs engedélyezve az automatikus csatlakozás)
ha a végrehajtás során váratlan hiba történik.
receive_message
A Azure IoT Hub küldött üzenet fogadása.
Elavult a 2.3.0-s verzió óta: Javasoljuk, hogy a .on_message_received tulajdonság használatával állítson be kezelőt
receive_message(block=True, timeout=None)Paraméterek
- block
- bool
Azt jelzi, hogy a műveletnek blokkolnia kell-e, amíg egy üzenet meg nem érkezik.
- timeout
- int
Ha szeretné, adjon meg néhány másodpercet, amíg a blokkolás túllépi az időkorlátot.
Válaszok
A Azure IoT Hub küldött üzenet, vagy Nincs, ha a blokkolási időszak végéig nem érkezett metóduskérés.
Visszatérési típus
Kivételek
ha a hitelesítő adatok érvénytelenek, és nem hozható létre kapcsolat.
ha egy kapcsolat létrehozása sikertelenséget eredményez.
ha a kapcsolat megszakad a végrehajtás során.
ha a kapcsolat túllépi az időkorlátot.
ha a végrehajtás során váratlan hiba történik.
receive_method_request
Metóduskérés fogadása a Azure IoT Hub vagy az Azure IoT Edge Hubon keresztül.
Elavult a 2.3.0-s verzió óta: Javasoljuk, hogy a .on_method_request_received tulajdonság használatával állítson be kezelőt.
receive_method_request(method_name=None, block=True, timeout=None)Paraméterek
- method_name
- str
Ha szeretné, adja meg annak a metódusnak a nevét, amely a kéréseket fogadni szeretné. Ha ez a paraméter nincs megadva, a rendszer minden olyan metódust fogad, amelyet még nem célzott meg egy másik kérés a receive_method.
- block
- bool
Azt jelzi, hogy a műveletnek blokkolnia kell-e a kérés fogadásáig.
- timeout
- int
Ha szeretné, adjon meg néhány másodpercet, amíg a blokkolás túllépi az időkorlátot.
Válaszok
MethodRequest objektum, amely a kapott metóduskérést jelöli, vagy Nincs, ha a blokkolási időszak végéig nem érkezett metóduskérés.
Kivételek
ha a hitelesítő adatok érvénytelenek, és nem hozható létre kapcsolat.
ha egy kapcsolat létrehozása sikertelenséget eredményez.
ha a kapcsolat megszakad a végrehajtás során.
ha a kapcsolat túllépi az időkorlátot.
ha a végrehajtás során váratlan hiba történik.
receive_twin_desired_properties_patch
A kívánt tulajdonságjavítást az Azure IoT Hub vagy az Azure IoT Edge Hubon keresztül kaphatja meg.
Ez egy szinkron hívás, ami a következőket jelenti:
Ha block=True, ez a függvény addig blokkolódik, amíg az alábbiak valamelyike meg nem történik:
a kívánt tulajdonságjavítás a Azure IoT Hub vagy az Azure IoT Edge Hubtól érkezik.
az időtúllépési időszak , ha van ilyen, el is telik. Időtúllépés esetén ez a függvény inboxEmpty kivételt hoz létre
Ha block=False, ez a függvény visszaadja a kívánt tulajdonságjavításokat, amelyeket a folyamat esetleg fogadott, de még nem adott vissza az alkalmazásnak. Ha a folyamat nem kapott kívánt tulajdonságjavításokat, ez a függvény inboxEmpty kivételt hoz létre
Elavult a 2.3.0-s verzió óta: Javasoljuk, hogy a .on_twin_desired_properties_patch_received tulajdonság használatával állítson be kezelőt
receive_twin_desired_properties_patch(block=True, timeout=None)Paraméterek
- block
- bool
Azt jelzi, hogy a műveletnek blokkolnia kell-e a kérés fogadásáig.
- timeout
- int
Ha szeretné, adjon meg néhány másodpercet, amíg a blokkolás túllépi az időkorlátot.
Válaszok
Ikerpéldány kívánt tulajdonságainak javítása JSON-diktálásként, vagy Nincs, ha a blokkolási időszak végéig nem érkezett javítás
Visszatérési típus
Kivételek
ha a hitelesítő adatok érvénytelenek, és nem hozható létre kapcsolat.
ha egy kapcsolat létrehozása sikertelenséget eredményez.
ha a kapcsolat megszakad a végrehajtás során.
ha a kapcsolat túllépi az időkorlátot.
ha a végrehajtás során váratlan hiba történik.
send_message
Üzenetet küld a Azure IoT Hub vagy az Azure IoT Edge Hub-példány alapértelmezett eseményvégpontjának.
Ez egy szinkron esemény, ami azt jelenti, hogy ez a függvény addig nem tér vissza, amíg az eseményt el nem küldik a szolgáltatásnak, és a szolgáltatás nem nyugtázta az esemény fogadását.
Ha a szolgáltatáshoz való csatlakozást korábban nem nyitotta meg egy csatlakozási hívás, ez a függvény az esemény elküldése előtt megnyitja a kapcsolatot.
send_message(message)Paraméterek
- message
- Message
A tényleges elküldendő üzenet. Minden átadott, amely nem az Üzenet osztály példánya, üzenetobjektummá lesz konvertálva.
Kivételek
ha a hitelesítő adatok érvénytelenek, és nem hozható létre kapcsolat.
ha egy kapcsolat létrehozása sikertelenséget eredményez.
ha a kapcsolat megszakad a végrehajtás során.
ha a csatlakozási kísérlet túllépi az időkorlátot
ha az ügyfél nincs csatlakoztatva (és nincs engedélyezve az automatikus csatlakozás)
ha a végrehajtás során váratlan hiba történik.
send_method_response
Válasz küldése metóduskérésre a Azure IoT Hub vagy az Azure IoT Edge Hubon keresztül.
Ez egy szinkron esemény, ami azt jelenti, hogy ez a függvény addig nem tér vissza, amíg az eseményt el nem küldik a szolgáltatásnak, és a szolgáltatás nem nyugtázta az esemény fogadását.
Ha a szolgáltatáshoz való csatlakozást korábban nem nyitotta meg egy csatlakozási hívás, ez a függvény az esemény elküldése előtt megnyitja a kapcsolatot.
send_method_response(method_response)Paraméterek
Kivételek
ha a hitelesítő adatok érvénytelenek, és nem hozható létre kapcsolat.
ha egy kapcsolat létrehozása sikertelenséget eredményez.
ha a kapcsolat megszakad a végrehajtás során.
ha a csatlakozási kísérlet túllépi az időkorlátot
ha az ügyfél nincs csatlakoztatva (és nincs engedélyezve az automatikus csatlakozás)
ha a végrehajtás során váratlan hiba történik.
shutdown
Állítsa le az ügyfelet a türelmes kilépéshez.
A metódus meghívása után a további ügyfélhívásokra tett kísérletek a ClientError indítását eredményezik.
shutdown()Kivételek
ha a végrehajtás során váratlan hiba történik.
update_sastoken
Frissítse az ügyfél hitelesítéshez használt SAS-tokenjét, majd újrahitelesíti a kapcsolatot.
Ez az API csak akkor használható, ha az ügyfél eredetileg SAS-jogkivonattal lett létrehozva.
update_sastoken(sastoken)Paraméterek
Kivételek
ha a hitelesítő adatok érvénytelenek, és a kapcsolat nem hozható létre újra.
ha a kapcsolat újbóli létrehozása meghiúsul.
ha a kapcsolat megszakad a végrehajtás során.
ha az újrahitelesítési kísérlet túllépi az időkorlátot.
ha az ügyfél eredetileg nem SAS-jogkivonattal lett létrehozva.
ha a végrehajtás során váratlan hiba történik.
Attribútumok
connected
Írásvédett tulajdonság, amely jelzi, hogy az átvitel csatlakoztatva van-e vagy sem.
on_background_exception
Háttérkivétel esetén a rendszer meghívja a kezelőfüggvényt vagy a koroutint.
A függvény vagy a koroutin definíciójának egy pozícióargumentumot (a kivételobjektumot) kell használnia.
on_connection_state_change
A kezelőfüggvény vagy koroutin, amelyet a rendszer meghív a kapcsolati állapot megváltozásakor.
A függvény vagy a koroutin definíciójának nem szabad pozícióargumentumokat megadnia.
on_message_received
Az üzenet érkezésekor meghívandó kezelőfüggvény vagy coroutine.
A függvény vagy a koroutin definíciójának egy pozícióargumentumot (az objektumot) kell használnia Message
on_method_request_received
A metóduskérelem fogadásakor meghívandó kezelőfüggvény vagy koroutin.
Ne felejtse el nyugtázni a metóduskérést a függvényben vagy a koroutinban az ügyfél .send_method_response() metódusának használatával.
A függvény vagy a koroutin definíciójának egy pozícióargumentumot (az objektumot) kell használnia MethodRequest
on_new_sastoken_required
A kezelőfüggvény vagy coroutine, amely akkor lesz meghívva, ha az ügyfélnek új SAS-jogkivonatra van szüksége. Ez körülbelül 2 perccel az SAS-jogkivonat lejárata előtt fog megtörténni. Windows-platformokon, ha az élettartam meghaladja a körülbelül 49 napot, a 49 nap elteltével új jogkivonatra lesz szükség, függetlenül attól, hogy mennyi az SAS-élettartam.
Vegye figyelembe, hogy ez a kezelő CSAK akkor szükséges, ha a .create_from_sastoken() metódussal létrehozott ügyfelet használja.
Az új jogkivonat az ügyfél .update_sastoken() metódusának használatával adható meg a függvényben vagy a koroutinban.
A függvény vagy a koroutin definíciójának nem szabad pozícióargumentumokat megadnia.
on_twin_desired_properties_patch_received
A kezelőfüggvény vagy koroutin, amelyet az ikertulajdonság-javítás érkezésekor hívunk meg.
A függvény vagy a koroutin definíciójának egy pozícióargumentumot kell használnia (az ikerjavítás egy JSON szótárobjektum formájában)
Azure SDK for Python