此套件包含適用於 Azure 資料保護用戶端的同構 SDK (在 Node.js 和瀏覽器中執行)。
開啟適用於 Azure 資料保護服務的 API 2.0 規格
主要連結:
開始
目前支持的環境
- LTS 版本的 Node.js
- 最新版的 Safari、Chrome、Edge 和 Firefox。
有關更多詳細信息,請參閱我們的 支持政策 。
先決條件
安裝 @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_LEVEL 為 info。 或者,可以在執行階段setLogLevel@azure/logger呼叫 :
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
如需如何啟用記錄的更詳細指示,您可以查看 @azure/logger 套件文件。
後續步驟
請查看 範例 目錄,以取得如何使用此程式庫的詳細範例。
貢獻
如果您想要參與此連結庫,請閱讀 參與指南 ,以深入瞭解如何建置和測試程序代碼。