Azure CosmosDBManagement JavaScript-ügyféloldali kódtár – 16.4.0-s verzió

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

Azure Cosmos DB adatbázis-szolgáltatás erőforrás-szolgáltató REST API

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

Kezdetekhez

Jelenleg támogatott környezetek

• A 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-cosmosdb csomag telepítése

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

npm install @azure/arm-cosmosdb

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

Az Azure CosmosDBManagement API eléréséhez ügyfélobjektum létrehozásához szüksége lesz az Azure CosmosDBManagement-erőforrás endpoint és egy credential. Az Azure CosmosDBManagement-ügyfél az Azure Active Directory hitelesítő adatait használhatja a hitelesítéshez. Az Azure CosmosDBManagement-erőforrás végpontját az Azure Portaltalá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

Új AAD-alkalmazást is regisztrálnia kell és hozzáférést kell adnia az Azure CosmosDBManagement a megfelelő szerepkörnek a szolgáltatásnévhez való hozzárendelésével (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ó .

A Node.js és a csomópontszerű környezetek használatával a DefaultAzureCredential osztály használatával hitelesítheti az ügyfelet.

import { CosmosDBManagementClient } from "@azure/arm-cosmosdb";
import { DefaultAzureCredential } from "@azure/identity";

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

Böngészőkörnyezetek esetén a hitelesítéshez használja a InteractiveBrowserCredential csomagból származó @azure/identity.

import { InteractiveBrowserCredential } from "@azure/identity";
import { CosmosDBManagementClient } from "@azure/arm-cosmosdb";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new CosmosDBManagementClient(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

CosmosDBManagementClient

CosmosDBManagementClient az Azure CosmosDBManagement ügyfélkódtárat használó fejlesztők elsődleges felülete. Az ügyfélobjektum metódusainak megismerése az Azure CosmosDBManagement 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:

import { setLogLevel } from "@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