Klientská knihovna Azure IotCentral pro JavaScript – verze 6.0.0

  • Článek

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

Toto rozhraní API slouží ke správě aplikací IoT Central ve vašem předplatném Azure.

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

Začínáme

Aktuálně podporovaná prostředí

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

Požadavky

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

Nainstalujte klientskou knihovnu Azure IotCentral pro JavaScript pomocí npm:

npm install @azure/arm-iotcentral

Vytvoření a ověření IotCentralClient

K vytvoření objektu klienta pro přístup k rozhraní API Azure IotCentral budete potřebovat endpoint prostředek Azure IotCentral a credential. Klient Azure IotCentral může k ověřování použít přihlašovací údaje Azure Active Directory. Koncový bod pro prostředek Azure IotCentral 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 ke službě Azure IotCentral 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 { IotCentralClient } = require("@azure/arm-iotcentral");
const { DefaultAzureCredential } = require("@azure/identity");
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new IotCentralClient(new DefaultAzureCredential(), 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

IotCentralClient

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

Řešení potíží

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