Klientská knihovna Azure iotHub pro JavaScript – verze 6.3.0

  • Článek

Tento balíček obsahuje izomorfní sadu SDK (spouští se v Node.js i v prohlížečích) pro klienta Azure iotHub.

Pomocí tohoto rozhraní API můžete spravovat centra IoT ve vašem předplatném Azure.

Zdrojový kód | Balíček (NPM) | Referenční dokumentace k | rozhraní APIVzorky

Začínáme

Aktuálně podporovaná prostředí

  • LtS verze Node.js
  • Nejnovější verze prohlížečů Safari, Chrome, Edge a Firefox.

Další podrobnosti najdete v našich zásadách podpory .

Požadavky

Nainstalujte balíček @azure/arm-iothub.

Nainstalujte klientskou knihovnu Azure iotHub pro JavaScript pomocí npmpříkazu :

npm install @azure/arm-iothub

Vytvoření a ověření IotHubClient

Pokud chcete vytvořit objekt klienta pro přístup k rozhraní API Azure iotHub, budete potřebovat endpoint prostředek Azure iotHub a credential. Klient Azure iotHubu může k ověření použít přihlašovací údaje Azure Active Directory. Koncový bod pro prostředek Azure iotHub najdete na webu Azure Portal.

Pomocí Azure Active Directory se můžete ověřit pomocí přihlašovacích údajů z knihovny @azure/identity nebo existujícího tokenu AAD.

Pokud chcete použít zprostředkovatele DefaultAzureCredential uvedeného níže nebo jiné poskytovatele přihlašovacích údajů poskytovaného se sadou Azure SDK, nainstalujte @azure/identity balíček:

npm install @azure/identity

Budete také muset zaregistrovat novou aplikaci AAD a udělit přístup k Azure iotHub přiřazením vhodné role k instančnímu objektu (poznámka: role jako "Owner" neudělí potřebná oprávnění). Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace AAD jako proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Další informace o tom, jak vytvořit aplikaci Azure AD, najdete v tomto průvodci.

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 Bundle

Pokud chcete tuto klientskou knihovnu používat v prohlížeči, musíte nejprve použít bundler. Podrobnosti o tom, jak to udělat, najdete v naší dokumentaci k sdružování.

Klíčové koncepty

IotHubClient

IotHubClient je primárním rozhraním pro vývojáře, kteří používají klientskou knihovnu Azure iotHub. Prozkoumejte metody tohoto objektu klienta a seznamte se s různými funkcemi služby Azure iotHub, ke kterým máte přístup.

Poradce při potížích

protokolování

Povolení protokolování může pomoct odhalit užitečné informace o selháních. Pokud chcete zobrazit protokol požadavků a odpovědí HTTP, nastavte proměnnou AZURE_LOG_LEVEL prostředí na info. Případně je možné protokolování povolit za běhu voláním setLogLevel v :@azure/logger

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

Podrobnější pokyny k povolení protokolů najdete v dokumentaci k balíčkům @azure/protokolovacího nástroje.

Další kroky

Podrobné příklady použití této knihovny najdete v adresáři samples .

Přispívání

Pokud chcete přispívat do této knihovny, přečtěte si prosím průvodce přispívání , kde se dozvíte více o tom, jak sestavit a otestovat kód.

Imprese