Azure Batch client library for JavaScript - version 13.0.0

Ten pakiet zawiera izomorficzne SDK (działające zarówno w Node.js, jak i w przeglądarkach) dla klienta Azure Batch.

Usługa Azure Batch zapewnia planowanie zadań w skali chmury i zarządzanie obliczeniami.

Rozpoczęcie pracy

Obecnie obsługiwane środowiska

  • Wersje LTS systemu Node.js
  • Najnowsze wersje przeglądarek Safari, Chrome, Edge i Firefox.

Zobacz naszą politykę support po więcej szczegółów.

Wymagania wstępne

Instalowanie pakietu @azure/batch

Zainstaluj bibliotekę klienta Azure Batch dla JavaScript za pomocą npm:

npm install @azure/batch

Twórz i uwierzytelnij BatchClient

Aby utworzyć obiekt klienta do dostępu do Azure Batch API, będziesz potrzebować swojego endpoint zasobu Azure Batch oraz .credential Klient Azure Batch może używać poświadczeń Azure Active Directory do uwierzytelniania. Punkt końcowy dla swojego zasobu Azure Batch znajdziesz w Azure Portal.

Usługa Azure Batch obsługuje uwierzytelnianie za pośrednictwem identyfikatora Entra firmy Microsoft lub klucza współużytkowanego.

Microsoft Entra ID

Możesz uwierzytelnić się za pomocą Azure Entra ID, korzystając z poświadczenia z biblioteki @azure/identity lub istniejącego tokena AAD.

Aby korzystać z dostawcy DefaultAzureCredential pokazanego poniżej lub innych dostawców poświadczonych w Azure SDK, prosimy o zainstalowanie pakietu @azure/identity:

npm install @azure/identity

Będziesz także musiał zarejestrować nową aplikację AAD i przydzielić dostęp do Azure Batch , przypisując odpowiednią rolę swojemu podmiotowi usługowemu (uwaga: role takie jak A. "Owner" nie przyznają niezbędnych uprawnień).

Aby dowiedzieć się więcej o tym, jak stworzyć aplikację Azure AD, sprawdź ten przewodnik.

Korzystając ze środowisk Node.js i środowisk podobnych do węzłów, możesz użyć klasy DefaultAzureCredential do uwierzytelniania klienta.

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

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

W środowiskach przeglądarkowych użyj InteractiveBrowserCredential z pakietu @azure/identity do uwierzytelnienia.

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

Klucz wspólny

Aby użyć wspólnego klucza do uwierzytelnienia, najpierw npm trzeba zainstalować @azure/core-auth, a następnie podać nazwę konta i klucz konta, aby zbudować poświadczenie AzureNamedKeyCredential z .@azure/core-auth

Zauważony, że uwierzytelnianie kluczem udostępniania jest obsługiwane tylko w środowiskach Node.js i podobnych do 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);

Pakiet JavaScript

Aby użyć tej biblioteki klienta w przeglądarce, najpierw należy użyć pakietu. Aby uzyskać szczegółowe informacje o tym, jak to zrobić, zapoznaj się z naszą dokumentacją dotyczącą tworzenia pakietów .

Kluczowe pojęcia

BatchClient

BatchClient jest głównym interfejsem dla programistów korzystających z biblioteki klienta Azure Batch. Poznaj metody tego obiektu klienta, aby zrozumieć różne funkcje usługi Azure Batch, do których masz dostęp.

Troubleshooting

Logging

Włączenie rejestrowania może pomóc odkryć przydatne informacje o błędach. Aby wyświetlić dziennik żądań i odpowiedzi HTTP, ustaw zmienną środowiskową AZURE_LOG_LEVEL na info. Alternatywnie rejestrowanie można włączyć w czasie wykonywania, wywołując setLogLevel w @azure/logger:

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

setLogLevel("info");

Aby uzyskać bardziej szczegółowe instrukcje dotyczące włączania dzienników, zapoznaj się z dokumentacją pakietu @azure/logger.

Contributing

Jeśli chcesz współtworzyć tę bibliotekę, przeczytaj przewodnik dotyczący współtworzenia , aby dowiedzieć się więcej na temat tworzenia i testowania kodu.

  • Last updated on