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

# Aggiorna modelli compositi personalizzati (componenti)
<a name="update-custom-composite-models"></a>

È possibile utilizzare l' AWS IoT SiteWise API per aggiornare un modello composito personalizzato o la AWS IoT SiteWise console per aggiornare i componenti.

**Topics**
+ [Aggiorna un componente (console)](#update-custom-composite-model-console)
+ [Aggiornate un modello composito personalizzato (AWS CLI)](#update-custom-composite-model-cli)

## Aggiorna un componente (console)
<a name="update-custom-composite-model-console"></a>

È possibile utilizzare la AWS IoT SiteWise console per aggiornare un componente.

**Per aggiornare un 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 di asset in cui si trova il componente.

1. Nella scheda **Proprietà**, scegliete **Componenti**.

1. Scegliete il componente che desiderate aggiornare.

1. Scegli **Modifica**.

1. Nella pagina **Modifica componente**, effettuate una delle seguenti operazioni:
   + In **Dettagli del modello** modifica il **nome** del modello.
   + Modifica una delle **definizioni degli attributi**. Non è possibile modificare il **tipo di dati** degli attributi esistenti. Per ulteriori informazioni, consulta [Definisci dati statici (attributi)](attributes.md).
   + Modifica una delle **definizioni di misurazione**. Non è possibile modificare il **tipo di dati** delle misurazioni esistenti. Per ulteriori informazioni, consulta [Definisci i flussi di dati provenienti dalle apparecchiature (misurazioni)](measurements.md).
   + Modifica una delle **definizioni di trasformazione**. Per ulteriori informazioni, consulta [Trasforma i dati (trasformazioni)](transforms.md).
   + Modifica una delle **definizioni di parametro**. Non è possibile modificare l'**intervallo di tempo** dei parametri esistenti. Per ulteriori informazioni, consulta [Aggrega i dati provenienti da proprietà e altre risorse (metriche)](metrics.md).

1. Scegli **Save** (Salva).

## Aggiornate un modello composito personalizzato (AWS CLI)
<a name="update-custom-composite-model-cli"></a>

Utilizzate il AWS Command Line Interface (AWS CLI) per aggiornare un modello composito personalizzato.

Per aggiornare il nome o la descrizione, utilizzate l'[UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html)operazione. Solo per i modelli compositi personalizzati in linea, puoi anche aggiornare le proprietà. Non è possibile aggiornare le proprietà di un modello composito component-model-based personalizzato, poiché il modello di componente a cui fa riferimento fornisce le proprietà associate.

**Importante**  
Se rimuovete una proprietà da un modello composito personalizzato, AWS IoT SiteWise elimina tutti i dati precedenti relativi a quella proprietà. Non è possibile modificare il tipo o il tipo di dati di una proprietà esistente.  
Per sostituire una proprietà esistente del modello composito con una nuova con la stessa proprietà`name`, procedi come segue:  
Inviate una `UpdateAssetModelCompositeModel` richiesta con l'intera proprietà esistente rimossa.
Invia una seconda `UpdateAssetModelCompositeModel` richiesta che includa la nuova proprietà. La nuova proprietà dell'asset avrà la `name` stessa di quella precedente e AWS IoT SiteWise genererà una nuova proprietà univoca`id`.

**Per aggiornare un modello composito personalizzato (AWS CLI)**

1. Per recuperare la definizione del modello composito esistente, eseguite il comando seguente. Sostituitelo *composite-model-id* con l'ID o l'ID esterno del modello composito personalizzato da aggiornare e *asset-model-id* con il modello di asset a cui è associato il modello composito personalizzato. Per ulteriori informazioni, consulta la *Guida per l'utente AWS IoT SiteWise *.

   1. Eseguite il comando seguente:

      ```
      aws iotsitewise describe-asset-model-composite-model \
      --asset-model-composite-model-id composite-model-id \
      --asset-model-id asset-model-id
      ```

   1.  Il comando precedente restituisce la definizione del modello composito corrispondente all'ultima versione del modello associato. Per un caso d'uso in cui un modello di asset si trova in uno `FAILED` stato, recuperate la definizione di modello valida corrispondente alla sua versione attiva per creare la richiesta di aggiornamento. Per informazioni dettagliate, vedi [Versioni del modello di asset](model-active-version.md). 

   1. Eseguite il comando seguente per recuperare la definizione attiva del modello:

      ```
      aws iotsitewise describe-asset-model-composite-model \
      --asset-model-composite-model-id composite-model-id \
      --asset-model-id asset-model-id \
      --asset-model-version ACTIVE
      ```

   1. Per maggiori informazioni, vedi l'operazione [DescribeAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModelCompositeModel.html).

1. Create un file chiamato`update-custom-composite-model.json`, quindi copiate la risposta del comando precedente nel file.

1. Rimuovi ogni coppia chiave-valore dall'oggetto JSON ad `update-custom-composite-model.json` eccezione dei seguenti campi:
   + `assetModelCompositeModelName`
   + `assetModelCompositeModelDescription`(se presente)
   + `assetModelCompositeModelProperties`(se presente)

1. In `update-custom-composite-model.json`, effettua una delle seguenti operazioni:
   + Modificare il valore di`assetModelCompositeModelName`.
   + Aggiungi o `assetModelCompositeModelDescription` rimuovi o modificane il valore.
   + Solo per i modelli compositi personalizzati in linea: modifica, aggiungi o rimuovi qualsiasi proprietà del modello di asset in`assetModelCompositeModelProperties`.

   Per ulteriori informazioni sul formato richiesto per questo file, consultate la sintassi della richiesta per. [UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html)

1. Eseguite il comando seguente per aggiornare il modello composito personalizzato con la definizione memorizzata in`update-custom-composite-model.json`. Sostituiscilo *composite-model-id* con l'ID del modello composito e *asset-model-id* con l'ID del modello di asset in cui si trova.

   ```
   aws iotsitewise update-asset-model-composite-model \
   --asset-model-composite-model-id composite-model-id \
   --asset-model-id asset-model-id \
   --cli-input-json file://update-custom-composite-model.json
   ```

**Importante**  
 Quando più utenti aggiornano un modello di asset contemporaneamente, le modifiche di un utente possono essere inavvertitamente sovrascritte da un altro utente. Per evitare ciò, è necessario definire una richiesta di aggiornamento condizionale. Per informazioni, consulta [Blocco ottimistico per le scritture dei modelli di asset](opt-locking-for-model.md).