Azure DeviceUpdate client library for JavaScript - version 1.1.0

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

IoT Hub için Cihaz Güncellemesi, müşterilerin IoT cihazları için güncellemeleri buluta yayınlamasını ve ardından bu güncellemeyi cihazlarına dağıtmasını (IoT Hub'da yönetilen ve sağlanan cihaz gruplarına güncellemeleri onaylamalarını sağlayan bir Azure hizmetidir. IoT cihazları için optimize edilmiş Windows Update platformunun kanıtlanmış güvenliği ve güvenilirliğinden yararlanıyor. Küresel olarak çalışır ve cihazları ne zaman ve nasıl güncelleyeceğini bilir, böylece müşteriler iş hedeflerine odaklanabilir ve güncellemeleri Device Update for IoT Hub'un gerçekleştirmesine izin verir.

Önemli bağlantılar:

Başlangıç Yapmak

Şu anda desteklenen ortamlar

Daha fazla bilgi için bkz. destek ilkesi.

Prerequisites

@azure/iot-device-update paketini yükleme

JavaScript için Azure DeviceUpdate client library install with npm:

npm install @azure/iot-device-update

Bir DeviceUpdateClient oluşturun ve kimlik doğrulaması yapın.

Azure DeviceUpdate API'sine erişmek için bir istemci nesnesi oluşturmak için endpoint Azure DeviceUpdate kaynağınızın ve bir credential. Azure DeviceUpdate istemcisi, kimlik doğrulama için Azure Active Directory kimlik bilgilerini kullanabilir. Azure DeviceUpdate kaynağınızın uç noktasını Azure portal'da bulabilirsiniz.

@azure/identity kitaplığından bir kimlik bilgisi kullanarak veya mevcut AAD BelirteciAzure 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 bilgisi sağlayıcılarını kullanmak için lütfen @azure/identity paketini yükleyin:

npm install @azure/identity

Ayrıca yeni bir AAD uygulaması kaydetmeniz ve uygun rolü hizmet başayağınıza atayarak Azure DeviceUpdate'e erişim vermeniz gerekecek (not: Like "Owner" roller gerekli izinleri vermeyecek).

Azure AD Uygulaması oluşturma hakkında daha fazla bilgi içinbu kılavuzu göz atın.

Node.js ve Node benzeri ortamları kullanarak istemcinin kimliğini doğrulamak için DefaultAzureCredential sınıfını kullanabilirsiniz.

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

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

Tarayıcı ortamlarında kimlik doğrulaması yapmak için InteractiveBrowserCredential paketindeki @azure/identity kullanın.

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

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ütfenpaketleme belgelerimize bakın.

Temel kavramlar

DeviceUpdateClient

DeviceUpdateClientAzure DeviceUpdate istemci kütüphanesini kullanan geliştiriciler için birincil arayüzdür. Bu istemci nesnesi üzerindeki yöntemleri inceleyerek erişebileceğiniz Azure DeviceUpdate hizmetinin farklı özelliklerini keşfedin.

Troubleshooting

Logging

Loglamayı etkinleştirmek, hatalarla ilgili yararlı bilgilerin ortaya çıkması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, çalışma zamanında setLogLevel@azure/logger çağrılarak günlük tutma etkinleştirilebilir.

import { setLogLevel } from "@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.

Contributing

Bu kitaplığa katkıda bulunmak istiyorsanız kodu oluşturma ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzu okuyun.

  • JavaScript için Microsoft Azure SDK
  • Last updated on