Gestione dei parametri del parco istanze - AWS IoT Core
Gestione dei parametri del parco istanze (Console)Gestione dei parametri del parco istanze (CLI)Autorizzazione dell'assegnazione di tag delle risorse IoT

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

Gestione dei parametri del parco istanze

Questo argomento mostra come utilizzare la AWS IoT console e AWS CLI gestire i parametri del parco veicoli.

Gestione dei parametri del parco istanze (Console)

Le sezioni seguenti mostrano come utilizzare la AWS IoT console per gestire le metriche del parco veicoli. Assicurati di aver abilitato l'indicizzazione del parco istanze con origini dati e configurazioni associate prima di creare parametri del parco istanze.

Abilita l'indicizzazione del parco istanze

Se hai già abilitato l'indicizzazione del parco istanze, salta questa sezione.

Se non hai abilitato l'indicizzazione del parco istanze, segui queste istruzioni.

  1. Apri la AWS IoT console all'indirizzo https://console.aws.amazon.com/iot/.

  2. AWS IoT Nel menu, scegli Impostazioni.

  3. Per visualizzare le impostazioni dettagliate, sulla pagina Impostazioni, scorri verso il basso fino alla sezione Indicizzazione del parco istanze.

  4. Per aggiornare le impostazioni di indicizzazione del parco istanze, a destra della sezione Indicizzazione del parco istanza, seleziona Gestione dell'indicizzazione.

  5. Sulla pagina Gestione dell'indicizzazione del parco istanze, aggiorna le impostazioni di indicizzazione del parco istanze in base alle tue esigenze.

    • Configurazione

      Per attivare l'indicizzazione degli oggetti, attiva Indicizzazione degli oggetti, quindi seleziona le origini dati da cui vuoi indicizzare.

      Per attivare l'indicizzazione del gruppo di oggetti, attiva Indicizzazione di gruppi di oggetti.

    • Campi personalizzati per l'aggregazione (facoltativo)

      I campi di ricerca personalizzati sono un elenco di coppie di nomi di campo e tipi di campo.

      Per aggiungere una coppia di campi personalizzata, scegli Aggiungi nuovo campo. Inserisci un nome di campo personalizzato come attributes.temperature, quindi seleziona un tipo di campo dal menu Tipo di campo. Nota che il nome di un campo personalizzato inizia con attributes. e verrà salvato come attributo per eseguire query di aggregazioni di oggetti.

      Per aggiornare e salvare l'impostazione, scegli Aggiorna.

Crea un parametro del parco istanze

  1. Apri la AWS IoT console all'indirizzo https://console.aws.amazon.com/iot/.

  2. AWS IoT Nel menu, scegli Gestisci, quindi scegli Fleet metrics.

  3. Sulla pagina Parametri del parco istanza, scegli Crea un parametro del parco istanze e completa i passaggi di creazione.

  4. Nel passaggio 1 Configurazione dei parametri del parco istanze

    • Nella sezione Query, inserisci una stringa di query per specificare gli oggetti o i gruppi di oggetti che desideri che eseguano la ricerca aggregata. La stringa di query è costituita da un attributo e da un valore. Per Proprietà, scegli l'attributo desiderato oppure, se non viene visualizzato nell'elenco, inserisci l'attributo nel campo. Inserire il valore dopo :. Una stringa di query di esempio può essere thingName:TempSensor*. Per ogni stringa di query inserita, premi invio sulla tastiera. Se inserisci più stringhe di query, specifica la relazione selezionando e, o, e non, oppure o no tra di loro.

    • In Proprietà del report, scegli Nome indice, Tipo di aggregazione, e Campo di aggregazione dalle rispettive liste. Quindi, seleziona i dati in cui desideri aggregare Seleziona dati, dove è possibile selezionare più valori di dati.

    • Seleziona Avanti.

  5. Nella fase 2 Specificazione delle proprietà del parametro del parco istanze

    • Nel campo Nome parametro del parco istanza, inserisci un nome per il parametro del parco istanze che stai creando.

    • Nel campo Descrizione - opzionale, inserisci una descrizione per il parametro del parco istanze che stai creando. Questo campo è facoltativo.

    • Nei campi Ore e Minuti, inserisci l'ora (con quale frequenza) in cui desideri che la metrica della flotta emetta i dati. CloudWatch

    • Seleziona Avanti.

  6. Nella fase 3 Revisione e creazione

    • Revisiona le impostazioni della fase 1 e fase 2. Per modificare le impostazioni, scegli Modifica.

    • Scegli Crea parametro del parco istanze.

Dopo una creazione riuscita, il parametro del parco istanze è elencato sulla pagina Parametro del parco istanze.

