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

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

API az Azure IoT Hub Device Provisioning Service funkcióinak használatához.

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

Első lépések

Jelenleg támogatott környezetek

• A Node.jsLTS-verziói
• A Safari, a Chrome, az Edge és a Firefox legújabb verziói.

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

Előfeltételek

• Egy Azure-előfizetés.

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

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

npm install @azure/arm-deviceprovisioningservices

Hozzon létre és hitelesítsen egy IotDpsClient

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

Az Azure Active Directoryval hitelesítést végezhet a @azure/identitástár hitelesítő adataival vagy egy meglévő AAD-jogkivonattal.

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 adnia az Azure iotDps-hez ú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él-azonosítójának, bérlőazonosítójának és titkos ügyfélkulcsának értékeit környezeti változóké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 { IotDpsClient } = require("@azure/arm-deviceprovisioningservices");
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 IotDpsClient(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 IotDpsClient(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 módjáról a csomagkontraszt dokumentációjában talál további információt.

Fő fogalmak

IotDpsClient

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

Hibaelhárítás

Naplózás

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

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

A naplók engedélyezésére vonatkozó részletesebb utasításokért tekintse meg a @azure/logger csomag dokumentációjá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 buildeléséhez és teszteléséhez.

Kapcsolódó projektek

• JavaScripthez készült Microsoft Azure SDK