適用于 JavaScript 的 Azure IotCentral 用戶端程式庫 - 6.0.0 版
此套件包含同型 SDK (會在 azure IotCentral 用戶端的 Node.js 和瀏覽器) 中執行。
使用此 API 來管理 Azure 訂用帳戶中的 IoT Central 應用程式。
| 原始程式碼套件 (NPM) | API 參考檔 | 樣品
開始使用
目前支援的環境
- Node.js 的 LTS 版本
- 最新版的 Safari、Chrome、Edge 和 Firefox。
必要條件
安裝 @azure/arm-iotcentral
套件
使用 npm
安裝適用于 JavaScript 的 Azure IotCentral 用戶端程式庫:
npm install @azure/arm-iotcentral
建立和驗證 IotCentralClient
若要建立用戶端物件來存取 Azure IotCentral API,您需要 endpoint
Azure IotCentral 資源的 和 credential
。 Azure IotCentral 用戶端可以使用 Azure Active Directory 認證進行驗證。
您可以在 Azure入口網站中找到 Azure IotCentral 資源的端點。
您可以使用 來自@azure/身分 識別程式庫或 現有 AAD 權杖的認證,向 Azure Active Directory 進行驗證。
若要使用如下所示的 DefaultAzureCredential 提供者,或其他隨附于 Azure SDK 的認證提供者,請安裝 @azure/identity
套件:
npm install @azure/identity
您也需要 註冊新的 AAD 應用程式,並將 適當的角色指派給服務主體,以授與 Azure IotCentral 的存取權, (注意:這類 "Owner"
角色不會授與必要的許可權) 。
將 AAD 應用程式的用戶端識別碼、租使用者識別碼和用戶端密碼的值設定為環境變數: AZURE_CLIENT_ID
、、 AZURE_TENANT_ID
AZURE_CLIENT_SECRET
。
如需如何建立 Azure AD 應用程式的詳細資訊,請參閱 本指南。
const { IotCentralClient } = require("@azure/arm-iotcentral");
const { DefaultAzureCredential } = require("@azure/identity");
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new IotCentralClient(new DefaultAzureCredential(), subscriptionId);
JavaScript 套件組合
若要在瀏覽器中使用此用戶端程式庫,您必須先使用套件組合器。 如需如何執行這項操作的詳細資訊,請參閱我們的 統合檔。
重要概念
IotCentralClient
IotCentralClient
是使用 Azure IotCentral 用戶端程式庫的開發人員的主要介面。 探索此用戶端物件上的方法,以瞭解您可以存取之 Azure IotCentral 服務的不同功能。
疑難排解
記錄
啟用記錄有助於找出失敗的相關實用資訊。 若要查看 HTTP 的要求和回應記錄,請將 AZURE_LOG_LEVEL
環境變數設定為 info
。 或者,您可以在 @azure/logger
中呼叫 setLogLevel
,以在執行階段啟用記錄:
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
如需如何啟用記錄的詳細指示,可參閱 @azure/logger 套件文件。
下一步
如需如何使用此程式庫的詳細範例,請參閱 範例 目錄。
參與
如果您希望向此程式庫投稿,請參閱投稿指南,深入瞭解如何組建與測試程式碼。
相關專案