Aggiorna una parametro del parco istanze

  1. Sulla pagina Parametro del parco istanze, scegli il parametro del parco istanze che desideri aggiornare.

  2. Sulla pagina Dettagli del parametro del parco istanze, scegli Modifica. In questo modo si aprono le fasi di creazione in cui è possibile aggiornare il parametro del parco istanze in una delle tre fasi.

  3. Dopo aver completato l'aggiornamento del parametro del parco istanze, scegli Aggiorna parametro del parco istanze.

Elimina un parametro del parco istanze

  1. Sulla pagina Parametro del parco istanze, scegli il parametro del parco istanze che desideri eliminare.

  2. Nella pagina successiva che mostra i dettagli del parametro del parco istanze, scegli Elimina.

  3. Nella finestra di dialogo, inserisci il nome del parametro del parco istanze per confermare l'eliminazione.

  4. Scegli Elimina. Questa fase elimina definitivamente il parametro del parco istanze.

Gestione dei parametri del parco istanze (CLI)

Le sezioni seguenti mostrano come utilizzare le metriche della flotta AWS CLI per gestire. Assicurati di aver abilitato l'indicizzazione del parco istanze con origini dati e configurazioni associate prima di creare parametri del parco istanze. Per abilitare l'indicizzazione del parco istanze per oggetti o gruppi di oggetti, segui le istruzioni in Gestione dell'indicizzazione degli oggetti o Gestione dell'indicizzazione di gruppi di oggetti.

Crea un parametro del parco istanze

È possibile utilizzare il comando create-fleet-metric CLI per creare una metrica del parco veicoli. 

aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum

L'output di questo comando contiene il nome e Amazon Resource Name (ARN) del parametro del parco istanze. L'output sarà simile al seguente:

{
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "metricName": "YourFleetMetricName"
}

Elenco parametri del parco istanze

Puoi utilizzare il comando list-fleet-metric CLI per elencare tutte le metriche della flotta nel tuo account. 

aws iot list-fleet-metrics

L'output di questo comando contiene tutti i parametri del parco istanze. L'output sarà simile al seguente:

{
    "fleetMetrics": [
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric1", 
            "metricName": "YourFleetMetric1"
        }, 
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric2", 
            "metricName": "YourFleetMetric2"
        }
    ]
}

Descrivi un parametro del parco istanze

È possibile utilizzare il comando describe-fleet-metric CLI per visualizzare informazioni più dettagliate su una metrica della flotta. 

aws iot describe-fleet-metric --metric-name "YourFleetMetricName"

L'output del comando contiene le informazioni dettagliate sul parametro del parco istanze specificato. L'output sarà simile al seguente:

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625790642.355, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "sum"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625790642.355, 
    "metricName": "YourFleetMetricName"
}

Aggiorna una parametro del parco istanze

È possibile utilizzare il comando update-fleet-metric CLI per aggiornare una metrica del parco veicoli. 

aws iot update-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 120 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum,count --index-name AWS_Things

Il update-fleet-metric comando non produce alcun output. Puoi usare il comando describe-fleet-metric CLI per vedere il risultato.

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625792300.881, 
    "queryString": "*", 
    "period": 120, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 2, 
    "aggregationType": {
        "values": [
            "sum", 
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625792300.881, 
    "metricName": "YourFleetMetricName"
}

Elimina un parametro del parco istanze

Utilizza il comando delete-fleet-metric CLI per eliminare una metrica della flotta. 

aws iot delete-fleet-metric --metric-name "YourFleetMetricName"

Questo comando non produce alcun output se l'eliminazione va a buon fine oppure se specifichi un parametro del parco istanze che non esiste.

Per ulteriori informazioni, consulta Risoluzione dei problemi dei parametri del parco istanze.

Autorizzazione dell'assegnazione di tag delle risorse IoT

Per un migliore controllo sulle metriche della flotta che puoi creare, modificare o utilizzare, puoi allegare tag alle metriche del parco veicoli.

Per etichettare le metriche della flotta create utilizzando AWS Management Console or AWS CLI, devi includere l'iot:TagResourceazione nella tua policy IAM per concedere le autorizzazioni all'utente. Se la tua policy IAM non lo includeiot:TagResource, qualsiasi azione volta a creare una metrica della flotta con un tag restituirà un errore. AccessDeniedException

Per informazioni generali sull'etichettatura delle risorse, consulta Tagging your resources. AWS IoT

Esempio di policy IAM

Fai riferimento al seguente esempio di policy IAM che concede le autorizzazioni per l'etichettatura quando crei una metrica della flotta:

{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Action": [
				"iot:TagResource"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		},
		{
			"Action": [
				"iot:CreateFleetMetric"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:index/*",
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		}
	]
}

Per ulteriori informazioni, consulta Operazioni, risorse e chiavi di condizione per AWS IoT.