View a markdown version of this page

Penemuan kembali kemampuan - Integrasi Terkelola untuk AWS IoT Device Management
PrasyaratKapan menggunakan kemampuan penemuan kembaliMulai penemuan kembali kemampuanPemecahan masalah

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Penemuan kembali kemampuan

Bagian ini menjelaskan langkah-langkah untuk mempelajari kembali informasi kemampuan perangkat untuk perangkat yang terhubung dengan hub menggunakan penemuan kembali kemampuan.

Prasyarat

Selesaikan langkah-langkah ini sebelum mencoba penemuan kembali kemampuan:

Kapan menggunakan kemampuan penemuan kembali

Gunakan penemuan kembali kemampuan dalam skenario berikut:

  • Setelah pembaruan firmware ke perangkat akhir yang menambahkan atau memodifikasi kemampuan perangkat

  • Setelah pembaruan perangkat lunak hub yang memungkinkan dukungan untuk fitur perangkat baru

  • Ketika kemampuan perangkat tidak tercermin secara akurat dalam Integrasi Terkelola

  • Untuk menyegarkan informasi kemampuan untuk satu perangkat atau semua perangkat yang terhubung ke hub

Mulai penemuan kembali kemampuan

Mulai penemuan kembali kemampuan hub Anda untuk memperbarui kemampuan perangkat.

Untuk memulai penemuan kembali kemampuan

  • Gunakan perintah start-device-discovery dengan tipe penemuan. CONTROLLER_CAPABILITY_REDISCOVERY

    start-device-discoverycontoh

    # For a single device
aws iot-managed-integrations start-device-discovery \
  --discovery-type CONTROLLER_CAPABILITY_REDISCOVERY \
  --controller-identifier HUB_MANAGED_THING_ID \
  --protocol PROTOCOL \
  --end-device-identifier DEVICE_MANAGED_THING_ID

# For all devices on a protocol
aws iot-managed-integrations start-device-discovery \
  --discovery-type CONTROLLER_CAPABILITY_REDISCOVERY \
  --controller-identifier HUB_MANAGED_THING_ID \
  --protocol PROTOCOL

    Tanggapan:

    {
    "Id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "StartedAt": "2026-01-12T23:07:49.275Z"
}
    catatan

    --protocolParameter menerimaZIGBEE,ZWAVE, atauCUSTOM.

    Jika --end-device-identifier parameter opsional tidak disediakan, semua perangkat yang terkait dengan hub untuk protokol yang dipilih akan ditemukan kembali.

    Untuk informasi selengkapnya, lihat perintah start-device-discovery di Referensi Perintah Integrasi Terkelola. AWS CLI

Untuk memverifikasi bahwa kemampuan perangkat telah diperbarui, lihat Mendapatkan kemampuan hal yang dikelola.

Pemecahan masalah

Gunakan panduan berikut untuk memecahkan masalah umum dengan penemuan kembali kemampuan. Ketika penemuan kembali kemampuan sedang berlangsung, Integrasi Terkelola mengirimkan pemberitahuan melalui Kinesis atau EventBridge sebagai pesan JSON.

Pemberitahuan sukses

Per perangkat yang sedang diproses:

{
    "messageType": "DEVICE_DISCOVERY_STATUS",
    // Capability rediscovery with controller and end device
    "resources": ["arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/abc123def456", "arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/xyz789uvw012"],
    "payload": {
        "deviceDiscoveryId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "status": "RUNNING",
        "deviceCount": 1
    }
}

Penyelesaian:

{
    "messageType": "DEVICE_DISCOVERY_STATUS",
    // Capability rediscovery with controller only
    "resources": ["arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/abc123def456"],
    "payload": {
        "deviceDiscoveryId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "status": "SUCCEEDED",
        "deviceCount": 0
    }
}

Pemberitahuan kegagalan

Kegagalan perangkat:

{
    "messageType": "DEVICE_DISCOVERY_STATUS",
    // Capability rediscovery with controller and end device
    "resources": ["arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/abc123def456", "arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/ghi345jkl678"],
    "payload": {
        "deviceDiscoveryId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "status": "RUNNING",
        "deviceCount": 1,
        "error": {
            "code": "500",
            "message": "Device unreachable",
            "managedThingId": "ghi345jkl678"
        }
    }
}

Kegagalan total:

{
    "messageType": "DEVICE_DISCOVERY_STATUS",
    // Capability rediscovery with controller only
    "resources": ["arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/abc123def456"],
    "payload": {
        "deviceDiscoveryId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "status": "FAILED",
        "deviceCount": 0,
        "error": {
            "code": "404",
            "message": "Specified controller does not exist"
        }
    }
}

Tidak ada pemberitahuan yang diterima

Jika Anda tidak menerima pemberitahuan tentang status penemuan, verifikasi bahwa Anda telah berlangganan pemberitahuan DEVICE_DISCOVERY_STATUS acara. Untuk informasi lebih lanjut tentang mengatur notifikasi, lihat Mengatur notifikasi Integrasi Terkelola.

Beberapa perangkat tidak diperbarui

Jika beberapa perangkat gagal memperbarui selama penemuan kembali kemampuan, periksa pesan kesalahan di DEVICE_DISCOVERY_STATUS notifikasi. Pesan kesalahan umum meliputi:

  • Device unreachable- Perangkat sedang offline atau tidak merespons

  • Timeout querying device- Perangkat tidak merespons dalam jangka waktu yang diharapkan

  • Invalid capability report- Firmware perangkat mungkin memiliki masalah

Untuk mengatasi masalah ini, pastikan perangkat yang terpengaruh dinyalakan dan dapat dijangkau, lalu coba kembali penemuan kembali kemampuan untuk perangkat yang gagal secara individual menggunakan parameter. --end-device-identifier

Penemuan tidak pernah selesai

Jika proses penemuan kembali kemampuan tidak selesai, periksa status penemuan menggunakan ID pekerjaan penemuan yang dikembalikan dari start-device-discovery perintah:

aws iot-managed-integrations get-device-discovery \
  --identifier DISCOVERY_JOB_ID

Jika penemuan macet:

  • Verifikasi bahwa hub sedang online dan terhubung ke Integrasi Terkelola

  • Tunggu hingga 15 menit hingga waktu tunggu penemuan secara otomatis

  • Coba lagi penemuan kembali kemampuan setelah mengonfirmasi hub dan perangkat beroperasi