DevicesOperations Osztály

DevicesOperations műveletek.

Öröklődés

builtins.object

DevicesOperations

Konstruktor

DevicesOperations(client, config, serializer, deserializer)

Paraméterek

client

Kötelező

Ügyfél a szolgáltatáskérésekhez.

config

Kötelező

A szolgáltatásügyfél konfigurálása.

serializer

Kötelező

Egy objektummodell szerializálója.

deserializer

Kötelező

Objektummodell-deszerializáló.

Változók

api_version

Az API verziója. Állandó érték: "2021-04-12".

Metódusok

create_or_update_identity	Létrehozza vagy frissíti egy eszköz identitását a IoT Hub identitásjegyzékében.
delete_identity	Törli az eszköz identitását a IoT Hub identitásjegyzékéből.
get_devices	Lekéri több eszköz identitását az IoT Hub identitásjegyzékből. Nem ajánlott. A IoT Hub lekérdezési API-val lekérheti az ikereszköz- és eszközidentitás-adatokat. További információt a és https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-query-language a című témakörben https://docs.microsoft.com/en-us/rest/api/iothub/service/queryiothub talál.
get_identity	Lekéri az eszközt a IoT Hub identitásjegyzékéből.
get_twin	Lekéri az ikereszközt. További információ: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-device-twins.
invoke_method	Közvetlen metódust hív meg egy eszközön. További információ: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-direct-methods.
replace_twin	Lecseréli egy ikereszköz címkéit és kívánt tulajdonságait. További információ: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-device-twins.
update_twin	Frissítések az ikereszköz címkéinek és kívánt tulajdonságainak. További információ: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-device-twins.

create_or_update_identity

Létrehozza vagy frissíti egy eszköz identitását a IoT Hub identitásjegyzékében.

create_or_update_identity(id, device, if_match=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

id

str

Kötelező

Az eszköz egyedi azonosítója.

device

Device

Kötelező

Az eszközidentitás tartalma.

if_match

str

alapértelmezett érték: None

Az eszközidentitás gyenge ETag-jének sztringje az RFC7232 szerint. Ezt nem szabad beállítani az eszköz létrehozásakor, de az eszköz frissítésekor be lehet állítani.

custom_headers

dict

alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw

bool

alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config

Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Eszköz vagy ClientRawResponse, ha raw=true

Visszatérési típus

Device,

ClientRawResponse

Kivételek

HttpOperationError

delete_identity

Törli az eszköz identitását a IoT Hub identitásjegyzékéből.

delete_identity(id, if_match=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

id

str

Kötelező

Az eszköz egyedi azonosítója.

if_match

str

alapértelmezett érték: None

Az eszközidentitás gyenge ETag-jének sztringje az RFC7232 szerint. A törlési műveletet csak akkor hajtja végre a rendszer, ha ez az ETag megegyezik a kiszolgáló által fenntartott értékkel, ami azt jelzi, hogy az eszközidentitást nem módosították a legutóbbi lekérés óta. Feltétel nélküli törlés kényszerítéséhez állítsa a If-Match helyettesítő karakterre (*).

custom_headers

dict

alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw

bool

alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config

Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Nincs vagy ClientRawResponse, ha raw=true

Visszatérési típus

None,

ClientRawResponse

Kivételek

HttpOperationError

get_devices

Lekéri több eszköz identitását az IoT Hub identitásjegyzékből. Nem ajánlott. A IoT Hub lekérdezési API-val lekérheti az ikereszköz- és eszközidentitás-adatokat. További információt a és https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-query-language a című témakörben https://docs.microsoft.com/en-us/rest/api/iothub/service/queryiothub talál.

get_devices(top=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

top

int

alapértelmezett érték: None

A lekérdezés által visszaadott eszközidentitások maximális száma. Az 1-1000 tartományon kívüli értékek 1000-nek minősülnek.

custom_headers

dict

alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw

bool

alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config

Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

list vagy ClientRawResponse if raw=true

Visszatérési típus

list[Device],

ClientRawResponse

Kivételek

HttpOperationError

get_identity

Lekéri az eszközt a IoT Hub identitásjegyzékéből.

get_identity(id, custom_headers=None, raw=False, **operation_config)

Paraméterek

id

str

Kötelező

Az eszköz egyedi azonosítója.

custom_headers

dict

alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw

bool

alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config

Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Eszköz vagy ClientRawResponse, ha raw=true

Visszatérési típus

Device,

ClientRawResponse

Kivételek

HttpOperationError

get_twin

Lekéri az ikereszközt. További információ: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-device-twins.

get_twin(id, custom_headers=None, raw=False, **operation_config)

Paraméterek

id

str

Kötelező

Az eszköz egyedi azonosítója.

custom_headers

dict

alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw

bool

alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config

Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Ikerpéldány vagy ClientRawResponse, ha raw=true

Visszatérési típus

Twin,

ClientRawResponse

Kivételek

HttpOperationError

invoke_method

Közvetlen metódust hív meg egy eszközön. További információ: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-direct-methods.

invoke_method(device_id, direct_method_request, custom_headers=None, raw=False, **operation_config)

Paraméterek

device_id

str

Kötelező

Az eszköz egyedi azonosítója.

direct_method_request

CloudToDeviceMethod

Kötelező

A közvetlen metódus végrehajtásához használt paraméterek az eszközön.

custom_headers

dict

alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw

bool

alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config

Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

CloudToDeviceMethodResult vagy ClientRawResponse, ha raw=true

Visszatérési típus

CloudToDeviceMethodResult,

ClientRawResponse

Kivételek

HttpOperationError

replace_twin

Lecseréli egy ikereszköz címkéit és kívánt tulajdonságait. További információ: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-device-twins.

replace_twin(id, device_twin_info, if_match=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

id

str

Kötelező

Az eszköz egyedi azonosítója.

device_twin_info

Twin

Kötelező

Az ikereszköz adatai, amelyek lecserélik a meglévő adatokat.

if_match

str

alapértelmezett érték: None

Az ikereszköz gyenge ETag-jének sztringje az RFC7232 szerint. Meghatározza, hogy a csereműveletet végre kell-e hajtani.

custom_headers

dict

alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw

bool

alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config

Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Ikerpéldány vagy ClientRawResponse, ha raw=true

Visszatérési típus

Twin,

ClientRawResponse

Kivételek

HttpOperationError

update_twin

Frissítések az ikereszköz címkéinek és kívánt tulajdonságainak. További információ: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-device-twins.

update_twin(id, device_twin_info, if_match=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

id

str

Kötelező

Az eszköz egyedi azonosítója.

device_twin_info

Twin

Kötelező

A frissíteni kívánt címkéket és kívánt tulajdonságokat tartalmazó ikereszköz-információ.

if_match

str

alapértelmezett érték: None

Az ikereszköz gyenge ETag-jének sztringje az RFC7232 szerint. Meghatározza, hogy a frissítési műveletet végre kell-e hajtani.

custom_headers

dict

alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw

bool

alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config

Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Ikerpéldány vagy ClientRawResponse, ha raw=true

Visszatérési típus

Twin,

ClientRawResponse

Kivételek

HttpOperationError

Attribútumok

models

models = <module 'azure.iot.hub.protocol.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\iot\\hub\\protocol\\models\\__init__.py'>