Azure ResourceGraph klientská knihovna pro JavaScript - verze 5.0.0-beta.5

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

Azure Resource Graph API Reference

Klíčové odkazy:

Začínáme

Aktuálně podporovaná prostředí

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

Prerequisites

  • Předplatné služby Azure.

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

Nainstalujte klientskou knihovnu Azure ResourceGraph pro JavaScript s npm:

npm install @azure/arm-resourcegraph

Vytvořte a ověřte ResourceGraphClient

Pro vytvoření klientského objektu pro přístup k API Azure ResourceGraph budete potřebovat endpoint vašeho Azure zdroje ResourceGraph a credential. Klient Azure ResourceGraph může použít přihlašovací údaje Azure Active Directory k autentizaci. Endpoint pro svůj Azure ResourceGraph najdete v 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 níže uvedeného zprostředkovatele DefaultAzureCredential nebo jiné zprostředkovatele přihlašovacích údajů, které jsou součástí sady Azure SDK, nainstalujte @azure/identity balíček:

npm install @azure/identity

Budete také muset registrovat novou aplikaci AAD a udělit přístup k Azure ResourceGraph přiřazením vhodné role vašemu zástupci služby (poznámka: role jako "Owner" neudělí potřebná oprávnění).

Další informace o tom, jak vytvořit aplikaci Azure AD, najdete v 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 { ResourceGraphClient } from "@azure/arm-resourcegraph";
import { DefaultAzureCredential } from "@azure/identity";

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

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ResourceGraphClient(credential, subscriptionId);

JavaScriptový balíček

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 k sdružování.

Klíčové koncepty

ResourceGraphClient

ResourceGraphClient je hlavní rozhraní pro vývojáře využívající klientskou knihovnu Azure ResourceGraph. Prozkoumejte metody na tomto klientském objektu, abyste pochopili různé funkce služby Azure ResourceGraph, ke kterým máte přístup.

Troubleshooting

Logging

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 adresáři ukázek .

Contributing

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.