Azure Batch client library for JavaScript - version 13.0.0

此套件包含一個同構的 SDK(可在 Node.js 與瀏覽器中執行)用於 Azure Batch 用戶端。

Azure Batch 提供雲端規模作業排程和計算管理。

入門指南

目前支援的環境

如需詳細資訊,請參閱我們的支援原則

先決條件

安裝 @azure/batch 套件

安裝 JavaScript 的 Azure Batch 用戶端函式庫,使用:npm

npm install @azure/batch

建立和驗證 BatchClient

要建立客戶端物件以存取 Azure Batch API,你需要 Azure Batch 資源的 endpointcredential 。 Azure Batch 用戶端可以使用 Azure Active Directory 憑證來驗證。 你可以在 Azure 入口網站 找到 Azure Batch 資源的端點。

Azure 批次支援透過 Microsoft Entra ID 或共用密鑰進行驗證。

Microsoft Entra ID

你可以用 @azure/身份 函式庫的憑證或 現有的 AAD 令牌來使用 Azure Entra ID 進行認證。

若要使用下方所示的 DefaultAzureCredential 提供者,或Azure SDK附帶的其他憑證提供者,請安裝 @azure/identity 套件:

npm install @azure/identity

你還需要 註冊一個新的 AAD 應用程式,並透過 指派適當的角色給你的服務主體來授權 Azure Batch 的存取權(注意:這類 "Owner" 角色不會授予必要的權限)。

想了解更多如何建立 Azure AD 應用程式的資訊,請參考 此指南

使用 Node.js 和類似節點的環境,您可以使用 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

注意共享金鑰認證僅支援於 Node.js 及類節點環境。

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 套件組合

若要在瀏覽器中使用此用戶端連結庫,您必須先使用配套程式。 如需如何執行這項操作的詳細資訊,請參閱我們的 組合檔

關鍵概念

批次用戶端

BatchClient 是開發者使用 Azure Batch 用戶端函式庫的主要介面。 探索此客戶端物件上的方法,以了解您可以存取的 Azure 批次服務的不同功能。

Troubleshooting

伐木

啟用記錄可能有助於找出有關失敗的實用資訊。 若要查看 HTTP 要求和回應的記錄,請將 AZURE_LOG_LEVEL 環境變數設定為 info。 或者,您可以在運行時間啟用記錄,方法是在 setLogLevel中呼叫 @azure/logger

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

setLogLevel("info");

如需如何啟用記錄的詳細指示,請參閱@azure/記錄器套件檔。

Contributing

如果您想要參與此連結庫,請閱讀 參與指南,以深入瞭解如何建置和測試程序代碼。

  • Microsoft JavaScript