пакетная служба Azure client library for JavaScript - version 13.0.0

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

Пакетная служба Azure обеспечивает планирование и управление вычислительными ресурсами в облаке.

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

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

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

Предпосылки

Установите пакет @azure/batch.

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

npm install @azure/batch

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

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

Пакет Azure поддерживает проверку подлинности с помощью идентификатора Microsoft Entra или общего ключа.

Майкрософт Ентра айди

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

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

npm install @azure/identity

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

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

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

import { BatchClient } from "@azure/batch";
import { DefaultAzureCredential } from "@azure/identity";

const client = new BatchClient("<endpoint>", new DefaultAzureCredential());

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { BatchClient } from "@azure/batch";

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

Общий ключ

Чтобы использовать общий ключ для аутентификации, сначала npm нужно установить @azure/core-auth, затем ввести имя аккаунта и ключ аккаунта, чтобы построить AzureNamedKeyCredential учетные данные из @azure/core-auth.

Отмечено, что аутентификация Share Key поддерживается только в Node.js и Node-подобных средах.

import { AzureNamedKeyCredential } from "@azure/core-auth";
import { BatchClient } from "@azure/batch";

const credential = new AzureNamedKeyCredential("<account name>", "<account key>");
const client = new BatchClient("<endpoint>", credential);

Пакет JavaScript

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

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

BatchClient

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

Troubleshooting

Logging

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

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

setLogLevel("info");

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

Contributing

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