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

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

Используйте эти API для создания ресурсов расширения через ARM для кластеров Kubernetes.

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

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

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

Подробнее смотрите нашу политику support для получения дополнительной информации.

Необходимые условия

  • Подписка Azure.

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

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

npm install @azure/arm-kubernetesconfiguration-extensions

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

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

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

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

npm install @azure/identity

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

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

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

import { ExtensionsClient } from "@azure/arm-kubernetesconfiguration-extensions";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ExtensionsClient(new DefaultAzureCredential(), subscriptionId);

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { ExtensionsClient } from "@azure/arm-kubernetesconfiguration-extensions";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ExtensionsClient(credential, subscriptionId);

Пакет JavaScript

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

Основные понятия

РасширенияКлиент

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

Troubleshooting

Logging

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

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

setLogLevel("info");

Для более подробных инструкций по включению логов вы можете посмотреть документы пакета @azure/logger.

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

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

Contributing

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