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 dell'indicizzazione del parco istanze
L'indicizzazione del parco istanze consente di gestire automaticamente due tipi di indici: l'indicizzazione di oggetti e l'indicizzazione di gruppi di oggetti.
## Indicizzazione degli oggetti
L'indice creato per tutti i tuoi oggetti è chiamato `AWS_Things`. L'indicizzazione degli oggetti supporta le seguenti origini dati: dati di [registro di AWS IoT](thing-registry.md), [dati di AWS IoT Device Shadow ](iot-device-shadows.md), dati di [connettività di AWS IoT](life-cycle-events.md) e dati di violazioni di [AWS IoT Device Defender](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/what-is-device-defender.html). Aggiungendo queste origini dei dati alla configurazione di indicizzazione del parco istanze, puoi cercare oggetti, eseguire query su dati aggregati e creare gruppi di oggetti dinamici e parametri del parco istanze in base alle tue query di ricerca.
**Registro:AWS IoT fornisce un registro** che ti aiuta a gestire le cose. È possibile aggiungere i dati di registro alla configurazione di indicizzazione del parco istanze per cercare i dispositivi in base ai nomi degli oggetti, alle descrizioni e ad altri attributi del registro. Per ulteriori informazioni sul registro, consulta [Come gestire gli oggetti con il registro](thing-registry.md).
**Shadow**: il [servizio Device Shadow AWS IoT](iot-device-shadows.md) fornisce copie shadow che facilitano l'archiviazione dei dati sullo stato del dispositivo. L'indicizzazione degli oggetti supporta sia le classiche copie shadow senza nome che le copie shadow con nome. Per indicizzare le copie shadow denominate, attiva le impostazioni delle tue copie shadow denominate e specificane i nomi nella configurazione di indicizzazione oggetti. Per impostazione predefinita, è possibile aggiungere fino a 10 nomi shadow per persona Account AWS. Per informazioni su come aumentare il limite del numero di nomi delle copie shadow, consulta [AWS IoT Device Management Quotas](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits) nella *Guida di riferimento di AWS *.
Per aggiungere copie shadow specifiche per l'indicizzazione:
+ Se utilizzi la [console AWS IoT](https://console.aws.amazon.com/iot/home), attiva l'**indicizzazione di oggetti**, scegli **Add named shadows** (Aggiungi copie shadow denominate), quindi aggiungi i nomi delle copie shadow tramite **Named shadow selection** (Selezione della copia shadow denominata).
+ Se usate il AWS Command Line Interface (AWS CLI), impostate su `namedShadowIndexingMode` be e `ON` specificate i nomi delle ombre in [https://docs.aws.amazon.com//iot/latest/apireference/API_IndexingFilter.html](https://docs.aws.amazon.com//iot/latest/apireference/API_IndexingFilter.html). Per gli esempi di comandi della CLI, consulta [Manage thing indexing](managing-index.md#enable-index) (Gestione dell'indicizzazione di oggetti).
**Importante**
Il 20 luglio 2022 è disponibile la versione General Availability (GA) dell'integrazione dell'indicizzazione della flotta di AWS IoT Device Management con shadow AWS IoT Core denominati e AWS IoT Device Defender rilevamento delle violazioni. Con questo rilascio pubblico, potrai indicizzare copie shadow denominate specificando i nomi delle copie shadow. Se hai aggiunto le tue copie shadow denominate per l'indicizzazione durante il periodo di anteprima pubblica di questa funzione, ovvero dal 30 novembre 2021 al 19 luglio 2022, ti invitiamo a riconfigurare le impostazioni di indicizzazione del parco istanze e scegliere nomi di copie shadow specifici per ridurre i costi di indicizzazione e ottimizzare le prestazioni.
Per ulteriori informazioni sulle shadow, consulta [Servizio Device Shadow AWS IoT](iot-device-shadows.md).
**Connettività**: i dati di connettività del dispositivo consentono di identificare lo stato di connessione dei dispositivi. Questi dati di connettività sono guidati da [eventi del ciclo di vita](life-cycle-events.md). Quando un client si connette o si disconnette, AWS IoT pubblica eventi del ciclo di vita con messaggi su argomenti MQTT. Un messaggio di connessione o disconnessione può essere un elenco di elementi JSON che forniscono dettagli sullo stato della connessione. Per ulteriori informazioni sulla connettività del dispositivo, consulta [Eventi del ciclo di vita](life-cycle-events.md).
**Violazioni di Device Defender**: i dati AWS IoT Device Defender sulle violazioni aiutano a identificare i comportamenti anomali dei dispositivi rispetto ai comportamenti normali definiti in un profilo di sicurezza. Un profilo di sicurezza contiene un set di comportamenti previsti del dispositivo. Ogni comportamento utilizza un parametro che specifica il comportamento normale dei dispositivi. [Per ulteriori informazioni sulle violazioni di Device Defender, consulta detect.AWS IoT Device Defender](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/device-defender-detect.html)
Per ulteriori informazioni, consulta [Gestione dell'indicizzazione degli oggetti](managing-index.md).
## Indicizzazione di gruppi di oggetti
`AWS_ThingGroups` è l'indice che contiene tutti i tuoi gruppi di oggetti. Questo indice consente di cercare gruppi in base al nome del gruppo, alla descrizione, agli attributi e a tutti i nomi del gruppo padre.
Per ulteriori informazioni, consulta [Gestione dell'indicizzazione di gruppi di oggetti](thinggroup-index.md).
## Campi gestiti
I campi gestiti contengono dati associati a oggetti, gruppi di oggetti, ombre dei dispositivi, connettività dei dispositivi e violazioni di Device Defender. AWS IoT definisce il tipo di dati nei campi gestiti. Si specificano i valori di ogni campo gestito quando si crea un AWS IoT oggetto. Ad esempio i nomi degli oggetti, i gruppi di oggetti e le descrizioni degli oggetti sono tutti campi gestiti. L'indicizzazione del parco istanze indica i campi gestiti in base alla modalità di indicizzazione che specifici. I campi gestiti non possono essere modificati o visualizzati in `customFields`. Per ulteriori informazioni, consulta [Custom fields (Personalizza campi)](#custom-field).
Di seguito sono elencati i campi gestiti per l'indicizzazione delle cose:
+ Campi gestiti per il Registro di sistema
```
"managedFields" : [
{name:thingId, type:String},
{name:thingName, type:String},
{name:registry.version, type:Number},
{name:registry.thingTypeName, type:String},
{name:registry.thingGroupNames, type:String},
]
```
+ Campi gestiti per shadow classiche senza nome
```
"managedFields" : [
{name:shadow.version, type:Number},
{name:shadow.hasDelta, type:Boolean}
]
```
+ Campi gestiti per shadow con nome
```
"managedFields" : [
{name:shadow.name.shadowName.version, type:Number},
{name:shadow.name.shadowName.hasDelta, type:Boolean}
]
```
+ Campi gestiti per la connettività degli oggetti
```
"managedFields" : [
{name:connectivity.timestamp, type:Number},
{name:connectivity.version, type:Number},
{name:connectivity.connected, type:Boolean},
{name:connectivity.disconnectReason, type:String}
]
```
+ Campi gestiti per Device Defender
```
"managedFields" : [
{name:deviceDefender.violationCount, type:Number},
{name:deviceDefender.securityprofile.behaviorname.metricName, type:String},
{name:deviceDefender.securityprofile.behaviorname.lastViolationTime, type:Number},
{name:deviceDefender.securityprofile.behaviorname.lastViolationValue, type:String},
{name:deviceDefender.securityprofile.behaviorname.inViolation, type:Boolean}
]
```
+ Campi gestiti per i gruppi di oggetti
```
"managedFields" : [
{name:description, type:String},
{name:parentGroupNames, type:String},
{name:thingGroupId, type:String},
{name:thingGroupName, type:String},
{name:version, type:Number},
]
```
Nella tabella seguente sono elencati i campi gestiti che non sono ricercabili.
| Origine dati | Il campo gestito non è ricercabile |
| --- | --- |
| Registro | registry.version |
| Copie shadow senza nome | shadow.version |
| Copie shadow con nome | shadow.name.\$1.version |
| Device Defender | deviceDefender.version |
| Gruppi di oggetti | version |
## Campi personalizzati
È possibile aggregare gli attributi degli oggetti, i dati di Device Shadow e i dati delle violazioni di Device Defender creando campi personalizzati per indicizzarli. L'attributo `customFields` è un elenco di coppie di nomi di campi e tipi di dati. È possibile eseguire query di aggregazione in base al tipo di dati. La modalità di indicizzazione che scegli influenza i campi che è possibile specificare in `customFields`. Ad esempio, se si specifica la modalità di indicizzazione `REGISTRY`, non è possibile specificare un campo personalizzato da una copia shadow dell'oggetto. È possibile utilizzare il comando [update-indexing-configuration](https://docs.aws.amazon.com/cli/latest/reference/iot/update-indexing-configuration.html)CLI per creare o aggiornare i campi personalizzati (vedere un comando di esempio in [Aggiornamento degli esempi di configurazione dell'indicizzazione](managing-index.md#update-index-examples)).
+ **Nomi di campo personalizzati**
I nomi dei campi personalizzati per gli attributi di oggetti e gruppi di oggetti iniziano con `attributes.`, seguito dal nome dell'attributo. Se l'indicizzazione delle copie shadow senza nome è attiva, gli oggetti possono avere nomi di campo personalizzati che iniziano con `shadow.desired` o `shadow.reported`, seguito dal nome del valore dei dati delle copie shadow senza nome. Se l'indicizzazione delle copie shadow con nome è attiva, gli oggetti possono avere nomi di campo personalizzati che iniziano con `shadow.name.*.desired.` o `shadow.name.*.reported.`, seguito dal valore dei dati delle copie shadow con nome. Se l'indicizzazione delle violazioni di Device Defender è attiva, gli oggetti possono avere nomi di campo personalizzati che iniziano con `deviceDefender.`, seguito dal valore dei dati delle violazioni di Device Defender.
Il nome dell'attributo o del valore dei dati che segue il prefisso può contenere solo caratteri alfanumerici, - (trattino) e \$1 (carattere di sottolineatura). Non può avere spazi.
Se è presente un'incongruenza di tipo tra un campo personalizzato nella configurazione e il valore indicizzato, il servizio di indicizzazione del parco istanze ignora il valore incoerente per le query di aggregazione. CloudWatch I log sono utili per la risoluzione dei problemi relativi alle query di aggregazione. Per ulteriori informazioni, consulta [Risoluzione dei problemi delle query di aggregazione per il servizio di indicizzazione del parco istanze](fleet-indexing-troubleshooting.md#aggregation-troubleshooting).
+ **Tipi di campo personalizzati**
I tipi di campo personalizzati hanno i seguenti valori supportati: `Number`, `String`, e `Boolean`.