Aviso de fim do suporte: em 20 de maio de 2026, AWS encerrará o suporte para AWS IoT Events. Depois de 20 de maio de 2026, você não poderá mais acessar o AWS IoT Events console ou os AWS IoT Events recursos. Para obter mais informações, consulte [AWS IoT Events Fim do suporte](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).

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á.

# Analise um modelo de detector em AWS IoT Events (AWS CLI)
<a name="analyze-api-api"></a>

A análise programática de seus modelos de AWS IoT Events detectores fornece informações valiosas sobre sua estrutura, comportamento e desempenho. Essa abordagem baseada em API permite análise automatizada, integração com seus fluxos de trabalho existentes e a capacidade de realizar operações em massa em vários modelos de detectores. Ao aproveitar a [StartDetectorModelAnalysis](https://docs.aws.amazon.com/iotevents/latest/apireference/API_StartDetectorModelAnalysis.html)API, você pode iniciar exames detalhados de seus modelos, ajudando a identificar possíveis problemas, otimizar fluxos lógicos e garantir que o processamento de eventos de IoT esteja alinhado aos requisitos de sua empresa.

As etapas a seguir usam o AWS CLI para analisar um modelo de detector.

**Para analisar um modelo de detector usando AWS CLI**

1. Execute o comando a seguir para iniciar uma análise.

   ```
   aws iotevents start-detector-model-analysis --cli-input-json file://file-name.json
   ```
**nota**  
*file-name*Substitua pelo nome do arquivo que contém a definição do modelo do detector.  
**Example Definição do modelo de detector**  

   ```
   {
       "detectorModelDefinition": {
           "states": [
               {
                   "stateName": "TemperatureCheck",
                   "onInput": {
                       "events": [
                           {
                               "eventName": "Temperature Received",
                               "condition": "isNull($input.TemperatureInput.sensorData.temperature)==false",
                               "actions": [
                                   {
                                       "iotTopicPublish": {
                                           "mqttTopic": "IoTEvents/Output"
                                       }
                                   }
                               ]
                           }
                       ],
                       "transitionEvents": []
                   },
                   "onEnter": {
                       "events": [
                           {
                               "eventName": "Init",
                               "condition": "true",
                               "actions": [
                                   {
                                       "setVariable": {
                                           "variableName": "temperatureChecked",
                                           "value": "0"
                                       }
                                   }
                               ]
                           }
                       ]
                   },
                   "onExit": {
                       "events": []
                   }
               }
           ],
           "initialStateName": "TemperatureCheck"
       }
   }
   ```

   Se você usar o AWS CLI para analisar um modelo de detector existente,  escolha uma das opções a seguir para recuperar a definição do modelo de detector:
   + Se você quiser usar o AWS IoT Events console, faça o seguinte:

     1. No painel de navegação à esquerda, escolha **Modelos de detector**.

     1. Em **Modelos de detector**, escolha o modelo do detector alvo.

     1. Escolha **Exportar modelo de detector** em **Ação** para baixar o modelo do detector. O modelo do detector é salvo em JSON.

     1. Abra o arquivo JSON do modelo do detector.

     1. Você só precisa do objeto `detectorModelDefinition`. Remova o seguinte:
        + O primeiro colchete (`{`) na parte superior da página
        + A linha `detectorModel`
        + O objeto `detectorModelConfiguration`
        + O último colchete (`}`) na parte inferior da página

     1. Salve o arquivo.
   + Se você quiser usar o AWS CLI, faça o seguinte:

     1. Execute o comando a seguir em um terminal.

        ```
        aws iotevents describe-detector-model --detector-model-name detector-model-name
        ```

     1. *detector-model-name*Substitua pelo nome do modelo do seu detector.

     1. Copie o objeto `detectorModelDefinition` em um editor de textos.

     1. Adicione colchetes (`{}`) fora do `detectorModelDefinition`.

     1. Salve o arquivo em JSON.  
**Example Exemplo de resposta**  

   ```
   {
       "analysisId": "c1133390-14e3-4204-9a66-31efd92a4fed"
   }
   ```

1. Copie a ID da análise da saída.

1. Execute o comando a seguir para recuperar o status da análise.

   ```
   aws iotevents describe-detector-model-analysis --analysis-id "analysis-id"
   ```
**nota**  
*analysis-id*Substitua pela ID de análise que você copiou.  
**Example Exemplo de resposta**  

   ```
   {
       "status": "COMPLETE"
   }
   ```

   O status pode ser um dos valores a seguir:
   + `RUNNING`— AWS IoT Events está analisando seu modelo de detector. O processo pode levar até um minuto para ser concluído.
   + `COMPLETE`— AWS IoT Events terminou de analisar seu modelo de detector.
   + `FAILED`— AWS IoT Events não foi possível analisar seu modelo de detector. Tente novamente mais tarde.

1. Execute o comando a seguir para recuperar um ou mais resultados de análise do modelo de detector.
**nota**  
*analysis-id*Substitua pela ID de análise que você copiou.

   ```
   aws iotevents get-detector-model-analysis-results --analysis-id "analysis-id"
   ```  
**Example Exemplo de resposta**  

   ```
   {
       "analysisResults": [
           {
               "type": "data-type",
               "level": "INFO",
               "message": "Inferred data types [Integer] for $variable.temperatureChecked",
               "locations": []
           },
           {
               "type": "referenced-resource",
               "level": "ERROR",
               "message": "Detector Model Definition contains reference to Input 'TemperatureInput' that does not exist.",
               "locations": [
                   {
                       "path": "states[0].onInput.events[0]"
                   }
               ]
           }
       ]
   }
   ```

**nota**  
Depois de AWS IoT Events começar a analisar seu modelo de detector, você tem até 24 horas para recuperar os resultados da análise.