Azure Batch client library for JavaScript - version 13.0.0

Questo pacchetto contiene un SDK isomorfo (che funziona sia in Node.js che nei browser) per il client batch di Azure.

Azure Batch offre la pianificazione e la gestione dei processi su scala cloud.

Come iniziare

Ambienti attualmente supportati

Consulta la nostra politica support per maggiori dettagli.

Prerequisiti

Installare il pacchetto @azure/batch

Installa la libreria client Azure Batch per JavaScript con npm:

npm install @azure/batch

Creare ed autenticare un BatchClient

Per creare un oggetto client per accedere all'API batch di Azure, avrai bisogno della endpoint tua risorsa batch Azure e di un credentialfile . Il client Azure Batch può utilizzare le credenziali Azure Active Directory per autenticarsi. Puoi trovare l'endpoint per la tua risorsa Azure Batch nel portale Azure.

Azure Batch supporta l'autenticazione tramite Microsoft Entra ID o Chiave condivisa.

Microsoft Entra ID

Puoi autenticarti con Azure Entra ID usando una credenziale dalla libreria @azure/identity o un token AAD esistente.

Per utilizzare il provider DefaultAzureCredential mostrato qui sotto, o altri fornitori di credenziali forniti con il Azure SDK, si prega di installare il pacchetto @azure/identity:

npm install @azure/identity

Dovrai anche registrare una nuova applicazione AAD e concedere l'accesso ad Azure Batch assegnando il ruolo appropriato al tuo responsabile di servizio (nota: ruoli come "Owner" non concederanno i permessi necessari).

Per maggiori informazioni su come creare una Azure applicazione AD, consulta questa guida.

Usando Node.js e ambienti simili a Node, è possibile usare la classe DefaultAzureCredential per autenticare il client.

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

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

Per gli ambienti browser, usa il InteractiveBrowserCredential dal pacchetto @azure/identity per autenticarti.

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

Chiave condivisa

Per usare la chiave condivisa per autenticarsi, devi prima npm installare @azure/core-auth, poi fornire il nome dell'account e la chiave dell'account per costruire una AzureNamedKeyCredential credenziale da @azure/core-auth.

È stato notato che l'autenticazione della Share Key è supportata solo in ambienti Node.js e simili a 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);

Pacchetto JavaScript

Per usare questa libreria client nel browser, è prima necessario usare un bundler. Per informazioni dettagliate su come eseguire questa operazione, vedere la documentazione di creazione di bundle .

Concetti chiave

BatchClient

BatchClient è l'interfaccia principale per gli sviluppatori che utilizzano la libreria client Azure Batch. Esplora i metodi su questo oggetto client per comprendere le diverse funzionalità del servizio batch Azure a cui puoi accedere.

Risoluzione dei problemi

Logging

L'abilitazione della registrazione può aiutare a individuare informazioni utili sugli errori. Per visualizzare un log di richieste e risposte HTTP, impostare la variabile di ambiente AZURE_LOG_LEVEL su info. In alternativa, la registrazione può essere abilitata in fase di esecuzione chiamando setLogLevel nel @azure/logger:

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

setLogLevel("info");

Per istruzioni più dettagliate su come abilitare i log, è possibile esaminare la documentazione del pacchetto @azure/logger.

Contributing

Per contribuire a questa libreria, leggere la guida contribuire per altre informazioni su come compilare e testare il codice.

  • Last updated on