# @azure/batch 中文文档

规范地址：https://npmcn.com/package/%40azure/batch/

版本：13\.0\.0
npm 元数据更新时间：2026-05-08T00:31:36.703Z
中文译文更新时间：2026-11-07T14:01:41.178Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40azure/batch
原文对照：https://npmcn.com/package/%40azure/batch/?lang=original
项目主页：https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/batch/batch/README.md
源码仓库：https://github.com/Azure/azure-sdk-for-js

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：7.4 MB，200 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：8 个
- 首次发布：2018-11-14T17:57:05.589Z
- 最新版本发布：2026-05-08T00:31:36.482Z
- 近 30 天下载量：38107（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 3 个）

## 中文简介

JavaScript 的 Azure 批量客户端库

## 安装

```sh
npm install @azure/batch
```

也可以使用：`pnpm add @azure/batch`、`yarn add @azure/batch`、`bun add @azure/batch`

## README

# JavaScript 的 Azure 批量客户端库

此软件包包含一个Azure Batch客户端的同位素 SDK(运行于Node.js和浏览器).

Azure Batch提供Cloud比例的工作时间安排和计算管理.

## 开始

### 目前得到支持的环境

-   [节点.js的LTS版本](https://github.com/nodejs/release#release-schedule)
-   最新版本有"萨法里","克罗姆","边缘"和"火狐"等.

看我们的 [支助政策](https://github.com/Azure/azure-sdk-for-js/blob/main/SUPPORT.md) 更多细节.

### 先决条件

-   一个 [Azure 订阅](https://azure.microsoft.com/free/)。 。 。 .

### 安装 `@azure/batch` 软件包

为 JavaScript 安装 Azure 批量客户端库 `npm`数字 :

```bash
npm install @azure/batch
```

### 创建和认证 a `BatchClient`

要创建访问 Azure 批量 API 的客户端对象, 您需要 `endpoint` 您的 Azure 批量资源 `credential`. Azure Batch 客户端可以使用 Azure Active 目录证书进行认证. 您可以在 [Azure 门户](https://portal.azure.com/)。 。 。 .

Azure批次支持通过Microsoft Entra ID或共享密钥进行认证.

-   [微软 Entra ID](https://npmcn.com/package/%40azure/batch/#readme-microsoft-entra-id)
-   [共享密钥](https://npmcn.com/package/%40azure/batch/#readme-shared-key)

#### 微软 Entra ID

您可以使用来自 [@azure/身份](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity) 库或 [已存在的 AAD 键](https://github.com/Azure/azure-sdk-for-js/blob/master/sdk/identity/identity/samples/AzureIdentityExamples.md#authenticating-with-a-pre-fetched-access-token)。 。 。 .

用来使用 [默认标记](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#defaultazurecredential) 下面显示的提供者,或提供Azure SDK的其他证书提供者,请安装 `@azure/identity` 软件包 :

```bash
npm install @azure/identity
```

你还需要 **注册新的 AAD 应用程序并批准访问 Azure 批次** 指定服务负责人发挥适当作用(说明: `"Owner"` 将不给予必要的许可).

有关如何创建 Azure AD 应用程序的更多信息请检查退出 [本指南](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal)。 。 。 .

使用节点和类似节点的环境,可以使用 `DefaultAzureCredential` 类来认证客户端.

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

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

对于浏览器环境,请使用 `InteractiveBrowserCredential` 从 `@azure/identity` 要认证的软件包.

```ts
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`](https://www.npmjs.com/package/@azure/core-auth),然后提供用于构建一个 `AzureNamedKeyCredential` 证书来源 `@azure/core-auth`。 。 。 .

注意到Share Key认证仅在Node.js和类似Node的环境得到支持.

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

### Java 脚本套装

要在浏览器中使用此客户端库,首先需要使用捆绑器. 关于如何做到这一点的详情,请参见我们 [捆绑文件](https://aka.ms/AzureSDKBundling)。 。 。 .

## 关键概念

### 批量连接

`BatchClient` 是开发者使用 Azure Batch 客户端库的主要接口。 探索此客户端上的方法对象,以了解Azure Batch服务中您可以访问的不同特性.

## 解决问题

### 日志

允许伐木可能有助于发现有关失败的有用信息。 为了查看 HTTP 请求和回复的日志,设置 `AZURE_LOG_LEVEL` 环境变量改为 `info`。或者,可以在运行时拨打 `setLogLevel` 输入 `@azure/logger`数字 :

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

setLogLevel("info");
```

关于如何启用日志的更详细指示,您可以查看 [@ azure/ logger 包文件](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/core/logger)。 。 。 .

## 捐款

如果您想为图书馆捐钱 请读一下 [贡献指南](https://github.com/Azure/azure-sdk-for-js/blob/main/CONTRIBUTING.md) 学习如何构建和测试密码.

## 相关项目

-   [微软 Azure SDK 用于 JavaScript](https://github.com/Azure/azure-sdk-for-js)

## 常见问题

### @azure/batch 是什么？

JavaScript 的 Azure 批量客户端库

### 如何安装 @azure/batch？

在项目目录运行 npm install @azure/batch，或使用 pnpm add / yarn add / bun add。

### @azure/batch 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @azure/batch 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @azure/batch 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @azure/batch 可以商用吗？

@azure/batch 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @azure/batch 的下载量有多少？

根据 npm 官方下载统计，@azure/batch 在 2026/10/08 – 2026/11/06 这 30 天内被下载 38,107 次，日均约 1,270 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @azure/batch 还在维护吗？

最新版本 13\.0\.0 发布于 2026/05/08（6 个月前）；至今共发布 17 个版本，其中过去 12 个月发布了 3 个；首次发布于 2018/11/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。