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.
**Topics**
+ [Gestione dei parametri del parco istanze (Console)](#managing-fleet-metrics-console)
+ [Gestione dei parametri del parco istanze (CLI)](#managing-fleet-metrics-cli)
+ [Autorizzazione dell'assegnazione di tag delle risorse IoT](#managing-fleet-metrics-policy)
## 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/](https://console.aws.amazon.com/iot/).
1. AWS IoT Nel menu, scegli **Impostazioni**.
1. Per visualizzare le impostazioni dettagliate, sulla pagina **Impostazioni**, scorri verso il basso fino alla sezione **Indicizzazione del parco istanze**.
1. Per aggiornare le impostazioni di indicizzazione del parco istanze, a destra della sezione **Indicizzazione del parco istanza**, seleziona **Gestione dell'indicizzazione**.
1. 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](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html).
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/](https://console.aws.amazon.com/iot/).
1. AWS IoT Nel menu, scegli **Gestisci**, quindi scegli **Fleet metrics**.
1. Sulla pagina **Parametri del parco istanza**, scegli **Crea un parametro del parco istanze** e completa i passaggi di creazione.
1. 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.
+ Scegli **Next (Successivo)**.
1. 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
+ Scegli **Next (Successivo)**.
1. 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.
1. 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.
1. 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.
1. Nella pagina successiva che mostra i dettagli del parametro del parco istanze, scegli **Elimina**.
1. Nella finestra di dialogo, inserisci il nome del parametro del parco istanze per confermare l'eliminazione.
1. 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](managing-index.md#enable-index) o [Gestione dell'indicizzazione di gruppi di oggetti](thinggroup-index.md#enable-group-index).
### Crea un parametro del parco istanze
È possibile utilizzare il comando create-fleet-metric CLI per creare una metrica della flotta.
```
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 comando update-fleet-metric non produce 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](fleet-indexing-troubleshooting.md#fleet-metrics-troubleshooting).
## 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 della flotta.
Per etichettare le metriche della flotta create utilizzando Console di gestione AWS or AWS CLI, devi includere l'`iot:TagResource`azione nella tua policy IAM per concedere le autorizzazioni all'utente. Se la tua policy IAM non lo include`iot: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](https://docs.aws.amazon.com//iot/latest/developerguide/tagging-iot.html) 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](https://docs.aws.amazon.com//service-authorization/latest/reference/list_awsiot.html).