共用方式為

適用于 JavaScript IoT 中樞 Rest 用戶端程式庫的 Azure 裝置更新 - 1.0.0 版

  • 發行項

此程式庫提供IoT 中樞服務的裝置更新存取權，讓客戶將 IoT 裝置的更新發佈至雲端，然後將這些更新部署至其裝置， (核准IoT 中樞) 中管理及布建之裝置群組的更新。

請高度依賴 服務的檔 和 我們的 REST 用戶端檔 來使用此程式庫

重要連結：

開始使用

目前支援的環境

  • Node.js 14.x.x 版或更高版本

必要條件

  • Microsoft Azure 訂用帳戶：若要呼叫 Microsoft Azure 服務，您需要建立 Azure 訂用帳戶
  • IoT 中樞 實例的裝置更新
  • Azure IoT 中樞實例

安裝 @azure-rest/iot-device-update 套件

使用 npm 安裝適用于 JavaScript 的 Azure Iot 裝置更新用戶端程式庫：

npm install @azure-rest/iot-device-update

建立和驗證 DeviceUpdate

若要使用 Azure Active Directory (AAD) 權杖認證，請提供從 @azure/身分識別 程式庫取得所需認證類型的實例。

若要使用 AAD 進行驗證，您必須先 npm 安裝 @azure/identity 。

安裝之後，您可以選擇要使用的 認證@azure/identity 類型。 例如， DefaultAzureCredential 可用來驗證用戶端：

將 AAD 應用程式的用戶端識別碼、租使用者識別碼和用戶端密碼的值設定為環境變數：AZURE_CLIENT_ID、AZURE_TENANT_ID、AZURE_CLIENT_SECRET

使用傳回的權杖認證來驗證用戶端：

import DeviceUpdate from "@azure-rest/iot-device-update";
import { DefaultAzureCredential } from "@azure/identity";
const client = DeviceUpdate(
  "https://<my-instance-id>.api.adu.microsoft.com",
  new DefaultAzureCredential()
);

重要概念

REST 用戶端

此用戶端是我們其中一個 REST 用戶端。 強烈建議您 在這裡閱讀如何使用 REST 用戶端。

範例

下一節說明如何初始化和驗證用戶端，然後取得所有裝置。

import DeviceUpdate from "@azure-rest/iot-device-update";
import { DefaultAzureCredential } from "@azure/identity";

async function main() {
  console.log("== List devices ==");
  const client = DeviceUpdate(endpoint, new DefaultAzureCredential());

  const result = await client
    .path("/deviceupdate/{instanceId}/management/devices", instanceId)
    .get();

  console.log(result);
}

main().catch(console.error);

疑難排解

記錄

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

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

setLogLevel("info");

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

下一步

參與

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

曝光數