共用方式為

適用于 JavaScript 的 Azure Power BI Embedded 管理用戶端程式庫 - 2.0.2 版

  • 發行項

此套件包含 (在 azure Power BI Embedded Management 用戶端) Node.js和瀏覽器中執行的同型 SDK。

用來管理Power BI Embedded工作區集合並擷取工作區的用戶端。

| 原始程式碼套件 (NPM) | API 參考檔 | 樣品

開始使用

目前支援的環境

如需詳細資訊，請參閱我們的支援原則。

必要條件

安裝 @azure/arm-powerbiembedded 套件

使用 npm 安裝適用于 JavaScript 的 Azure Power BI Embedded 管理用戶端程式庫：

npm install @azure/arm-powerbiembedded

建立和驗證 PowerBIEmbeddedManagementClient

若要建立用戶端物件來存取 Azure Power BI Embedded 管理 API，您需要 endpoint Azure Power BI Embedded 管理資源和 credential 。 Azure Power BI Embedded管理用戶端可以使用 Azure Active Directory 認證進行驗證。 您可以在Azure入口網站中找到 Azure Power BI Embedded管理資源的端點。

您可以使用 來自@azure/身分識別 程式庫或 現有 AAD 權杖的認證向 Azure Active Directory 進行驗證。

若要使用如下所示的 DefaultAzureCredential 提供者，或其他 Azure SDK 提供的認證提供者，請安裝 @azure/identity 套件：

npm install @azure/identity

您也需要註冊新的 AAD 應用程式，並將適當的角色指派給服務主體，以授與 Azure Power BI Embedded 管理的存取權 (附注：例如 "Owner" 的角色不會授與必要的許可權) 。 將 AAD 應用程式的用戶端識別碼、租使用者識別碼和用戶端密碼的值設定為環境變數： AZURE_CLIENT_ID 、、 AZURE_TENANT_IDAZURE_CLIENT_SECRET 。

如需如何建立 Azure AD 應用程式的詳細資訊，請參閱 本指南。

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

JavaScript 套件組合

若要在瀏覽器中使用此用戶端程式庫，您必須先使用套件組合器。 如需如何執行這項操作的詳細資訊，請參閱我們的 統合檔。

重要概念

PowerBIEmbeddedManagementClient

PowerBIEmbeddedManagementClient是開發人員使用 Azure Power BI Embedded 管理用戶端程式庫的主要介面。 探索此用戶端物件上的方法，以瞭解您可以存取之 Azure Power BI Embedded 管理服務的不同功能。

疑難排解

記錄

啟用記錄有助於找出失敗的相關實用資訊。 若要查看 HTTP 的要求和回應記錄，請將 AZURE_LOG_LEVEL 環境變數設定為 info。 或者，您可以在 @azure/logger 中呼叫 setLogLevel，以在執行階段啟用記錄：

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

如需如何啟用記錄的詳細指示，可參閱 @azure/logger 套件文件。

下一步

如需如何使用此程式庫的詳細 範例 ，請參閱範例目錄。

參與

如果您希望向此程式庫投稿，請參閱投稿指南，深入瞭解如何組建與測試程式碼。

曝光數