共用方式為

Azure 原則 JavaScript 的用戶端程式庫 - 2.1.0 版

  • 發行項

此套件包含 (在 Node.js 和瀏覽器) 中執行Azure 原則用戶端的同型 SDK。

若要管理和控制資源的存取權，您可以定義自訂的原則，並在範圍內將它們加以指派。

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

開始使用

目前支援的環境

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

必要條件

安裝 @azure/arm-policy-profile-2020-09-01-hybrid 套件

使用 安裝適用于 JavaScript npm 的Azure 原則用戶端程式庫：

npm install @azure/arm-policy-profile-2020-09-01-hybrid

建立和驗證 PolicyClient

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

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

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

npm install @azure/identity

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

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

const { PolicyClient } = require("@azure/arm-policy-profile-2020-09-01-hybrid");
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 PolicyClient(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 PolicyClient(credential, subscriptionId);

JavaScript 套件組合

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

重要概念

PolicyClient

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

疑難排解

記錄

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

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

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

下一步

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

參與

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

曝光數