Avviso di fine del supporto: il 20 maggio 2026, AWS terminerà il supporto per AWS IoT Events. Dopo il 20 maggio 2026, non potrai più accedere alla AWS IoT Events console o AWS IoT Events alle risorse. Per ulteriori informazioni, consulta [AWS IoT Events Fine del supporto](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-end-of-support.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Analizza un modello di rilevatore in AWS IoT Events ()AWS CLI
<a name="analyze-api-api"></a>

L'analisi programmatica dei modelli di AWS IoT Events rilevatori fornisce informazioni preziose sulla struttura, il comportamento e le prestazioni. Questo approccio basato su API consente l'analisi automatizzata, l'integrazione con i flussi di lavoro esistenti e la possibilità di eseguire operazioni di massa su più modelli di rilevatori. Sfruttando l'[StartDetectorModelAnalysis](https://docs.aws.amazon.com/iotevents/latest/apireference/API_StartDetectorModelAnalysis.html)API, puoi avviare esami approfonditi dei tuoi modelli, aiutandoti a identificare potenziali problemi, ottimizzare i flussi logici e garantire che l'elaborazione degli eventi IoT sia in linea con i requisiti aziendali.

I passaggi seguenti utilizzano il per analizzare un modello di AWS CLI rilevatore.

**Per analizzare un modello di rilevatore utilizzando AWS CLI**

1. Eseguite il comando seguente per avviare un'analisi.

   ```
   aws iotevents start-detector-model-analysis --cli-input-json file://file-name.json
   ```
**Nota**  
*file-name*Sostituitelo con il nome del file che contiene la definizione del modello del rilevatore.  
**Example Definizione del modello di rilevatore**  

   ```
   {
       "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 utilizzate il AWS CLI per analizzare un modello di rilevatore esistente,  scegliete una delle seguenti opzioni per recuperare la definizione del modello di rilevatore:
   + Se desideri utilizzare la AWS IoT Events console, procedi come segue:

     1. Nel riquadro di navigazione, scegli **Modelli di rilevatori**.

     1. In **Modelli di rilevatori**, scegli il modello di rilevatore di destinazione.

     1. Scegli **Esporta modello di rilevatore** da **Action** per scaricare il modello di rilevatore. Il modello del rilevatore viene salvato in JSON.

     1. Aprire il file JSON del modello del rilevatore.

     1. Ti serve solo l'oggetto. `detectorModelDefinition` Rimuovi quanto segue:
        + La prima parentesi riccia (`{`) nella parte superiore della pagina
        + La linea `detectorModel`
        + Oggetto `detectorModelConfiguration`
        + L'ultima parentesi riccia (`}`) nella parte inferiore della pagina

     1. Salvare il file.
   + Se desideri utilizzare il AWS CLI, procedi come segue:

     1. Esegui il comando seguente in un terminale:

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

     1. Sostituiscilo *detector-model-name* con il nome del modello del tuo rilevatore.

     1. Copiate l'`detectorModelDefinition`oggetto in un editor di testo.

     1. Aggiungete parentesi graffe (`{}`) all'esterno di. `detectorModelDefinition`

     1. Salvate il file in JSON.  
**Example response**  

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

1. Copia l'ID di analisi dall'output.

1. Eseguite il comando seguente per recuperare lo stato dell'analisi.

   ```
   aws iotevents describe-detector-model-analysis --analysis-id "analysis-id"
   ```
**Nota**  
*analysis-id*Sostituiscilo con l'ID di analisi che hai copiato.  
**Example response**  

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

   Lo stato può avere uno dei seguenti valori:
   + `RUNNING`— AWS IoT Events sta analizzando il modello del rilevatore. Il completamento di questo processo può richiedere fino a un minuto.
   + `COMPLETE`— AWS IoT Events ha terminato l'analisi del modello del rilevatore.
   + `FAILED`— AWS IoT Events non è stato possibile analizzare il modello del rilevatore. Riprova più tardi.

1. Eseguite il comando seguente per recuperare uno o più risultati di analisi del modello di rilevatore.
**Nota**  
*analysis-id*Sostituiscilo con l'ID di analisi che hai copiato.

   ```
   aws iotevents get-detector-model-analysis-results --analysis-id "analysis-id"
   ```  
**Example response**  

   ```
   {
       "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**  
Dopo aver AWS IoT Events iniziato ad analizzare il modello del rilevatore, avete fino a 24 ore per recuperare i risultati dell'analisi.