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
<a name="model-active-version"></a>

 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.

1. **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 `UPDATING``PROPAGATING`, 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. 

**Topics**
+ [Recuperate la versione attiva di un modello di asset o di un modello di componente (console)](#active-console)
+ [Recuperate la versione attiva di un modello di asset o di un modello di componente ()AWS CLI](#active-cli)

## Recuperate la versione attiva di un modello di asset o di un modello di componente (console)
<a name="active-console"></a>

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. <a name="sitewise-open-console"></a>Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. <a name="sitewise-choose-models"></a>Nel riquadro di navigazione selezionare **Models (Modelli)**.

1. Scegliete il modello per recuperare la versione attiva.

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

   1.  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
<a name="active-cli"></a>

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'[DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)operazione con il `assetModelVersion` parametro.

**Suggerimento**  
 AWS CLI definisce i modelli di componenti come un tipo di modello di asset. Pertanto, si utilizza la stessa [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)operazione per entrambi i tipi di modello. Il `assetModelType` campo nella risposta indica se è un `ASSET_MODEL` o un`COMPONENT_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. {{asset-model-id}}Sostituitelo 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](object-ids.md#external-id-references) 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}}"
  }
  ```