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à.
# Preparazione dell'indicizzazione del parco istanze
Con l'indicizzazione AWS IoT della flotta, puoi cercare e aggregare i dati utilizzando il nome riservato shadow (). `$package` [Puoi anche raggruppare gli AWS IoT oggetti interrogando i gruppi di oggetti [Copia shadow con nome riservata](preparing-to-use-software-package-catalog.md#reserved-named-shadow) dinamici.](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html) Ad esempio, è possibile trovare informazioni su quali AWS IoT elementi utilizzano una versione specifica del pacchetto, su quali non è installata una versione specifica del pacchetto o su quali non è installata alcuna versione del pacchetto. Puoi ottenere ulteriori informazioni dettagliate combinando gli attributi. Ad esempio, identificare gli elementi che hanno una versione specifica e sono di un tipo di oggetto specifico (come la versione 1.0.0 e il tipo di oggetto di pump\$1sensor). Per ulteriori informazioni, consulta [Indicizzazione del parco istanze](https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html).
## Impostazione della copia shadow `$package` come un'origine dati
Per utilizzare l'indicizzazione del parco istanze con Software Package Catalog, devi abilitare l'indicizzazione del parco istanze, impostare la copia shadow con nome come l'origine dati e definire `$package` come il filtro della copia shadow con nome. Se non hai abilitato l'indicizzazione del parco istanze, puoi abilitarla all'interno di questo processo. Da [AWS IoT Core](https://console.aws.amazon.com/iot/home) nella console, apri **Impostazioni**, scegli **Gestisci indicizzazione**, quindi seleziona **Aggiungi copie shadow denominate**, **Aggiunta di pacchetti software del dispositivo e versioni** e **Aggiorna**. Per ulteriori informazioni, consulta [Gestione dell'indicizzazione degli oggetti](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#thing-index).
In alternativa, puoi abilitare l'indicizzazione del parco istanze quando crei il primo pacchetto. Quando viene visualizzata la finestra di dialogo **Abilita dipendenze per la gestione dei pacchetti**, scegli l'opzione per aggiungere pacchetti e versioni software del dispositivo come origini dati all'indicizzazione del parco istanze. Selezionando questa opzione, abiliti anche l'indicizzazione del parco istanze.
**Nota**
L'abilitazione dell'indicizzazione del parco istanze per Software Package Catalog comporta costi di servizio standard. Per ulteriori informazioni, consulta [Prezzi di AWS IoT Device Management](https://aws.amazon.com/iot-device-management/pricing/).
## Parametri visualizzati nella console
![\[Immagine dei parametri standard\]](http://docs.aws.amazon.com/it_it/iot/latest/developerguide/images/package-catalog-discovery-metrics.png)
Nella pagina dei dettagli del pacchetto software della AWS IoT console, il pannello **Discovery** mostra le metriche standard acquisite dall'ombra. `$package`
+ Il grafico di **distribuzione della versione corrente** mostra il numero di dispositivi e la percentuale per le 10 versioni del pacchetto più recenti associate a un AWS IoT elemento tra tutti i dispositivi associati a questo pacchetto software. **Nota:** se il pacchetto software dispone di più versioni del pacchetto di quelle etichettate nel grafico, puoi trovarle raggruppate in **Altro**.
+ Nel **Grafico storico** viene visualizzato il numero di dispositivi associati alle versioni dei pacchetti selezionate in un periodo di tempo specificato. Il grafico è inizialmente vuoto finché non si seleziona un massimo di 5 versioni del pacchetto e si definisce l'intervallo di date e l'intervallo di tempo. Per selezionare i parametri del grafico, scegli **Impostazioni**. I dati visualizzati nel **Grafico storico** potrebbero essere diversi da quelli del grafico **Distribuzione della versione corrente** a causa della differenza nel numero di versioni del pacchetto visualizzate e anche perché puoi scegliere quali versioni del pacchetto analizzare nel **Grafico storico**. **Nota:** quando selezioni una versione del pacchetto da visualizzare, questa viene conteggiata ai fini del numero massimo di limiti dei parametri del parco istanze. Per ulteriori informazioni, consulta [Limiti e quote per l'indicizzazione del parco istanze](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
Per un altro metodo per ottenere informazioni dettagliate sulla raccolta della distribuzione delle versioni dei pacchetti, consulta [Raccolta della distribuzione delle versioni dei pacchetti tramite `getBucketsAggregation`](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-fleet-indexing.html#package-version-distribution).
## Modelli di query
L'indicizzazione del parco veicoli con Software Package Catalog utilizza la maggior parte delle funzionalità standard supportate (come termini, frasi e campi di ricerca). Tuttavia, gli operatori di confronto (ad esempio, minore di `<` e maggiore di`>`) e `range` le query non sono disponibili per la chiave riservata denominata shadow (). `$package` `version` Queste interrogazioni sono disponibili per la `attributes` chiave. Per ulteriori informazioni, consulta [Sintassi delle query](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html).
### Dati di esempio
**Nota:** per informazioni sulla copia shadow con nome riservata e la struttura relativa, consulta [Copia shadow denominata riservata](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-to-use-software-package-catalog.html#reserved-named-shadow).
In questo esempio, un primo dispositivo viene denominato `AnyThing` e dispone dei seguenti pacchetti installati:
+ Pacchetto software: `SamplePackage`
Versione del pacchetto: `1.0.0`
ID pacchetto: `1111`
L'aspetto della copia shadow è il seguente:
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
}
}
}
}
```
Un secondo dispositivo viene denominato `AnotherThing` e dispone dei seguenti pacchetti installati:
+ Pacchetto software: `SamplePackage`
Versione del pacchetto: `1.0.0`
ID pacchetto: `1111`
+ Pacchetto software: `OtherPackage`
Versione del pacchetto: `1.2.5`
ID pacchetto: `2222`
L'aspetto della copia shadow è il seguente:
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
},
"OtherPackage": {
"version": "1.2.5",
"attributes": {
"s3UrlForOtherPackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile2",
"packageID": "2222"
}
},
}
}
}
```
### Query di esempio
Nella tabella seguente vengono elencate query campione basate sulle device shadow di esempio per `AnyThing` e `AnotherThing`. Per ulteriori informazioni, consulta [Esempio di query per oggetti](https://docs.aws.amazon.com/iot/latest/developerguide/example-queries.html).
**Versione più recente di AWS IoT Device Tester for FreerTOS**
| **Informazioni richieste** | **Query** | **Risultato** |
| --- | --- | --- |
| Oggetti con installata una versione del pacchetto specifica | `shadow.name.$package.reported.SamplePackage.version:1.0.0` | `AnyThing`, `OtherThing` |
| Oggetti che non hanno una versione del pacchetto specifica installata | `NOT shadow.name.$package.reported.OtherPackage.version:1.2.5` | `AnyThing` |
| Qualsiasi dispositivo che utilizza una versione del pacchetto il cui ID pacchetto è maggiore di 1500 | `shadow.name.$package.reported.*.attributes.packageID>1500"` | `OtherThing` |
| Oggetti con installato un pacchetto specifico e con installati più pacchetti | `shadow.name.$package.reported.SamplePackage.version:1.0.0 AND shadow.name.$package.reported.totalCount:2` | `OtherThing` |
## Raccolta della distribuzione delle versioni dei pacchetti tramite `getBucketsAggregation`
Oltre al pannello **Discovery** all'interno della AWS IoT console, puoi anche ottenere informazioni sulla distribuzione della versione del pacchetto utilizzando l'operazione [https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html](https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html)API. Per ottenere informazioni sulla distribuzione delle versioni dei pacchetti, devi eseguire le seguenti operazioni:
+ Definisci un campo personalizzato all'interno dell'indicizzazione del parco istanze per ogni pacchetto software. **Nota:** la creazione di campi personalizzati conta ai fini delle [Service Quotas di indicizzazione del parco istanze AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
+ Formatta il campo personalizzato come segue:
`shadow.name.$package.reported..version`
Per ulteriori informazioni, consulta la sezione [Campi personalizzati](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#custom-field) nell'indicizzazione del AWS IoT parco veicoli.