Yerleşik doğrudan yöntemler kullanarak edgeAgent ile iletişim kurma

Şunun için geçerlidir:IoT Edge 1.6 onay işareti IoT Edge 1.6

Önemli

IoT Edge 1.6 LTS desteklenen sürümdür. IoT Edge 1.5 LTS desteği 10 Kasım 2026'da sona erer; IoT Edge 1.4 LTS, 12 Kasım 2024'te ömrünün sonuna ulaştı. Önceki bir sürümü kullanıyorsanız bkz. Update IoT Edge.

IoT Edge aracısı modülündeki doğrudan yöntemleri kullanarak IoT Edge dağıtımlarını izleyin ve yönetin. Doğrudan yöntemler cihazda uygulanır ve buluttan çağrılabilir. IoT Edge aracısı, IoT Edge cihazları uzaktan izlemek ve yönetmek için doğrudan yöntemler içerir.

Doğrudan yöntemler, bunları kullanma ve bunları kendi modüllerinizde uygulama hakkında daha fazla bilgi için bkz. IoT Hub'dan doğrudan yöntemleri anlama ve çağırma.

Bu doğrudan yöntemlerin adları büyük/küçük harfe duyarsızdır.

Ping

ping yöntemi bir cihazda IoT Edge çalışıp çalışmadığını veya cihazın IoT Hub ile açık bir bağlantısı olup olmadığını denetler. IoT Edge aracısına ping göndermek ve durumunu denetlemek için bu yöntemi kullanın. Başarılı bir ping boş bir yük ve "durum" döndürür: 200.

Örneğin:

az iot hub invoke-module-method --method-name 'ping' -n <hub name> -d <device name> -m '$edgeAgent'

Azure portalında ping yöntem adını ve {} boş bir JSON yükünü kullanarak yöntemini çağırın.

Azure portalında doğrudan yöntem ping'in nasıl çağrıldığının ekran görüntüsü.

Modülü yeniden başlatma

RestartModule yöntemi, IoT Edge bir cihazda çalışan modülleri uzaktan yönetmenizi sağlar. Bir modül başarısız bir durum veya iyi durumda olmayan bir davranış bildirirse, yeniden başlatmak için IoT Edge aracısını tetikler. Başarılı bir yeniden başlatma komutu ,"status": 200 olan boş bir yük döndürür.

RestartModule yöntemi, IoT Edge sürüm 1.0.9'dan itibaren kullanılabilir.

İpucu

Azure portalındaki IoT Edge sorun giderme sayfası, modüllerin yeniden başlatılmasını kolaylaştırır. Daha fazla bilgi için bkz. Monitor ve Azure portalından IoT Edge cihaz sorunlarını giderme.

edgeAgent modülü de dahil olmak üzere IoT Edge bir cihazda çalışan tüm modüllerde RestartModule doğrudan yöntemini kullanın. EdgeAgent'ı kapatmak için bu doğrudan yöntemi kullanırsanız, modülü yeniden başlatma sırasında bağlantı kesildiğinden başarılı bir sonuç almazsınız.

Örneğin:

az iot hub invoke-module-method --method-name 'RestartModule' -n <hub name> -d <device name> -m '$edgeAgent' --method-payload \
'
    {
        "schemaVersion": "1.0",
        "id": "<module name>"
    }
'

Azure portalında, aşağıdaki JSON yüküyle RestartModule yöntem adını kullanın:

{
    "schemaVersion": "1.0",
    "id": "<module name>"
}

Azure portalında RestartModule doğrudan yöntemini çağırma ekran görüntüsü.

Tanılama doğrudan yöntemleri

  • GetModuleLogs: Doğrudan yöntemin yanıtında modül günlüklerini alın.
  • UploadModuleLogs: Modül günlüklerini alın ve Azure Blob Depolama yükleyin.
  • UploadSupportBundle: Destek paketiyle modül günlüklerini alın ve Azure Blob Depolama bir zip dosyası yükleyin.
  • GetTaskStatus: Karşıya yükleme günlüklerinin veya destek paketi isteğinin durumunu denetleyin.

Bu doğrudan tanılama yöntemleri 1.0.10 sürümünden itibaren kullanılabilir.

Sonraki adımlar

IoT Edge aracısının ve IoT Edge hub modülü ikizlerinin Özellikleri

  • Last updated on