Aracılığıyla paylaş

JavaScript için IoT Hub Rest İstemci kitaplığı için Azure Cihaz Güncelleştirmesi - sürüm 1.0.0

  • Makale

Kitaplık, müşterilerin IoT cihazları için güncelleştirmeleri buluta yayımlamasına ve ardından bu güncelleştirmeleri cihazlarına dağıtmasına olanak tanıyan IoT Hub için Cihaz Güncelleştirmesi hizmetine erişim sağlar (güncelleştirmeleri IoT Hub yönetilen ve sağlanan cihaz gruplarına onaylayın).

Bu kitaplığı kullanmak için lütfen hizmetin belgelerine ve REST istemci belgelerimize yoğun bir şekilde güvenin

Önemli bağlantılar:

Başlarken

Şu anda desteklenen ortamlar

  • Node.js sürüm 14.x.x veya üzeri

Önkoşullar

  • Microsoft Azure Aboneliği: Microsoft Azure hizmetlerini çağırmak için bir Azure aboneliği oluşturmanız gerekir
  • IoT Hub örneği için Cihaz Güncelleştirmesi
  • Azure IoT Hub örneği

@azure-rest/iot-device-update paketini yükleyin

ile npmJavaScript için Azure Iot Cihaz Güncelleştirmesi istemci kitaplığını yükleyin:

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

Oluşturma ve kimlik doğrulaması DeviceUpdate

Azure Active Directory (AAD) belirteci kimlik bilgilerini kullanmak için, @azure/kimlik kitaplığından alınan istenen kimlik bilgisi türünün bir örneğini sağlayın.

AAD ile kimlik doğrulaması yapmak için önce npm yüklemeniz @azure/identitygerekir.

Yüklemeden sonra, hangi kimlik bilgisi@azure/identity türünün kullanılacağını seçebilirsiniz. Örneğin, istemcinin kimliğini doğrulamak için DefaultAzureCredential kullanılabilir:

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

İstemcinin kimliğini doğrulamak için döndürülen belirteç kimlik bilgilerini kullanın:

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

Önemli kavramlar

REST İstemcisi

Bu müşteri REST müşterilerimizden biridir. Rest istemcisini nasıl kullanacağınızı burada okumanızı kesinlikle öneririz.

Örnekler

Aşağıdaki bölümde, istemcinizi başlatma ve kimlik doğrulamasından sonra tüm cihazları alma adımları gösterilmektedir.

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

Sorun giderme

Günlüğe Kaydetme

Günlüğe kaydetmenin 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:

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.

Sonraki adımlar

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