JavaScript için Azure iotHub istemci kitaplığı - sürüm 6.3.0

  • Makale

Bu paket, Azure iotHub istemcisi için bir isomorphic SDK (hem Node.js hem de tarayıcılarda çalışır) içerir.

Azure aboneliğinizdeki IoT hub'larını yönetmek için bu API'yi kullanın.

Kaynak kodu | Paket (NPM) | API başvuru belgeleri | Örnekleri

Başlarken

Şu anda desteklenen ortamlar

Daha fazla ayrıntı için destek ilkemize bakın.

Önkoşullar

@azure/arm-iothub paketini yükleyin

ile npmJavaScript için Azure iotHub istemci kitaplığını yükleyin:

npm install @azure/arm-iothub

Oluşturma ve kimlik doğrulaması IotHubClient

Azure iotHub API'sine erişmek üzere bir istemci nesnesi oluşturmak için Azure iotHub kaynağınızın ve değerinin credentialolması gerekirendpoint. Azure iotHub istemcisi kimlik doğrulaması için Azure Active Directory kimlik bilgilerini kullanabilir. Azure iotHub kaynağınızın uç noktasını Azure Portal'da bulabilirsiniz.

@azure/kimlik kitaplığından veya mevcut bir AAD Belirtecinden kimlik bilgilerini kullanarak Azure Active Directory ile kimlik doğrulaması yapabilirsiniz.

Aşağıda gösterilen DefaultAzureCredential sağlayıcısını veya Azure SDK ile sağlanan diğer kimlik bilgileri sağlayıcılarını kullanmak için lütfen paketi yükleyin @azure/identity :

npm install @azure/identity

Ayrıca hizmet sorumlunuza uygun rolü atayarak yeni bir AAD uygulaması kaydetmeniz ve Azure iotHub'a erişim vermeniz gerekir (not: gibi "Owner" roller gerekli izinleri vermez). AAD uygulamasının istemci kimliği, kiracı kimliği ve istemci gizli dizisi değerlerini ortam değişkenleri olarak ayarlayın: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Azure AD Uygulaması oluşturma hakkında daha fazla bilgi için bu kılavuzu gözden geçirin.

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

JavaScript Paketi

Bu istemci kitaplığını tarayıcıda kullanmak için önce bir paketleyici kullanmanız gerekir. Bunun nasıl yapılacağının ayrıntıları için lütfen paketleme belgelerimize bakın.

Önemli kavramlar

IotHubClient

IotHubClient , Azure iotHub istemci kitaplığını kullanan geliştiriciler için birincil arabirimdir. Azure iotHub hizmetinin erişebileceğiniz farklı özelliklerini anlamak için bu istemci nesnesinde yöntemleri keşfedin.

Sorun giderme

Günlüğe Kaydetme

Günlüğün etkinleştirilmesi hatalarla ilgili yararlı bilgilerin ortaya çıkarılmasına yardımcı olabilir. HTTP isteklerinin ve yanıtlarının günlüğünü görmek için ortam değişkenini AZURE_LOG_LEVEL olarak infoayarlayın. Alternatif olarak, günlüğü çalışma zamanında içinde çağrılarak setLogLevel@azure/loggeretkinleştirilebilir:

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

Günlükleri etkinleştirme hakkında daha ayrıntılı yönergeler için @azure/günlükçü paketi belgelerine bakabilirsiniz.

Sonraki adımlar

Bu kitaplığın nasıl kullanılacağına ilişkin ayrıntılı örnekler için lütfen samples dizinine göz atın.

Katkıda bulunma

Bu kitaplığa katkıda bulunmak isterseniz, kodu derleme ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzunu okuyun.

İzlenimler