Udostępnij za pomocą


Biblioteka klienta subskrypcji platformy Azure dla języka JavaScript — wersja 6.0.0

Ten pakiet zawiera izomorficzny zestaw SDK (działa zarówno w Node.js, jak i w przeglądarkach) dla klienta subskrypcji platformy Azure.

Klient subskrypcji

Dokumentacja referencyjna interfejsu APIkodu źródłowego (NPM)Przykłady

Wprowadzenie

Obecnie obsługiwane środowiska

  • Wersje LTS systemu 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-subscriptions

Zainstaluj bibliotekę klienta subskrypcji platformy Azure dla języka JavaScript za pomocą npm:

npm install @azure/arm-subscriptions

Twórz i uwierzytelnij SubscriptionClient

Aby utworzyć obiekt klienta w celu uzyskania dostępu do interfejsu API subskrypcji platformy Azure, potrzebny endpoint będzie zasób subskrypcji platformy Azure i plik credential. Klient subskrypcji platformy Azure może używać poświadczeń usługi Azure Active Directory do uwierzytelniania. Punkt końcowy zasobu subskrypcji platformy Azure 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ć dostawcy DefaultAzureCredential pokazanego poniżej lub innych dostawców poświadczeń dostarczonych z zestawem Azure SDK, zainstaluj pakiet @azure/identity:

npm install @azure/identity

Musisz również zarejestrować nową aplikację usługi AAD i udzielić dostępu do subskrypcji platformy Azure , przypisując odpowiednią rolę do jednostki usługi (uwaga: role, takie jak "Owner" nie udzielą niezbędnych uprawnień).

Aby uzyskać więcej informacji na temat tworzenia aplikacji usługi Azure AD, zobacz tym przewodniku.

Korzystając ze środowisk Node.js i środowisk podobnych do węzłów, możesz użyć klasy DefaultAzureCredential do uwierzytelniania klienta.

import { SubscriptionClient } from "@azure/arm-subscriptions";
import { DefaultAzureCredential } from "@azure/identity";

const client = new SubscriptionClient(new DefaultAzureCredential());

W przypadku środowisk przeglądarki użyj InteractiveBrowserCredential z pakietu @azure/identity do uwierzytelniania.

import { InteractiveBrowserCredential } from "@azure/identity";
import { SubscriptionClient } from "@azure/arm-subscriptions";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new SubscriptionClient(credential);

Pakiet JavaScript

Aby użyć tej biblioteki klienta w przeglądarce, najpierw należy użyć pakietu. Aby uzyskać szczegółowe informacje o tym, jak to zrobić, zapoznaj się z naszą dokumentacją dotyczącą tworzenia pakietów .

Najważniejsze pojęcia

SubscriptionClient (Klient subskrypcji)

SubscriptionClient jest podstawowym interfejsem dla deweloperów korzystających z biblioteki klienta subskrypcji platformy Azure. Zapoznaj się z metodami tego obiektu klienta, aby zrozumieć różne funkcje usługi subskrypcji platformy Azure, do której można uzyskać dostęp.

Rozwiązywanie problemów

Wycinka drzew

Włączenie rejestrowania może pomóc odkryć przydatne informacje o błędach. Aby wyświetlić dziennik żądań i odpowiedzi HTTP, ustaw zmienną środowiskową AZURE_LOG_LEVEL na info. Alternatywnie rejestrowanie można włączyć w czasie wykonywania, wywołując setLogLevel w @azure/logger:

import { setLogLevel } from "@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.

Dalsze kroki

Zapoznaj się z przykładami katalogu, aby zapoznać się ze szczegółowymi przykładami dotyczącymi korzystania z tej biblioteki.

Contributing

Jeśli chcesz współtworzyć tę bibliotekę, przeczytaj przewodnik dotyczący współtworzenia , aby dowiedzieć się więcej na temat tworzenia i testowania kodu.