Sdílet prostřednictvím

Klientská knihovna funkcí Azure pro JavaScript – verze 3.1.0

  • Článek

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

Azure Feature Exposure Control (AFEC) poskytuje poskytovatelům prostředků mechanismus, který řídí vystavení funkcí uživatelům. Poskytovatelé prostředků obvykle používají tento mechanismus k poskytování veřejné nebo privátní verze Preview pro nové funkce před jejich všeobecnou dostupností. Uživatelé si musí funkce AFEC explicitně zaregistrovat, aby k těmto funkcím získali přístup.

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

Nainstalujte klientskou knihovnu funkcí Azure pro JavaScript pomocí npmnástroje :

npm install @azure/arm-features

Vytvoření a ověření FeatureClient

Pokud chcete vytvořit objekt klienta pro přístup k rozhraní API funkcí Azure, budete potřebovat endpoint prostředek funkce Azure a credential. Klient funkcí Azure může k ověřování použít přihlašovací údaje Azure Active Directory. Koncový bod pro váš prostředek funkce Azure najdete na webu Azure Portal.

K ověření můžete použít Azure Active Directory přihlašovací údaje z knihovny @azure/identity nebo existujícího tokenu AAD.

Pokud chcete použít zprostředkovatele DefaultAzureCredential uvedeného níže nebo jiné zprostředkovatele přihlašovacích údajů poskytnuté 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 funkci Azure přiřazením vhodné role k instančnímu objektu (poznámka: Role, jako "Owner" jsou, 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 { FeatureClient } = require("@azure/arm-features");
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 FeatureClient(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 FeatureClient(credential, subscriptionId);

JavaScript Bundle

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

Klíčové koncepty

FeatureClient

FeatureClient je primárním rozhraním pro vývojáře, kteří používají klientskou knihovnu funkcí Azure. Prozkoumejte metody tohoto klientského objektu, abyste porozuměli různým funkcím služby Funkcí Azure, ke které 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 ukázek .

Přispívání

Pokud chcete přispívat do této knihovny, přečtěte si příručku pro přispívání , kde najdete další informace o tom, jak sestavit a otestovat kód.

Imprese