翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

機能の再検出

このセクションでは、機能の再検出を使用してハブに接続されたデバイスのデバイス機能情報を再学習する手順について説明します。

前提条件

機能の再検出を試みる前に、以下のステップを実行します。

機能の再検出を使用するタイミング

以下のシナリオでは、機能の再検出を使用します。

機能の再検出を開始する

ハブの機能の再検出を開始して、デバイス機能を更新します。

デバイス機能が更新されたことを確認するには、「Get managed thing capabilities」を参照してください。

トラブルシューティング

以下のガイダンスを使用して、機能の再検出に関する一般的な問題のトラブルシューティングを行います。機能の再検出が進行中の場合、 Managed Integrations は Kinesis または EventBridge を介して JSON メッセージとして通知を送信します。

成功通知

処理中のデバイスあたり:

{
    "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
    }
}

完了:

{
    "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
    }
}

失敗通知

デバイス障害:

{
    "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"
        }
    }
}

完全な失敗:

{
    "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"
        }
    }
}

通知は受信されません

検出ステータスに関する通知を受信しない場合は、DEVICE_DISCOVERY_STATUSイベント通知をサブスクライブしていることを確認します。通知の設定の詳細については、「マネージド統合通知をセットアップする」を参照してください。

一部のデバイスは更新されていません

機能の再検出中に一部のデバイスを更新できない場合は、DEVICE_DISCOVERY_STATUS通知のエラーメッセージを確認してください。一般的なエラーメッセージとしては以下があります。

これらの問題を解決するには、影響を受けるデバイスに電源が入っていて到達可能であることを確認し、 --end-device-identifierパラメータを使用して障害が発生したデバイスの機能の再検出を個別に再試行します。

検出は完了しません

機能の再検出プロセスが完了しない場合は、 start-device-discovery コマンドから返された検出ジョブ ID を使用して検出ステータスを確認します。

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

検出が停止している場合: