기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

기능 재검색

이 섹션에서는 기능 재검색을 사용하여 허브에 연결된 디바이스에 대한 디바이스 기능 정보를 재학습하는 단계를 설명합니다.

사전 조건

기능 재검색을 시도하기 전에 다음 단계를 완료합니다.

기능 재검색을 사용해야 하는 경우

다음 시나리오에서 기능 재검색을 사용합니다.

기능 재검색 시작

허브에 대한 기능 재검색을 시작하여 디바이스 기능을 업데이트합니다.

디바이스 기능이 업데이트되었는지 확인하려면 관리형 사물 기능 가져오기를 참조하세요.

문제 해결

다음 지침을 사용하여 기능 재검색과 관련된 일반적인 문제를 해결합니다. 기능 재검색이 진행 중이면 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

검색이 멈춘 경우: