Azure Subscription client library for JavaScript - version 3.0.0

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

主要連結:

入門指南

目前支援的環境

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

先決條件

安裝 @azure/arm-resources-subscriptions 套件

使用 npm: 安裝適用於 JavaScript 的 Azure 訂用帳戶用戶端程式庫:

npm install @azure/arm-resources-subscriptions

建立和驗證 SubscriptionClient

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

你可以用@azure/identity庫的憑證或現有的AAD憑證來驗證Azure Active Directory。

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

npm install @azure/identity

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

想了解更多如何建立 Azure AD 應用程式的資訊,請參考 此指南

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

import { SubscriptionClient } from "@azure/arm-resources-subscriptions";
import { DefaultAzureCredential } from "@azure/identity";

const client = new SubscriptionClient(new DefaultAzureCredential());

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { SubscriptionClient } from "@azure/arm-resources-subscriptions";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new SubscriptionClient(credential);

JavaScript 套件組合

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

關鍵概念

訂閱用戶端

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

Troubleshooting

Logging

啟用記錄可能有助於找出有關失敗的實用資訊。 若要查看 HTTP 要求和回應的記錄,請將 AZURE_LOG_LEVEL 環境變數設定為 info。 或者,您可以在運行時間啟用記錄,方法是在 setLogLevel中呼叫 @azure/logger

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

setLogLevel("info");

如需如何啟用記錄的詳細指示,請參閱@azure/記錄器套件檔。

下一步

如需如何使用此連結庫的詳細範例,請參閱 範例 目錄。

Contributing

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

  • Microsoft JavaScript