Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para AWS IoT Events. Después del 20 de mayo de 2026, ya no podrás acceder a la AWS IoT Events consola ni a AWS IoT Events los recursos. Para obtener más información, consulta [AWS IoT Events el fin del soporte](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Analice un modelo de detector en AWS IoT Events (AWS CLI)
<a name="analyze-api-api"></a>

El análisis programático de los modelos de sus AWS IoT Events detectores proporciona información valiosa sobre su estructura, comportamiento y rendimiento. Este enfoque basado en la API permite el análisis automatizado, la integración con los flujos de trabajo existentes y la capacidad de realizar operaciones masivas en varios modelos de detectores. Al aprovechar la [StartDetectorModelAnalysis](https://docs.aws.amazon.com/iotevents/latest/apireference/API_StartDetectorModelAnalysis.html)API, puede iniciar exámenes exhaustivos de sus modelos, lo que le ayudará a identificar posibles problemas, optimizar los flujos lógicos y garantizar que su procesamiento de eventos de IoT se alinee con los requisitos de su negocio.

Los siguientes pasos se utilizan AWS CLI para analizar un modelo de detector.

**Para analizar un modelo de detector mediante AWS CLI**

1. Ejecute el siguiente comando para iniciar un análisis.

   ```
   aws iotevents start-detector-model-analysis --cli-input-json file://file-name.json
   ```
**nota**  
*file-name*Sustitúyalo por el nombre del archivo que contiene la definición del modelo de detector.  
**Example Definición del 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"
       }
   }
   ```

   Si utiliza AWS CLI para analizar un modelo de detector existente,  elija una de las siguientes opciones para recuperar la definición del modelo de detector:
   + Si desea utilizar la AWS IoT Events consola, haga lo siguiente:

     1. En el panel de navegación, seleccione **Modelos de detectores**.

     1. En **Modelos de detectores**, seleccione el modelo de detector deseado.

     1. Seleccione **Exportar modelo de detector** en **Acción** para descargar el modelo de detector. El modelo de detector se guarda en JSON.

     1. Abra el archivo JSON del modelo de detector.

     1. Solo necesita el objeto `detectorModelDefinition`. Elimine lo siguiente:
        + La primera llave (`{`) en la parte superior de la página
        + La línea `detectorModel`
        + El objeto `detectorModelConfiguration`.
        + La última llave (`}`) en la parte inferior de la página

     1. Guarde el archivo.
   + Si desea utilizar el AWS CLI, haga lo siguiente:

     1. Ejecute el comando siguiente en un terminal.

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

     1. *detector-model-name*Sustitúyalo por el nombre del modelo de su detector.

     1. Copie el objeto `detectorModelDefinition` en un editor de texto.

     1. Añada llaves (`{}`) fuera de `detectorModelDefinition`.

     1. Guarde el archivo en JSON.  
**Example Ejemplo de respuesta**  

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

1. Copie el ID de análisis de la salida.

1. Ejecute el siguiente comando para recuperar el estado del análisis.

   ```
   aws iotevents describe-detector-model-analysis --analysis-id "analysis-id"
   ```
**nota**  
*analysis-id*Sustitúyalo por el identificador de análisis que copió.  
**Example Ejemplo de respuesta**  

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

   El estado puede ser uno de los siguientes valores:
   + `RUNNING`— AWS IoT Events está analizando su modelo de detector. El proceso puede tardar hasta un minuto en completarse.
   + `COMPLETE`— AWS IoT Events ha terminado de analizar su modelo de detector.
   + `FAILED`— no AWS IoT Events pudo analizar su modelo de detector. Inténtelo de nuevo más tarde.

1. Ejecute el siguiente comando para recuperar uno o más resultados de análisis del modelo de detector.
**nota**  
*analysis-id*Sustitúyalo por el identificador de análisis que copió.

   ```
   aws iotevents get-detector-model-analysis-results --analysis-id "analysis-id"
   ```  
**Example Ejemplo de respuesta**  

   ```
   {
       "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**  
Una vez que AWS IoT Events comience a analizar el modelo de detector, dispondrá de hasta 24 horas para recuperar los resultados del análisis.