As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Redescoberta de capacidades

Esta seção descreve as etapas para reaprender as informações de capacidade do dispositivo para dispositivos conectados ao hub usando a redescoberta de recursos.

Pré-requisitos

Conclua estas etapas antes de tentar a redescoberta da capacidade:

Quando usar a redescoberta de capacidades

Use a redescoberta de capacidades nos seguintes cenários:

Inicie a redescoberta de capacidades

Inicie a redescoberta de recursos em seu hub para atualizar os recursos do dispositivo.

Para verificar se os recursos do dispositivo foram atualizados, consulte os recursos de Get managed thing.

Solução de problemas

Use as diretrizes a seguir para solucionar problemas comuns com a redescoberta de recursos. Quando a redescoberta de recursos está em andamento, as Integrações Gerenciadas enviam notificações por meio do Kinesis ou EventBridge como mensagens JSON.

Notificações de sucesso

Por dispositivo que está sendo processado:

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

Conclusão:

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

Notificações de falha

Falha no dispositivo:

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

Falha completa:

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

Nenhuma notificação recebida

Se você não receber notificações sobre o status da descoberta, verifique se você se inscreveu para receber notificações de DEVICE_DISCOVERY_STATUS eventos. Para obter mais informações sobre a configuração de notificações, consulte Configurar notificações de integrações gerenciadas.

Alguns dispositivos não atualizados

Se alguns dispositivos falharem na atualização durante a redescoberta da capacidade, verifique as mensagens de erro nas DEVICE_DISCOVERY_STATUS notificações. As mensagens de erro mais comuns incluem:

Para resolver esses problemas, certifique-se de que os dispositivos afetados estejam ligados e acessíveis e, em seguida, tente redescobrir a capacidade dos dispositivos com falha individualmente usando o parâmetro. --end-device-identifier

A descoberta nunca termina

Se o processo de redescoberta da capacidade não for concluído, verifique o status da descoberta usando o ID do trabalho de descoberta retornado pelo start-device-discovery comando:

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

Se a descoberta travar: