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

Şunlar için geçerlidir: IoT Edge 1.4

Önemli

IoT Edge 1.4 desteklenen sürümdür. Önceki bir sürümdeyseniz bkz. IoT Edge’i güncelleştirme.

IoT Edge aracı modülünde yer alan doğrudan yöntemleri kullanarak IoT Edge dağıtımlarını izleyin ve yönetin. Doğrudan yöntemler cihazda uygulanır ve ardından buluttan çağrılabilir. IoT Edge aracısı, IoT Edge cihazlarınızı uzaktan izlemenize ve yönetmenize yardımcı olan 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ız olarak işlenir.

Ping

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

Örnek:

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

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

Modülü yeniden başlatma

RestartModule yöntemi, ioT Edge cihazında çalışan modüllerin uzaktan yönetilmesine olanak tanır. Modül başarısız bir durum veya başka bir iyi durumda olmayan davranış bildiriyorsa IoT Edge aracısını yeniden başlatmak için tetikleyebilirsiniz. Başarılı bir yeniden başlatma komutu boş bir yük ve "status" döndürür: 200.

RestartModule yöntemi IoT Edge sürüm 1.0.9 ve sonraki sürümlerde kullanılabilir.

Bahşiş

Azure portalındaki IoT Edge sorun giderme sayfası modülleri yeniden başlatmak için basitleştirilmiş bir deneyim sağlar. Daha fazla bilgi için bkz . Azure portalından IoT Edge cihazlarını izleme ve sorunlarını giderme.

RestartModule doğrudan yöntemini edgeAgent modülünün kendisi de dahil olmak üzere ioT Edge cihazında çalışan herhangi bir modülde kullanabilirsiniz. Ancak edgeAgent'ı kapatmak için bu doğrudan yöntemi kullanırsanız, modül yeniden başlatılırken bağlantı kesildiğinden başarılı bir sonuç almazsınız.

Örnek:

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 yöntemini yöntem adı RestartModule ve aşağıdaki JSON yüküyle çağırın:

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

Tanılama doğrudan yöntemleri

• GetModuleLogs: Doğrudan yöntemin yanıtında satır içi modül günlüklerini alın.
• UploadModuleLogs: Modül günlüklerini alın ve Azure Blob Depolama yükleyin.
• UploadSupportBundle: Destek paketini kullanarak modül günlüklerini alın ve Azure Blob Depolama zip dosyasını karşıya 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