Azure Batch Client Library for JavaScript - Version 13.0.0

Dieses Paket enthält ein isomorphes SDK (läuft sowohl in Node.js als auch in Browsern) für den Azure-Batch-Client.

Azure Batch bietet cloudweite Auftragsplanung und Computeverwaltung.

Erste Schritte

Derzeit unterstützte Umgebungen

Weitere Details finden Sie in unserer Support-Richtlinie.

Voraussetzungen

Installieren Sie das @azure/batch-Paket

Installiere die Azure Batch Client-Bibliothek für JavaScript mit npm:

npm install @azure/batch

Erstellen und Authentifizieren einer BatchClient

Um ein Client-Objekt zu erstellen, das auf die Azure Batch API zugriff, benötigen Sie die endpoint von Ihrer Azure Batch-Ressource und eine credential. Der Azure Batch-Client kann Azure Active Directory Anmeldedaten zur Authentifizierung verwenden. Den Endpunkt für deine Azure Batch-Ressource findest du im Azure-Portal.

Azure-Batch unterstützt die Authentifizierung entweder über die Microsoft Entra-ID oder den freigegebenen Schlüssel.

Microsoft Entra ID

Sie können sich mit Azure Entra-ID authentifizieren, indem Sie eine Zugangsdaten aus der @azure-/Identitätsbibliothek oder ein bestehendes AAD-Token verwenden.

Um den unten gezeigten Anbieter DefaultAzureCredential oder andere mit dem Azure SDK bereitgestellte Zugangsdatenanbieter zu verwenden, installieren Sie bitte das @azure/identity-Paket:

npm install @azure/identity

Sie müssen außerdem eine neue AAD-Anwendung registrieren und Zugang zu Azure Batch gewähren , indem Sie die geeignete Rolle Ihrem Service Principal zuweisen (Hinweis: Rollen wie "Owner" diese gewähren nicht die erforderlichen Berechtigungen).

Für weitere Informationen darüber, wie man eine Azure AD-Anwendung erstellt, siehe diesen Leitfaden.

Mithilfe von Node.js- und Node-ähnlichen Umgebungen können Sie die DefaultAzureCredential Klasse verwenden, um den Client zu authentifizieren.

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

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

Für Browserumgebungen verwenden Sie zur Authentifizierung das InteractiveBrowserCredential aus dem @azure/identity-Paket.

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

Freigegebener Schlüssel

Um den gemeinsamen Schlüssel zur Authentifizierung zu verwenden, müssen Sie zunächst npm installieren @azure/core-authund dann den Kontonamen und den Kontoschlüssel angeben, um daraus eine AzureNamedKeyCredential Zugangsdaten @azure/core-authzu erstellen.

Es wurde angemerkt, dass die Authentifizierung des Freigabeschlüssels nur in Node.js- und Node-ähnlichen Umgebungen unterstützt wird.

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-Bündel

Um diese Clientbibliothek im Browser zu verwenden, müssen Sie zuerst einen Bundler verwenden. Für Details dazu, wie to do wird, siehe bitte unsere bündelnde Dokumentation.

Wichtige Konzepte

BatchClient

BatchClient ist die primäre Schnittstelle für Entwickler, die die Azure Batch-Client-Bibliothek verwenden. Erkunden Sie die Methoden dieses Client-Objekts, um die verschiedenen Funktionen des Azure Batch-Dienstes zu verstehen, auf die Sie zugreifen können.

Problembehandlung

Protokollierung

Das Aktivieren der Protokollierung kann hilfreiche Informationen zu Fehlern aufdecken. Um ein Protokoll von HTTP-Anforderungen und -Antworten anzuzeigen, legen Sie die AZURE_LOG_LEVEL Umgebungsvariable auf infofest. Alternativ kann die Protokollierung zur Laufzeit durch Aufrufen von setLogLevel im @azure/loggeraktiviert werden:

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

setLogLevel("info");

Ausführlichere Anweisungen zum Aktivieren von Protokollen finden Sie in den @azure/Logger-Paketdokumenten.

Contributing

Wenn Sie an dieser Bibliothek mitwirken möchten, lesen Sie bitte den mitwirkenden Leitfaden, um mehr über das Erstellen und Testen des Codes zu erfahren.

  • Last updated on