Azure Batch client library for JavaScript - versie 13.0.0

Dit pakket bevat een isomorfe SDK (draait zowel in Node.js als in browsers) voor de Azure Batch-client.

Azure Batch biedt taakplanning en rekenbeheer in de cloud.

Aan de slag

Momenteel ondersteunde omgevingen

Zie ons supportbeleid voor meer details.

Prerequisites

Het @azure/batch-pakket installeren

Installeer de Azure Batch-clientbibliotheek voor JavaScript met npm:

npm install @azure/batch

Een BatchClient maken en verifiëren

Om een clientobject te maken dat toegang krijgt tot de Azure Batch API, heb je de endpoint van je Azure Batch-resource en een credential. De Azure Batch-client kan Azure Active Directory-credentials gebruiken om te authenticeren. Je kunt het eindpunt voor je Azure Batch-resource vinden in de Azure Portal.

Azure Batch ondersteunt verificatie via Microsoft Entra-id of gedeelde sleutel.

Microsoft Entra ID

Je kunt authenticeren met Azure Entra ID met een credential uit de @azure/identity-bibliotheek of een bestaande AAD-token.

Om de hieronder getoonde DefaultAzureCredential provider te gebruiken, of andere inlogproviders die bij de Azure SDK zijn geleverd, installeer dan het pakket @azure/identity:

npm install @azure/identity

Je moet ook een nieuwe AAD-applicatie registreren en toegang verlenen aan Azure Batch door de geschikte rol toe te wijzen aan je diensthoofd (let op: rollen zoals "Owner" geven niet de benodigde rechten).

Voor meer informatie over hoe je een Azure AD-applicatie maakt, kijk dan op deze gids.

Met Node.js- en Node-achtige omgevingen kunt u de DefaultAzureCredential-klasse gebruiken om de client te verifiëren.

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

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

Voor browseromgevingen gebruik je de InteractiveBrowserCredential uit het @azure/identity-pakket om te authenticeren.

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

Gedeelde sleutel

Om gedeelde sleutel te gebruiken om te authenticeren, moet je eerst npm installeren @azure/core-authen vervolgens de accountnaam en accountsleutel opgeven om een AzureNamedKeyCredential inloggegevens te construeren van @azure/core-auth.

Opgemerkt dat Share Key-authenticatie alleen wordt ondersteund in Node.js- en Node-achtige omgevingen.

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-bundel

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundelaar gebruiken. Raadpleeg onze bundeldocumentatie voor meer informatie over hoe u dit doet.

belangrijke concepten

BatchClient

BatchClient is de primaire interface voor ontwikkelaars die de Azure Batch-clientbibliotheek gebruiken. Verken de methoden op dit clientobject om de verschillende functies van de Azure Batch-service te begrijpen waar je toegang toe hebt.

Troubleshooting

Logging

Het inschakelen van logboekregistratie kan helpen nuttige informatie over fouten te ontdekken. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de omgevingsvariabele AZURE_LOG_LEVEL in op info. U kunt logboekregistratie ook tijdens runtime inschakelen door setLogLevel aan te roepen in de @azure/logger:

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

setLogLevel("info");

Voor meer gedetailleerde instructies over het inschakelen van logboeken, kunt u de @azure/logger pakketdocumentenbekijken.

Contributing

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de gids voor bijdragen voor meer informatie over het bouwen en testen van de code.

  • Last updated on