Delen via

Azure Policy clientbibliotheek voor JavaScript - versie 2.1.0

  • Artikel

Dit pakket bevat een isomorfe SDK (wordt zowel in Node.js als in browsers uitgevoerd) voor Azure Policy-client.

Als u de toegang tot uw resources wilt beheren en beheren, kunt u aangepaste beleidsregels definiëren en deze toewijzen aan een bereik.

Broncode | Pakket (NPM) | API-referentiedocumentatie | Monsters

Aan de slag

Momenteel ondersteunde omgevingen

Zie ons ondersteuningsbeleid voor meer informatie.

Vereisten

Installeer het pakket @azure/arm-policy-profile-2020-09-01-hybrid

Installeer de Azure Policy-clientbibliotheek voor JavaScript met npm:

npm install @azure/arm-policy-profile-2020-09-01-hybrid

Een maken en verifiëren PolicyClient

Als u een clientobject wilt maken voor toegang tot de Azure Policy-API, hebt u de endpoint van uw Azure Policy resource en een credentialnodig. De Azure Policy-client kan Azure Active Directory-referenties gebruiken om te verifiëren. U vindt het eindpunt voor uw Azure Policy-resource in Azure Portal.

U kunt zich verifiëren met Azure Active Directory met behulp van een referentie uit de bibliotheek @azure/identity of een bestaand AAD-token.

Als u de hieronder weergegeven DefaultAzureCredential-provider of andere referentieproviders wilt gebruiken die bij de Azure SDK worden geleverd, installeert u het @azure/identity pakket:

npm install @azure/identity

U moet ook een nieuwe AAD-toepassing registreren en toegang verlenen tot Azure Policy door de juiste rol toe te wijzen aan uw service-principal (opmerking: rollen zoals "Owner" verlenen niet de benodigde machtigingen). Stel de waarden van de client-id, tenant-id en clientgeheim van de AAD-toepassing in als omgevingsvariabelen: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Raadpleeg deze handleiding voor meer informatie over het maken van een Azure AD-toepassing.

const { PolicyClient } = require("@azure/arm-policy-profile-2020-09-01-hybrid");
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 PolicyClient(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 PolicyClient(credential, subscriptionId);

JavaScript-bundel

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundler gebruiken. Raadpleeg onze bundeldocumentatie voor meer informatie over hoe u dit doet.

Belangrijkste concepten

PolicyClient

PolicyClientis de primaire interface voor ontwikkelaars die de Azure Policy clientbibliotheek gebruiken. Verken de methoden voor dit clientobject om inzicht te krijgen in de verschillende functies van de Azure Policy-service waartoe u toegang hebt.

Problemen oplossen

Logboekregistratie

Het inschakelen van logboekregistratie kan helpen bij het ontdekken van nuttige informatie over fouten. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de AZURE_LOG_LEVEL omgevingsvariabele in op info. U kunt logboekregistratie ook tijdens runtime inschakelen door aan te roepen setLogLevel in de @azure/logger:

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

Voor meer gedetailleerde instructies over het inschakelen van logboeken kunt u de @azure-/loggerpakketdocumenten bekijken.

Volgende stappen

Bekijk de map met voorbeelden voor gedetailleerde voorbeelden van het gebruik van deze bibliotheek.

Bijdragen

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de handleiding voor bijdragen voor meer informatie over het bouwen en testen van de code.

Weergaven