Azure Batch client library for JavaScript - version 13.0.0

Este paquete contiene un SDK isomorfo (que se ejecuta tanto en Node.js como en navegadores) para el cliente Azure Batch.

Azure Batch proporciona programación de trabajos a escala en la nube y administración de procesos.

Cómo empezar

Entornos admitidos actualmente

Consulta nuestra política soporte para más detalles.

Prerequisites

Instalación del paquete @azure/batch

Instala la biblioteca cliente Azure Batch para JavaScript con npm:

npm install @azure/batch

Creación y autenticación de un BatchClient

Para crear un objeto cliente que acceda a la API Batch de Azure, necesitarás el endpoint de tu recurso Azure Batch y un credentialarchivo . El cliente Batch de Azure puede usar credenciales de Azure Active Directory para autenticarse. Puedes encontrar el endpoint para tu recurso Azure Batch en el Azure Portal.

Azure Batch admite la autenticación a través de Microsoft Entra ID o clave compartida.

Microsoft Entra ID

Puedes autenticarte con Azure Entra ID usando una credencial de la biblioteca @azure/identidad o un token AAD existente.

Para utilizar el proveedor DefaultAzureCredential que se muestra a continuación, u otros proveedores de credenciales proporcionados con el SDK de Azure, por favor instale el paquete @azure/identity:

npm install @azure/identity

También tendrás que registrar una nueva aplicación AAD y conceder acceso a Azure Batch asignando el rol adecuado a tu principal de servicio (nota: roles como este "Owner" no concederán los permisos necesarios).

Para más información sobre cómo crear una aplicación de AD Azure, consulta esta guía.

Con Node.js y entornos similares a nodos, puede usar la clase DefaultAzureCredential para autenticar al cliente.

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

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

Para entornos de navegador, utiliza el InteractiveBrowserCredential del paquete @azure/identity para autenticarte.

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

Clave compartida

Para usar la clave compartida para autenticarse, primero npm debes instalar @azure/core-auth, luego proporcionar el nombre de la cuenta y la clave de cuenta para construir una AzureNamedKeyCredential credencial a partir @azure/core-authde .

Señala que la autenticación por clave de compartir solo es compatible con entornos Node.js y similares a Nodes.

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

Paquete de JavaScript

Para usar esta biblioteca cliente en el explorador, primero debe usar un agrupador. Para obtener más información sobre cómo hacerlo, consulte nuestra documentación de agrupación de .

Conceptos clave

BatchClient

BatchClient es la interfaz principal para los desarrolladores que utilizan la biblioteca cliente Azure Batch. Explora los métodos en este objeto cliente para entender las diferentes características del servicio Batch de Azure a las que puedes acceder.

Solución de problemas

Registro

Habilitar el registro puede ayudar a descubrir información útil sobre errores. Para ver un registro de solicitudes y respuestas HTTP, establezca la variable de entorno AZURE_LOG_LEVEL en info. Como alternativa, el registro se puede habilitar en tiempo de ejecución llamando a setLogLevel en el @azure/logger:

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

setLogLevel("info");

Para obtener instrucciones más detalladas sobre cómo habilitar los registros, puede consultar los documentos del paquete de @azure/registrador.

Contributing

Si desea contribuir a esta biblioteca, lea la guía de contribución de para obtener más información sobre cómo compilar y probar el código.

  • Last updated on