Azure KustoManagement client library for JavaScript - wersja 9.0.0

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

API zarządzania Azure Kusto zapewnia zestaw usług RESTful, które współdziałają z usługami Azure Kusto w celu zarządzania klastrami i bazami danych. API umożliwia tworzenie, aktualizację i usuwanie klastrów oraz baz danych.

Kluczowe linki:

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/arm-kusto

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

npm install @azure/arm-kusto

Twórz i uwierzytelnij KustoManagementClient

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

Możesz uwierzytelnić się Azure Active Directory używając 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 przyznać dostęp do Azure KustoManagement, przypisując odpowiednią rolę swojemu podmiotowi usługowemu (uwaga: role takie jak nie "Owner" przydzielą 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 { KustoManagementClient } from "@azure/arm-kusto";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new KustoManagementClient(new DefaultAzureCredential(), subscriptionId);

W przypadku środowisk przeglądarki użyj InteractiveBrowserCredential z pakietu @azure/identity do uwierzytelniania.

import { InteractiveBrowserCredential } from "@azure/identity";
import { KustoManagementClient } from "@azure/arm-kusto";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new KustoManagementClient(credential, subscriptionId);

Pakiet JavaScript

Aby użyć tej biblioteki klienta w przeglądarce, najpierw należy użyć pakietu. Aby uzyskać szczegółowe informacje na temat tego, jak to zrobić, zapoznaj się z naszą dokumentacją dotyczącą sprzedaży wiązanej.

Kluczowe pojęcia

KustoManagementClient

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

Troubleshooting

Wyrąb

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.

Następne kroki

Proszę zajrzyj do katalogu samples, gdzie znajdziesz szczegółowe przykłady korzystania z tej biblioteki.

Contributing

Jeśli chcesz przyczynić się do tej biblioteki, przeczytaj przewodnik wkład aby dowiedzieć się więcej o budowaniu i testowaniu kodu.