Azure ImageBuilder klientská knihovna pro JavaScript - verze 5.0.0

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

Šablona obrazového obrazu virtuálního stroje

Klíčové odkazy:

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-imagebuilder.

Nainstalujte klientskou knihovnu Azure ImageBuilder pro JavaScript s npm:

npm install @azure/arm-imagebuilder

Vytvořte a ověřte ImageBuilderClient

Pro vytvoření klientského objektu pro přístup k API Azure ImageBuilder budete potřebovat endpoint vašeho Azure ImageBuilder zdroje a credential. Klient Azure ImageBuilder může k ověření použít přihlašovací údaje Azure Active Directory. Koncový bod pro svůj Azure ImageBuilder 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 AAD aplikaci a udělit přístup Azure ImageBuilder přiřazením vhodné role vašemu principálovi 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 { ImageBuilderClient } from "@azure/arm-imagebuilder";
import { DefaultAzureCredential } from "@azure/identity";

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

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

ImageBuilderClient

ImageBuilderClient je hlavní rozhraní pro vývojáře používající klientskou knihovnu Azure ImageBuilder. Prozkoumejte metody tohoto klientského objektu, abyste porozuměli různým funkcím služby Azure ImageBuilder, ke které máte přístup.

Řešení problémů

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

Přispívající

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.