Azure KustoManagement client library for JavaScript - versione 9.0.0

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

L'API di gestione Azure Kusto fornisce un insieme RESTful di servizi web che interagiscono con i servizi Azure Kusto per gestire i tuoi cluster e database. L'API ti consente di creare, aggiornare ed eliminare cluster e database.

Collegamenti chiave:

Come iniziare

Ambienti attualmente supportati

Per altri dettagli, vedere i criteri di supporto .

Prerequisiti

Installare il pacchetto @azure/arm-kusto

Installa la libreria client Azure KustoManagement per JavaScript con npm:

npm install @azure/arm-kusto

Creare ed autenticare un KustoManagementClient

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

È possibile eseguire l'autenticazione con Azure Active Directory usando credenziali dalla libreria di di @azure/identità o un token AAD esistente.

Per usare il provider DefaultAzureCredential illustrato di seguito o altri provider di credenziali forniti con Azure SDK, installare il pacchetto :

npm install @azure/identity

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

Per altre informazioni su come creare un'applicazione Azure AD, vedere questa guida.

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

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

Per gli ambienti del browser, usare il InteractiveBrowserCredential dal pacchetto di @azure/identity per l'autenticazione.

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

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

KustoManagementClient

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

Troubleshooting

Registrazione

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.

Passaggi successivi

Per esempi dettagliati su come usare questa libreria, vedere gli esempi di directory.

Contribuire

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

  • Last updated on