Sdílet prostřednictvím


Klientská knihovna Azure Policy pro JavaScript – verze 6.0.0

Tento balíček obsahuje izomorfní sadu SDK (spouští se v Node.js i v prohlížečích) pro klienta Azure Policy.

Pokud chcete spravovat a řídit přístup k prostředkům, můžete definovat přizpůsobené zásady a přiřadit je v oboru.

Referenční dokumentace k rozhraníAPI zdrojového kódu(NPM)ukázky

Začínáme

Aktuálně podporovaná prostředí

Další podrobnosti najdete v zásadách podpory.

Požadavky

  • Předplatné služby Azure.

Nainstalujte balíček @azure/arm-policy.

Nainstalujte klientskou knihovnu Azure Policy pro JavaScript s npm:

npm install @azure/arm-policy

Vytvoření a ověření PolicyClient

K vytvoření objektu klienta pro přístup k rozhraní API služby Azure Policy budete potřebovat endpoint prostředku Azure Policy a credential. Klient Azure Policy může k ověření použít přihlašovací údaje Azure Active Directory. Koncový bod prostředku Azure Policy najdete na webu azure Portal.

Pomocí Azure Active Directory se můžete ověřit pomocí přihlašovacích údajů z knihovny @azure/identity nebo existujícího tokenu AAD.

Pokud chcete použít poskytovatele DefaultAzureCredential zobrazené níže nebo jiné zprostředkovatele přihlašovacích údajů poskytnuté sadou Azure SDK, nainstalujte balíček @azure/identity:

npm install @azure/identity

Budete také muset zaregistrovat novou aplikaci AAD a udělit přístup ke službě Azure Policy přiřazením vhodné role k instančnímu objektu (poznámka: role, jako je "Owner", neudělí potřebná oprávnění).

Další informace o tom, jak vytvořit aplikaci Azure AD, najdete této příručce.

Pomocí Node.js a prostředí podobných uzlům můžete k ověření klienta použít třídu DefaultAzureCredential.

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);

Pro prostředí prohlížeče použijte k ověření InteractiveBrowserCredential z balíčku @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 Bundle

Pokud chcete tuto klientskou knihovnu použít v prohlížeči, musíte nejprve použít bundler. Podrobnosti o tom, jak to udělat, najdete v naší dokumentaci sdružování.

Klíčové koncepty

PolicyClient

PolicyClient je primárním rozhraním pro vývojáře, kteří používají klientskou knihovnu Azure Policy. Prozkoumejte metody tohoto objektu klienta a seznamte se s různými funkcemi služby Azure Policy, ke kterým máte přístup.

Řešení problémů

Logování

Povolení protokolování může pomoct odhalit užitečné informace o chybách. Pokud chcete zobrazit protokol požadavků a odpovědí HTTP, nastavte proměnnou prostředí AZURE_LOG_LEVEL na info. Případně můžete protokolování povolit za běhu voláním setLogLevel v @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Podrobnější pokyny k povolení protokolů najdete v dokumentaci k @azure/protokolovacímu balíčku.

Další kroky

Podrobné příklady použití této knihovny najdete v ukázkách adresáři.

Přispění

Pokud chcete přispívat do této knihovny, přečtěte si průvodce přispívání a přečtěte si další informace o vytváření a testování kódu.