Bagikan melalui

Azure Device Update for IoT Hub Rest Client library for JavaScript - versi 1.0.0

  • Artikel

Pustaka menyediakan akses ke layanan Pembaruan Perangkat untuk IoT Hub yang memungkinkan pelanggan menerbitkan pembaruan untuk perangkat IoT mereka ke cloud, lalu menyebarkan pembaruan ini ke perangkat mereka (menyetujui pembaruan untuk grup perangkat yang dikelola dan disediakan dalam IoT Hub).

Harap sangat bergantung pada dokumentasi layanan dan dokumen klien REST kami untuk menggunakan pustaka ini

Tautan utama:

Memulai

Lingkungan yang didukung saat ini

  • Node.js versi 14.x.x atau yang lebih tinggi

Prasyarat

  • Langganan Microsoft Azure: Untuk memanggil layanan Microsoft Azure, Anda perlu membuat langganan Azure
  • Pembaruan Perangkat untuk instans IoT Hub
  • instans Azure IoT Hub

Pasang paket @azure-rest/iot-device-update

Instal pustaka klien Azure Iot Device Update untuk JavaScript dengan npm:

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

Membuat dan mengautentikasi DeviceUpdate

Untuk menggunakan kredensial token Azure Active Directory (AAD), berikan instans jenis kredensial yang diinginkan yang diperoleh dari pustaka @azure/identitas .

Untuk mengautentikasi dengan AAD, Anda harus terlebih dahulu npm menginstal @azure/identity.

Setelah penginstalan, Anda dapat memilih jenis kredensial@azure/identity mana yang akan digunakan. Sebagai contoh, DefaultAzureCredential dapat digunakan untuk mengautentikasi klien:

Atur nilai ID klien, ID penyewa, dan rahasia klien aplikasi AAD sebagai variabel lingkungan: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET

Gunakan kredensial token yang dikembalikan untuk mengautentikasi klien:

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()
);

Konsep utama

Klien REST

Klien ini adalah salah satu klien REST kami. Kami sangat menyarankan Anda membaca cara menggunakan klien REST di sini.

Contoh

Bagian berikut menunjukkan cara menginisialisasi dan mengautentikasi klien Anda, lalu mendapatkan semua perangkat.

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);

Pemecahan Masalah

Pencatatan

Mengaktifkan pengelogan dapat membantu menemukan informasi yang berguna tentang kegagalan. Untuk melihat log permintaan dan respons HTTP, atur variabel lingkungan AZURE_LOG_LEVEL ke info. Atau, pengelogan dapat diaktifkan saat runtime dengan memanggil setLogLevel di @azure/logger:

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

setLogLevel("info");

Untuk instruksi lebih rinci tentang cara mengaktifkan log, Anda dapat melihat dokumen paket @azure/pencatat.

Langkah berikutnya

Berkontribusi

Jika Anda ingin berkontribusi pada pustaka ini, baca panduan berkontribusi untuk mempelajari selengkapnya tentang cara membuat dan menguji kode.

Tayangan