Azure KustoManagement client library for JavaScript - version 9.0.0

Tento balíček obsahuje izomorfní SDK (běží jak v Node.js, tak v prohlížečích) pro klienta Azure KustoManagement.

Azure Kusto management API poskytuje RESTful sadu webových služeb, které komunikují se službami Azure Kusto pro správu vašich clusterů a databází. API vám umožňuje vytvářet, aktualizovat a mazat clustery a databáze.

Klíčové odkazy:

Začínáme

Aktuálně podporovaná prostředí

Další podrobnosti najdete v zásadách podpory.

Předpoklady

  • Předplatné služby Azure.

Nainstalujte balíček @azure/arm-kusto.

Nainstalujte klientskou knihovnu Azure KustoManagement pro JavaScript s npm:

npm install @azure/arm-kusto

Vytvořte a ověřte KustoManagementClient

Pro vytvoření klientského objektu pro přístup k Azure KustoManagement API budete potřebovat svůj endpoint Azure KustoManagement zdroj a .credential Klient Azure KustoManagement může použít přihlašovací údaje Azure Active Directory k autentizaci. Endpoint pro váš Azure KustoManagement zdroj najdete v Azure Portal.

Můžete se autentizovat pomocí Azure Active Directory pomocí přihlašovacích údajů z knihovny @azure/identity nebo existujícího AAD tokenu.

Pro použití poskytovatele DefaultAzureCredential uvedeného níže nebo jiných poskytovatelů přihlašovacích údajů přiložených k Azure SDK, prosím nainstalujte balíček @azure/identity:

npm install @azure/identity

Budete také muset zaregistrovat novou AAD aplikaci a udělit přístup k Azure KustoManagement přiřazením vhodné role vašemu principálu služby (poznámka: role jako například neudělí "Owner" potřebná oprávnění).

Pro více informací o tom, jak vytvořit Azure AD aplikaci, navštivte tento průvodce.

Pomocí Node.js a prostředí podobných uzlům můžete k ověření klienta použít třídu DefaultAzureCredential.

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

Pro prostředí prohlížeče použijte k ověření InteractiveBrowserCredential z balíčku @azure/identity.

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

JavaScriptový balíček

Pokud chcete tuto klientskou knihovnu použít v prohlížeči, musíte nejprve použít bundler. Podrobnosti o tom, jak to provést, naleznete v naší dokumentaci ke sdružování.

Klíčové koncepty

KustoManagementClient

KustoManagementClientje hlavní rozhraní pro vývojáře využívající klientskou knihovnu Azure KustoManagement. Prozkoumejte metody na tomto klientském objektu, abyste pochopili různé funkce služby Azure KustoManagement, ke kterým máte přístup.

Troubleshooting

Protokolování

Povolení protokolování může pomoct odhalit užitečné informace o chybách. Pokud chcete zobrazit protokol požadavků a odpovědí HTTP, nastavte proměnnou prostředí AZURE_LOG_LEVEL na info. Případně můžete protokolování povolit za běhu voláním setLogLevel v @azure/logger:

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

setLogLevel("info");

Podrobnější pokyny k povolení protokolů najdete v dokumentaci k @azure/protokolovacímu balíčku.

Další kroky

Podívejte se prosím do adresáře samples pro podrobné příklady, jak tuto knihovnu používat.

Contributing

Pokud byste chtěli přispět do této knihovny, přečtěte si prosím průvodce přispívání kde se dozvíte více o tom, jak kód sestavit a testovat.

  • Last updated on