Pustaka klien Azure DeviceUpdate untuk JavaScript - versi 1.1.0

Paket ini berisi SDK isomorfik (berjalan baik di Node.js maupun browser) untuk klien DeviceUpdate Azure.

Pembaruan Perangkat untuk IoT Hub adalah layanan Azure yang memungkinkan pelanggan mempublikasikan pembaruan untuk perangkat IoT mereka ke cloud, lalu menerapkan pembaruan tersebut ke perangkat mereka (menyetujui pembaruan untuk kelompok perangkat yang dikelola dan disediakan di IoT Hub). Platform ini memanfaatkan keamanan dan keandalan yang telah terbukti dari platform Windows Update, yang dioptimalkan untuk perangkat IoT. Perangkat ini bekerja secara global dan mengetahui kapan serta bagaimana memperbarui perangkat, memungkinkan pelanggan fokus pada tujuan bisnis mereka dan membiarkan Device Update untuk IoT Hub menangani pembaruan.

Tautan kunci:

Memulai Langkah Pertama

Lingkungan yang didukung saat ini

Lihat kebijakan dukungan kami untuk detail selengkapnya.

Prasyarat

  • Sebuah langganan Azure.

Pasang paket @azure/iot-device-update

Instal pustaka klien Azure DeviceUpdate untuk JavaScript dengan npm:

npm install @azure/iot-device-update

Membuat dan mengautentikasi DeviceUpdateClient

Untuk membuat objek klien guna mengakses Azure DeviceUpdate API, Anda memerlukan endpoint sumber daya Azure DeviceUpdate Anda dan .credential Klien Azure DeviceUpdate dapat menggunakan kredensial Azure Active Directory untuk autentikasi. Anda dapat menemukan endpoint untuk sumber daya Azure DeviceUpdate Anda di portal Azure.

Anda dapat mengautentikasi dengan Azure Active Directory menggunakan kredensial dari pustaka @azure/identitas atau Token AAD yang sudah ada.

Untuk menggunakan penyedia DefaultAzureCredential yang ditunjukkan di bawah ini, atau penyedia kredensial lain yang disediakan dengan Azure SDK, instal paket :

npm install @azure/identity

Anda juga perlu mendaftarkan aplikasi AAD baru dan memberikan akses ke Azure DeviceUpdate dengan menetapkan peran yang sesuai kepada principal layanan Anda (catatan: peran seperti tidak "Owner" akan memberikan izin yang diperlukan).

Untuk informasi selengkapnya tentang cara membuat aplikasi Azure ACTIVE Directory, lihat panduan ini.

Dengan menggunakan lingkungan Node.js dan seperti Node, Anda dapat menggunakan kelas DefaultAzureCredential untuk mengautentikasi klien.

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

const client = new DeviceUpdateClient("<endpoint>", new DefaultAzureCredential(), "<instanceId>");

Untuk lingkungan browser, gunakan InteractiveBrowserCredential dari paket @azure/identity untuk mengautentikasi.

import { InteractiveBrowserCredential } from "@azure/identity";
import { DeviceUpdateClient } from "@azure/iot-device-update";

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

Bundel JavaScript

Untuk menggunakan pustaka klien ini di browser, pertama-tama Anda perlu menggunakan bunder. Untuk detail tentang cara melakukan ini, silakan lihat dokumentasi bundling kami.

Konsep Utama

DeviceUpdateClient

DeviceUpdateClientadalah antarmuka utama bagi pengembang yang menggunakan pustaka klien Azure DeviceUpdate. Jelajahi metode pada objek klien ini untuk memahami berbagai fitur dari layanan Azure DeviceUpdate yang dapat Anda akses.

Troubleshooting

Penebangan kayu

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/logger.

Contributing

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

  • Last updated on