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:
+ Mengonboard perangkat hub ke hub Integrasi Terkelola.
+ Onboard satu atau lebih perangkat akhir ke hub.
+ Instal versi terbaru AWS CLI dari Referensi [AWS CLI Perintah Integrasi Terkelola](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/)
+ (Opsional) Berlangganan pemberitahuan acara [DEVICE\_DISCOVERY\_STATUS](managedintegrations-notifications.md#managedintegrations-notification-setup).
## 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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/start-device-discovery.html). `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**
`--protocol`Parameter menerima`ZIGBEE`,`ZWAVE`, atau`CUSTOM`.
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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/start-device-discovery.html) Terkelola. AWS CLI *
Untuk memverifikasi bahwa kemampuan perangkat telah diperbarui, lihat [Mendapatkan kemampuan hal yang dikelola](managedintegrations-sdk-v2-cookbook-ugs.md#managedintegrations-sdk-v2-cookbook-check-device-capabilties).
## 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](managedintegrations-notifications.md#managedintegrations-notification-setup).
### 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