共用方式為


適用於 JavaScript 的 Azure 資料保護用戶端程式庫 - 4.0.0 版

此套件包含適用於 Azure 資料保護用戶端的同構 SDK (在 Node.js 和瀏覽器中執行)。

開啟適用於 Azure 資料保護服務的 API 2.0 規格

主要連結:

開始

目前支持的環境

有關更多詳細信息,請參閱我們的 支持政策

先決條件

安裝 @azure/arm-dataprotection 套件

使用 npm: 安裝適用於 JavaScript 的 Azure 資料保護用戶端程式庫:

npm install @azure/arm-dataprotection

建立並驗證 DataProtectionClient

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

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

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

npm install @azure/identity

您也必須註冊新的 AAD 應用程式,並將適當的角色指派給您的服務主體,以 授與 Azure 資料保護的存取權 (附註:角色 (不會 "Owner" 授與必要的許可權)。

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

使用類似 Node.js 和類似 Node 的環境,您可以使用類別 DefaultAzureCredential 來驗證用戶端。

import { DataProtectionClient } from "@azure/arm-dataprotection";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new DataProtectionClient(new DefaultAzureCredential(), subscriptionId);

對於瀏覽器環境,請使用套件中的 InteractiveBrowserCredential 進行@azure/identity驗證。

import { InteractiveBrowserCredential } from "@azure/identity";
import { DataProtectionClient } from "@azure/arm-dataprotection";

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

JavaScript 套件組合

若要在瀏覽器中使用此用戶端連結庫,您必須先使用配套程式。 有關如何執行此操作的詳細信息,請參閱我們的 捆綁文件

重要概念

DataProtectionClient

DataProtectionClient 是使用 Azure 資料保護用戶端程式庫的開發人員的主要介面。 探索此客戶端物件上的方法,以瞭解您可以存取之 Azure 數據保護服務的不同功能。

故障排除

伐木

啟用記錄可能有助於找出有關失敗的實用資訊。 若要檢視HTTP請求和回應的日誌,請將環境變數設定 AZURE_LOG_LEVELinfo。 或者,可以在執行階段setLogLevel@azure/logger呼叫 :

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

如需如何啟用記錄的更詳細指示,您可以查看 @azure/logger 套件文件

後續步驟

請查看 範例 目錄,以取得如何使用此程式庫的詳細範例。

貢獻

如果您想要參與此連結庫,請閱讀 參與指南 ,以深入瞭解如何建置和測試程序代碼。