Azure KustoManagement ügyfélkódtár JavaScripthez – 8.2.0-s verzió

Ez a csomag egy izomorf SDK-t tartalmaz (Node.js és böngészőkben is fut) az Azure KustoManagement-ügyfélhez.

Az Azure Kusto felügyeleti API reSTful webszolgáltatásokat biztosít, amelyek az Azure Kusto-szolgáltatásokkal együttműködve kezelik a fürtöket és az adatbázisokat. Az API lehetővé teszi fürtök és adatbázisok létrehozását, frissítését és törlését.

forráskód | csomag (NPM) | API-referenciadokumentáció | minták

Kezdetekhez

Jelenleg támogatott környezetek

• Node.js LTS-verziói
• A Safari, a Chrome, az Edge és a Firefox legújabb verziói.

További részletekért tekintse meg a támogatási szabályzat.

Előfeltételek

• Egy Azure-előfizetés.

A @azure/arm-kusto csomag telepítése

Telepítse a JavaScripthez készült Azure KustoManagement ügyfélkódtárat a npm:

npm install @azure/arm-kusto

KustoManagementClient létrehozása és hitelesítése

Az Azure KustoManagement API eléréséhez ügyfélobjektum létrehozásához szüksége lesz az Azure KustoManagement-erőforrás endpoint és egy credential. Az Azure KustoManagement-ügyfél az Azure Active Directory hitelesítő adatait használhatja a hitelesítéshez. Az Azure KustoManagement-erőforrás végpontját az Azure Portal találja.

Az Azure Active Directoryval hitelesítést végezhet a @azure/identitáskódtárból származó hitelesítő adatokkal, vagy egy meglévő AAD-jogkivonat .

Az alább látható DefaultAzureCredential szolgáltató vagy az Azure SDK-hoz biztosított egyéb hitelesítő adatok szolgáltatójának használatához telepítse a @azure/identity csomagot:

npm install @azure/identity

Emellett új AAD-alkalmazást kell regisztrálnia és hozzáférést kell adnia az Azure KustoManagement, ha a megfelelő szerepkört rendeli hozzá a szolgáltatásnévhez (megjegyzés: az olyan szerepkörök, mint például a "Owner" nem biztosítják a szükséges engedélyeket).

Az Azure AD-alkalmazások létrehozásáról az útmutató .

const { KustoManagementClient } = require("@azure/arm-kusto");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

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

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new KustoManagementClient(credential, subscriptionId);

JavaScript-csomag

Ahhoz, hogy ezt az ügyfélkódtárat a böngészőben használhassa, először egy kötegelőt kell használnia. Ennek módjáról további információt a csomagküldő dokumentációbantalál.

Főbb fogalmak

KustoManagementClient

KustoManagementClient az Azure KustoManagement ügyfélkódtárat használó fejlesztők elsődleges felülete. Az ügyfélobjektum metódusainak megismerése az Azure KustoManagement szolgáltatás különböző funkcióinak megismeréséhez.

Hibaelhárítás

Fakitermelés

A naplózás engedélyezése segíthet a hibákról szóló hasznos információk feltárásában. A HTTP-kérések és válaszok naplójának megtekintéséhez állítsa a AZURE_LOG_LEVEL környezeti változót info. Másik lehetőségként a naplózás futásidőben is engedélyezhető a setLogLevel meghívásával a @azure/logger:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

A naplók engedélyezésére vonatkozó részletesebb útmutatásért tekintse meg a @azure/logger csomag dokumentációit.

Következő lépések

A kódtár használatára vonatkozó részletes példákért tekintse meg a mintákat könyvtárat.

Hozzájárulás

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót, amelyből többet is megtudhat a kód összeállításáról és teszteléséről.

Kapcsolódó projektek

• JavaScripthez készült Microsoft Azure SDK