Azure Policy-ügyfélkódtár JavaScripthez – 6.0.0-s verzió

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

Az erőforrásokhoz való hozzáférés kezeléséhez és szabályozásához testre szabott szabályzatokat határozhat meg, és hozzárendelheti őket egy hatókörhöz.

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

Kezdő lépések

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 támogatási szabályzatunkat.

Előfeltételek

• Egy Azure-előfizetés.

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

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

npm install @azure/arm-policy

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

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

Emellett új AAD-alkalmazást kell regisztrálnia és hozzáférést kell adnia az Azure Policy-, 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ó .

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

import { PolicyClient } from "@azure/arm-policy";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new PolicyClient(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 { PolicyClient } from "@azure/arm-policy";

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

PolicyClient

PolicyClient az Azure Policy-ügyfélkódtárat használó fejlesztők elsődleges felülete. Az ügyfélobjektum metódusainak megismerése az Azure Policy szolgáltatás különböző elérhető 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.

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