View a markdown version of this page

Versioni del modello di asset - AWS IoT SiteWise
Recuperate la versione attiva di un modello di asset o di un modello di componente (console)Recuperate la versione attiva di un modello di asset o di un modello di componente (AWS CLI)

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

Versioni del modello di asset

AWS IoT SiteWise supporta l'elaborazione asincrona delle operazioni di creazione e aggiornamento su modelli di asset e modelli di componenti. Inoltre, aggiorna lo stato del modello.

AWS IoT SiteWise propaga le modifiche di un modello valido nelle richieste di creazione e aggiornamento alle risorse dipendenti (dal modello di asset agli asset o dal modello dei componenti ai modelli di asset). Quindi posiziona il modello in ACTIVE stato.

Se la definizione del modello fornita non è valida, AWS IoT SiteWise pone il modello in uno FAILED stato. Le modifiche non vengono propagate alle risorse dipendenti. Le risorse dipendenti si riferiscono all'ultima definizione del modello propagata quando il modello era in uno ACTIVE stato.

In base alle informazioni di cui sopra, le definizioni del modello hanno due tipi di versioni del modello:

  1. Versione più recente: l'ultima definizione accettata come parte di una richiesta di creazione o aggiornamento.

  2. Versione attiva: l'ultima definizione è stata elaborata correttamente e lo stato del modello èACTIVE.

Per impostazione predefinita, i dettagli della versione più recente del modello vengono restituiti quando le API di descrizione vengono richiamate su un modello di asset o un modello di componente. Esistono scenari in cui è necessaria la versione attiva del modello di asset o del modello di componente. Di seguito sono riportati gli scenari di esempio:

  • Un'operazione di aggiornamento con una definizione non valida pone il modello di asset in uno FAILED stato. È necessario annullare le modifiche recuperando la versione attiva del modello di asset e creando un'altra richiesta di aggiornamento che faccia riferimento a questa definizione valida.

  • AWS IoT SiteWise Esiste un'applicazione in cui i clienti possono visualizzare gli asset e i relativi modelli di asset. Quando un utente fa riferimento alla definizione del modello di asset corrispondente a un particolare asset e il modello di asset si trova in uno FAILED stato transitorio UPDATINGPROPAGATING, o transitorio, l'ultima versione restituisce la definizione del modello di asset che non è ancora stata propagata agli asset. In questo caso, è necessario recuperare la versione attiva del modello di asset per i clienti.

Recuperate la versione attiva di un modello di asset o di un modello di componente (console)

Seguite questa procedura per recuperare la versione attiva di un modello di asset o di un modello di componente nella AWS IoT SiteWise console.

Suggerimento

I modelli di asset e i modelli di componenti sono entrambi elencati in Modelli nel pannello di navigazione. Il pannello Dettagli del modello di asset o del modello di componente selezionato indica di che tipo si tratta.

Per recuperare la versione attiva di un modello di asset o di un modello di componente (console)

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione selezionare Models (Modelli).

  3. Scegliete il modello per recuperarne la versione attiva.

    1. Se il modello è in uno ACTIVE stato, ne state visualizzando la versione attiva.

    2. Se il modello è in uno FAILED stato transitorio UPDATINGPROPAGATING, o transitorio, trova Visualizza versione attiva in Stato nel pannello Dettagli.

Recuperate la versione attiva di un modello di asset o di un modello di componente (AWS CLI)

Utilizzate il AWS CLI per recuperare la versione attiva di un modello di asset o di un modello di componente.

Per recuperare la versione attiva di un modello di asset o di un modello di componente, utilizzate l'DescribeAssetModeloperazione con il assetModelVersion parametro.

Suggerimento

AWS CLI Definisce i modelli dei componenti come un tipo di modello di asset. Pertanto, si utilizza la stessa DescribeAssetModel operazione per entrambi i tipi di modello. Il assetModelType campo nella risposta indica se si tratta di un ASSET_MODEL o di unCOMPONENT_MODEL.

Per recuperare la versione attiva di un modello di asset o di un modello di componente (AWS CLI)

  • Eseguite il comando seguente per descrivere il modello. Sostituisci asset-model-id con l'ID o l'ID esterno del modello di asset o del modello del componente. L'ID esterno è un ID definito dall'utente. Per ulteriori informazioni, consulta Oggetti di riferimento con ID esterni nella Guida per l'utente di AWS IoT SiteWise .

    aws iotsitewise describe-asset-model --asset-model-id asset-model-id --asset-model-version ACTIVE

    L'operazione restituisce una risposta con i dettagli del modello. La risposta contiene un assetModelStatus oggetto con la seguente struttura.

    {
    ...
    "assetModelName": "string",
    "assetModelProperties": [ ... ],
    ...,
    "assetModelVersion": "string"
}