Azure ManagementGroupsAPI biblioteka klienta dla JavaScript - wersja 3.0.0

Ten pakiet zawiera izomorficzne SDK (działające zarówno w Node.js, jak i w przeglądarkach) dla klienta ManagementGroupsAPI Azure systemu.

API Azure Management Groups umożliwia konsolidację wielu subskrypcji/zasobów w hierarchię organizacyjną oraz centralne zarządzanie kontrolą dostępu, politykami, powiadomieniami i raportowaniem dla tych zasobów.

Kluczowe linki:

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 zasad pomocy technicznej.

Prerequisites

Instalowanie pakietu @azure/arm-managementgroups

Zainstaluj bibliotekę klienta Azure ManagementGroupsAPI dla JavaScript z npm:

npm install @azure/arm-managementgroups

Twórz i uwierzytelnij ManagementGroupsAPI

Aby utworzyć obiekt klienta do dostępu do API ManagementGroupsAPI Azure, będziesz potrzebować endpoint swojego zasobu ManagementGroupsAPI Azure oraz credential. Klient Azure ManagementGroupsAPI może używać poświadczeń Azure Active Directory do uwierzytelniania. Punkt końcowy dla swojego Azure ManagementGroupsAPI znajdziesz w Azure Portal.

Możesz uwierzytelnić się Azure Active Directory używając poświadczenia z biblioteki @azure/identity lub istniejącego tokena AAD.

Aby korzystać z dostawcy DefaultAzureCredential pokazanego poniżej lub innych dostawców poświadczonych w Azure SDK, prosimy o zainstalowanie pakietu @azure/identity:

npm install @azure/identity

Będziesz także musiał zarejestrować nową aplikację AAD i przyznać dostęp do Azure ManagementGroupsAPI przypisując odpowiednią rolę swojemu podmiotowi usługowemu (uwaga: role takie jak "Owner" nie przyznają niezbędnych uprawnień).

Aby dowiedzieć się więcej o tym, jak stworzyć aplikację Azure AD, sprawdź ten przewodnik.

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

import { ManagementGroupsAPI } from "@azure/arm-managementgroups";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { ManagementGroupsAPI } from "@azure/arm-managementgroups";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new ManagementGroupsAPI(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 .

Kluczowe pojęcia

ManagementGroupsAPI

ManagementGroupsAPI to główny interfejs dla programistów korzystających z biblioteki klienta ManagementGroupsAPI Azure. Poznaj metody tego obiektu klienta, aby zrozumieć różne funkcje usługi Azure ManagementGroupsAPI, do której masz dostęp.

Troubleshooting

Logging

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 dokumentacją pakietu @azure/logger.

Następne 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.

  • Last updated on