Sdílet prostřednictvím

Klientská knihovna Azure ResourceGraph pro JavaScript – verze 5.0.0-beta.3

  • Článek

Tento balíček obsahuje izomorfní sadu SDK (běží v Node.js i v prohlížečích) pro klienta Azure ResourceGraph.

Referenční informace k rozhraní API služby Azure Resource Graph

Zdrojový kód | Balíček (NPM) | Referenční dokumentace k | rozhraní API Vzorky

Začínáme

Aktuálně podporovaná prostředí

  • LtS verze Node.js
  • Nejnovější verze prohlížečů Safari, Chrome, Edge a Firefox.

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

Požadavky

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

Nainstalujte klientskou knihovnu Azure ResourceGraph pro JavaScript pomocí npmpříkazu :

npm install @azure/arm-resourcegraph

Vytvoření a ověření ResourceGraphClient

Pokud chcete vytvořit objekt klienta pro přístup k rozhraní API Azure ResourceGraph, budete potřebovat endpoint prostředek Azure ResourceGraph a credential. Klient Azure ResourceGraph může k ověření použít přihlašovací údaje Azure Active Directory. Koncový bod pro prostředek Azure ResourceGraph 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 zprostředkovatele DefaultAzureCredential uvedeného níže nebo jiné poskytovatele přihlašovacích údajů poskytovaného se sadou Azure SDK, nainstalujte @azure/identity balíček:

npm install @azure/identity

Budete také muset zaregistrovat novou aplikaci AAD a udělit přístup k Azure ResourceGraph přiřazením vhodné role k instančnímu objektu (poznámka: role jako "Owner" neudělí potřebná oprávnění). Nastavte hodnoty ID klienta, ID tenanta a tajného klíče klienta aplikace AAD jako proměnné prostředí: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Další informace o tom, jak vytvořit aplikaci Azure AD, najdete v tomto průvodci.

const { ResourceGraphClient } = require("@azure/arm-resourcegraph");
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 ResourceGraphClient(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 ResourceGraphClient(credential, subscriptionId);

JavaScript Bundle

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

Klíčové koncepty

ResourceGraphClient

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

Řešení potíží

protokolování

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

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

Podrobnější pokyny k povolení protokolů najdete v dokumentaci k balíčkům @azure/protokolovacího nástroje.

Další kroky

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

Přispívání

Pokud chcete přispívat do této knihovny, přečtěte si prosím průvodce přispívání , kde se dozvíte více o tom, jak sestavit a otestovat kód.

Imprese