Клиентская библиотека Azure ManagementGroupsAPI для JavaScript — версия 3.0.0

Этот пакет содержит изоморфный SDK (работает как в Node.js, так и в браузерах) для Azure клиента ManagementGroupsAPI.

API Azure Management Groups позволяет объединять несколько подписок и ресурсов в организационную иерархию и централизованно управлять контролем доступа, политиками, оповещениями и отчётностью по этим ресурсам.

Ключевые ссылки:

Начало работы

Поддерживаемые в настоящее время среды

Чтобы получить дополнительные сведения, ознакомьтесь с нашей политикой поддержки.

Prerequisites

Установите пакет @azure/arm-managementgroups.

Установите клиентскую библиотеку Azure ManagementGroupsAPI для JavaScript с помощью npm:

npm install @azure/arm-managementgroups

Создание и проверка подлинности ManagementGroupsAPI

Чтобы создать клиентский объект для доступа к API Azure ManagementGroupsAPI, вам понадобится endpoint вашего Azure ресурса ManagementGroupsAPI и credential. Клиент Azure ManagementGroupsAPI может использовать учетные данные Azure Active Directory для аутентификации. Вы можете найти конечную точку для вашего Azure ресурса ManagementGroupsAPI в портал Azure.

Вы можете аутентифицироваться с помощью Azure Active Directory, используя учетные данные из библиотеки @azure/identity или существующий токен AAD.

Чтобы воспользоваться провайдером DefaultAzureCredential, показанным ниже, или другими поставщиками учетных данных, предоставленными с Azure SDK, пожалуйста, установите пакет @azure/identity:

npm install @azure/identity

Также вам нужно будет зарегистрировать заявку на AAD и предоставить доступ к Azure ManagementGroupsAPI назначив соответствующую роль вашему руководителю службы (примечание: такие роли, как "Owner", не предоставляют необходимые разрешения).

Для получения дополнительной информации о том, как создать заявку Azure AD, ознакомьтесь с этим руководством.

Используя среды Node.js и node-like, можно использовать класс DefaultAzureCredential для проверки подлинности клиента.

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

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

Для сред браузера используйте InteractiveBrowserCredential из пакета @azure/identity для проверки подлинности.

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);

Пакет JavaScript

Чтобы использовать эту клиентную библиотеку в браузере, сначала необходимо использовать пакет. Дополнительные сведения о том, как это сделать, см. в нашей документации по .

Ключевые понятия

ManagementGroupsAPI

ManagementGroupsAPI является основным интерфейсом для разработчиков, использующих клиентскую библиотеку Azure ManagementGroupsAPI. Изучите методы на этом клиентском объекте, чтобы понять различные функции сервиса Azure ManagementGroupsAPI, к которым вы можете получить доступ.

Troubleshooting

Logging

Включение ведения журнала может помочь выявить полезные сведения о сбоях. Чтобы просмотреть журнал HTTP-запросов и ответов, задайте для переменной среды AZURE_LOG_LEVEL значение info. В альтернативном порядке, логирование можно включить во время выполнения, вызвав setLogLevel в @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Дополнительные инструкции по включению журналов см. в документации по пакету @azure/loger.

Дальнейшие действия

Ознакомьтесь с примерами каталога, чтобы получить подробные примеры использования этой библиотеки.

Contributing

Если вы хотите внести свой вклад в эту библиотеку, ознакомьтесь с руководством по вкладу, чтобы узнать больше о том, как создавать и тестировать код.