Pustaka klien Azure iotHub untuk JavaScript - versi 6.3.0

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

Gunakan API ini untuk mengelola hub IoT di langganan Azure Anda.

Kode sumber | Paket (NPM) | Dokumentasi | referensi APISampel

Memulai

Lingkungan yang didukung saat ini

Lihat kebijakan dukungan kami untuk detail selengkapnya.

Prasyarat

Pasang paket @azure/arm-iothub

Instal pustaka klien Azure iotHub untuk JavaScript dengan npm:

npm install @azure/arm-iothub

Membuat dan mengautentikasi IotHubClient

Untuk membuat objek klien untuk mengakses Azure iotHub API, Anda memerlukan endpoint sumber daya Azure iotHub dan credential. Klien Azure iotHub dapat menggunakan kredensial Azure Active Directory untuk mengautentikasi. Anda dapat menemukan titik akhir untuk sumber daya Azure iotHub Anda di Portal Microsoft 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, harap instal @azure/identity paket:

npm install @azure/identity

Anda juga perlu mendaftarkan aplikasi AAD baru dan memberikan akses ke Azure iotHub dengan menetapkan peran yang sesuai untuk perwakilan layanan Anda (catatan: peran seperti "Owner" tidak akan memberikan izin yang diperlukan). Atur nilai ID klien, ID penyewa, dan rahasia klien aplikasi AAD sebagai variabel lingkungan: AZURE_CLIENT_ID, , AZURE_TENANT_IDAZURE_CLIENT_SECRET.

Untuk informasi selengkapnya tentang cara membuat Aplikasi Azure AD, lihat panduan ini.

const { IotHubClient } = require("@azure/arm-iothub");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new IotHubClient(new DefaultAzureCredential(), subscriptionId);

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new IotHubClient(credential, subscriptionId);

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

IotHubClient

IotHubClient adalah antarmuka utama untuk pengembang yang menggunakan pustaka klien Azure iotHub. Jelajahi metode pada objek klien ini untuk memahami berbagai fitur layanan Azure iotHub yang dapat Anda akses.

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:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

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

Langkah berikutnya

Silakan lihat direktori sampel untuk contoh terperinci tentang cara menggunakan pustaka ini.

Berkontribusi

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

Tayangan