JavaScripthez készült Azure iotHub-ügyfélkódtár – 6.3.0-s verzió

Ez a csomag egy izomorf SDK-t tartalmaz (Node.js és böngészőkben egyaránt fut) az Azure iotHub-ügyfélhez.

Ezzel az API-val kezelheti az IoT Hubokat az Azure-előfizetésében.

Forráskód | Csomag (NPM) | API-referenciadokumentáció | Minták

Első lépések

Jelenleg támogatott környezetek

További részletekért tekintse meg támogatási szabályzatunkat .

Előfeltételek

Telepítse a(z) @azure/arm-iothub csomagot

Telepítse a JavaScripthez készült Azure iotHub ügyfélkódtárat a következővel npm:

npm install @azure/arm-iothub

Hozzon létre és hitelesítsen egy IotHubClient

Ahhoz, hogy létrehozhasson egy ügyfélobjektumot az Azure iotHub API eléréséhez, szüksége lesz az endpoint Azure iotHub-erőforrásra és egy credential. Az Azure iotHub-ügyfél az Azure Active Directory hitelesítő adatait használhatja a hitelesítéshez. Az Azure Portalon megtalálhatja az Azure iotHub-erőforrás végpontját.

Az Azure Active Directoryval hitelesítést végezhet a @azure/identitástárból vagy egy meglévő AAD-jogkivonatból származó hitelesítő adatokkal.

Az alább látható DefaultAzureCredential szolgáltató vagy az Azure SDK-hoz biztosított egyéb hitelesítőadat-szolgáltatók használatához telepítse a @azure/identity csomagot:

npm install @azure/identity

Emellett regisztrálnia kell egy új AAD-alkalmazást, és hozzáférést kell biztosítania az Azure iotHubhoz úgy, hogy hozzárendeli a megfelelő szerepkört a szolgáltatásnévhez (megjegyzés: az olyan szerepkörök, mint például "Owner" nem biztosítják a szükséges engedélyeket). Állítsa be az AAD-alkalmazás ügyfélazonosítójának, bérlőazonosítójának és titkos ügyfélkulcsának értékeit környezeti változókként: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Az Azure AD-alkalmazások létrehozásával kapcsolatos további információkért tekintse meg ezt az útmutatót.

const { IotHubClient } = require("@azure/arm-iothub");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new IotHubClient(new DefaultAzureCredential(), subscriptionId);

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new IotHubClient(credential, subscriptionId);

JavaScript-csomag

Ahhoz, hogy ezt az ügyfélkódtárat a böngészőben használhassa, először egy kötegelőt kell használnia. Ennek részleteiért tekintse meg a csomagküldő dokumentációt.

Fő fogalmak

IotHubClient

IotHubClient az Azure iotHub ügyfélkódtárat használó fejlesztők elsődleges felülete. Az ügyfélobjektum metódusainak megismerése az Azure iotHub szolgáltatás különböző funkcióinak megismeréséhez.

Hibaelhárítás

Naplózás

A naplózás engedélyezése segíthet a hibákról szóló hasznos információk feltárásában. A HTTP-kérések és válaszok naplójának megtekintéséhez állítsa a környezeti változót a AZURE_LOG_LEVEL értékre info. A naplózás futásidőben is engedélyezhető a következő hívással setLogLevel@azure/logger:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

A naplók engedélyezésére vonatkozó részletesebb útmutatásért tekintse meg a @azure/logger csomag dokumentációt.

Következő lépések

A kódtár használatára vonatkozó részletes példákért tekintse meg a mintakönyvtárat.

Közreműködés

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót , amelyből többet is megtudhat a kód összeállításáról és teszteléséről.

Megjelenések