Biblioteka klienta usługi Azure iotHub dla języka JavaScript — wersja 6.3.0
Ten pakiet zawiera zestaw SDK izomorficzny (uruchamiany zarówno w Node.js, jak i w przeglądarkach) dla klienta usługi Azure iotHub.
Ten interfejs API umożliwia zarządzanie centrami IoT w ramach subskrypcji platformy Azure.
Kod | źródłowyPakiet (NPM) | Dokumentacja referencyjna interfejsu | APIPróbki
Wprowadzenie
Obecnie obsługiwane środowiska
- Wersje LTS Node.js
- Najnowsze wersje przeglądarek Safari, Chrome, Edge i Firefox.
Aby uzyskać więcej informacji, zobacz nasze zasady pomocy technicznej .
Wymagania wstępne
Instalowanie pakietu @azure/arm-iothub
Zainstaluj bibliotekę klienta usługi Azure iotHub dla języka JavaScript za pomocą polecenia npm
:
npm install @azure/arm-iothub
Tworzenie i uwierzytelnianie IotHubClient
Aby utworzyć obiekt klienta w celu uzyskania dostępu do interfejsu API usługi Azure iotHub, potrzebny endpoint
będzie zasób usługi Azure iotHub i element credential
. Klient usługi Azure iotHub może uwierzytelniać się przy użyciu poświadczeń usługi Azure Active Directory.
Punkt końcowy zasobu usługi Azure iotHub można znaleźć w witrynie Azure Portal.
Możesz uwierzytelnić się w usłudze Azure Active Directory przy użyciu poświadczeń z biblioteki @azure/tożsamości lub istniejącego tokenu usługi AAD.
Aby użyć przedstawionego poniżej dostawcy DefaultAzureCredential lub innych dostawców poświadczeń dostarczanych z zestawem Azure SDK, zainstaluj @azure/identity
pakiet:
npm install @azure/identity
Musisz również zarejestrować nową aplikację usługi AAD i udzielić dostępu do usługi Azure iotHub , przypisując odpowiednią rolę do jednostki usługi (uwaga: role, takie jak "Owner"
nie będą udzielać niezbędnych uprawnień).
Ustaw wartości identyfikatora klienta, identyfikatora dzierżawy i klucza tajnego klienta aplikacji usługi AAD jako zmienne środowiskowe: AZURE_CLIENT_ID
, , AZURE_CLIENT_SECRET
AZURE_TENANT_ID
.
Aby uzyskać więcej informacji na temat tworzenia aplikacji Azure AD, zapoznaj się z tym przewodnikiem.
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);
Pakiet JavaScript
Aby użyć tej biblioteki klienta w przeglądarce, najpierw należy użyć narzędzia bundler. Aby uzyskać szczegółowe informacje o tym, jak to zrobić, zapoznaj się z naszą dokumentacją dotyczącą tworzenia pakietów.
Kluczowe pojęcia
IotHubClient
IotHubClient
jest podstawowym interfejsem dla deweloperów korzystających z biblioteki klienta usługi Azure iotHub. Zapoznaj się z metodami w tym obiekcie klienta, aby zrozumieć różne funkcje usługi Azure iotHub, do których można uzyskać dostęp.
Rozwiązywanie problemów
Rejestrowanie
Włączenie rejestrowania może pomóc odkryć przydatne informacje o błędach. Aby wyświetlić dziennik żądań i odpowiedzi HTTP, ustaw zmienną AZURE_LOG_LEVEL
środowiskową na info
. Alternatywnie rejestrowanie można włączyć w czasie wykonywania, wywołując setLogLevel
polecenie w pliku @azure/logger
:
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
Aby uzyskać bardziej szczegółowe instrukcje dotyczące włączania dzienników, zapoznaj się z dokumentami dotyczącymi pakietów @azure/rejestratora.
Następne kroki
Zapoznaj się z katalogiem samples , aby zapoznać się ze szczegółowymi przykładami dotyczącymi korzystania z tej biblioteki.
Współtworzenie
Jeśli chcesz współtworzyć tę bibliotekę, przeczytaj przewodnik współtworzenia , aby dowiedzieć się więcej na temat tworzenia i testowania kodu.
Powiązane projekty
Azure SDK for JavaScript