Azure Bicep JavaScript-ügyféloldali kódtár – 1.0.0-beta.1-es verzió

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

Bicep-ügyfél

Főbb hivatkozások:

• forráskód
• Csomag (NPM)
• API-referenciadokumentáció
• Minták

Kezdő lépések

Jelenleg támogatott környezetek

• A Node.jsLTS-változatai
• 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.

Telepítse a(z) @azure/arm-resourcesbicep csomagot

Telepítse az Azure Bicep JavaScript-ügyféloldali kódtárát a következővel npm:

npm install @azure/arm-resourcesbicep

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

Ha ügyfélobjektumot szeretne létrehozni az Azure Bicep API eléréséhez, szüksége lesz az endpoint Azure Bicep-erőforrásra és egy credential. Az Azure Bicep-ügyfél Azure Active Directory hitelesítő adatokkal hitelesítheti magát. Az Azure Bicep-erőforrás végpontját a Azure Portal.

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 regisztrálnia kell egy új AAD-alkalmazást, és hozzáférést kell adnia az Azure Bicephez úgy, hogy hozzárendeli a megfelelő szerepkört a szolgáltatásnévhez (megjegyzés: olyan szerepkörök, mint például "Owner" nem adják meg a szükséges engedélyeket).

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

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

import { BicepClient } from "@azure/arm-resourcesbicep";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { BicepClient } from "@azure/arm-resourcesbicep";

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

BicepClient

BicepClient az Azure Bicep ügyféloldali kódtárat használó fejlesztők elsődleges felülete. Ismerje meg az ügyfélobjektum metódusait, hogy megértse az Azure Bicep szolgáltatás különböző funkcióit, amelyek elérhetők.

Hibaelhárítás

Logging

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 környezeti változót a AZURE_LOG_LEVEL következőre info: . Alternatívaként a naplózás futásidőben is engedélyezhető a setLogLevel hí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.

Közreműködé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