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 dinamici. 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_sensor). Per ulteriori informazioni, consulta Indicizzazione del parco istanze.

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

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.

Parametri visualizzati nella console

Nella pagina dei dettagli del pacchetto software della AWS IoT console, il pannello Discovery mostra le metriche standard acquisite dall'ombra. $package

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.

Modelli di query

L'indicizzazione del parco istanze con Software Package Catalog utilizza la maggior parte delle funzionalità supportate (ad esempio, termini e frasi e campi di ricerca) che sono standard per l'indicizzazione del parco istanze. L'eccezione è che le query comparison e range non sono disponibili per la chiave version ($package) della copia shadow con nome riservata. Tuttavia, queste query sono disponibili per la chiave attributes. Per ulteriori informazioni, consulta Sintassi delle query.

Dati di esempio

Nota: per informazioni sulla copia shadow con nome riservata e la struttura relativa, consulta Copia shadow denominata riservata.

In questo esempio, un primo dispositivo viene denominato AnyThing e dispone dei seguenti pacchetti installati:

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:

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.

Raccolta della distribuzione delle versioni dei pacchetti tramite getBucketsAggregation

Oltre al pannello Discovery all'interno della AWS IoT console, è possibile ottenere informazioni sulla distribuzione della versione del pacchetto utilizzando l'GetBucketsAggregationAPIoperazione. Per ottenere informazioni sulla distribuzione delle versioni dei pacchetti, devi eseguire le seguenti operazioni:

Per ulteriori informazioni, consulta la sezione Campi personalizzati nell'indicizzazione del AWS IoT parco veicoli.