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 di componente ai modelli di asset). Quindi colloca il modello in ACTIVE uno stato.

Se la definizione del modello fornita non è valida, AWS IoT SiteWise colloca 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 dei modelli hanno due tipi di versioni del modello:

  1. Versione più recente: la definizione più recente 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 descrizioni APIs 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 modelli di asset corrispondenti. 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 o transitorio UPDATINGPROPAGATING, l'ultima versione restituisce la definizione del modello di asset che non è ancora stata propagata agli asset in questione. In questo caso, è necessario restituire ai clienti la versione attiva del modello di asset.

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 recuperare la versione attiva.

    1. Se il modello è in uno ACTIVE stato, stai visualizzando la sua versione attiva.

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

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 di componenti come un tipo di modello di asset. Pertanto, si utilizza la stessa DescribeAssetModeloperazione per entrambi i tipi di modello. Il assetModelType campo nella risposta indica se è un ASSET_MODEL o 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. Replace (Sostituisci) asset-model-id con l'ID o l'ID esterno del modello di asset o del modello di componente. L'ID esterno è un ID definito dall'utente. Per ulteriori informazioni, consulta Oggetti di riferimento con oggetti esterni IDs 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"
}