

AWS L'IoT non FleetWise sarà più aperto a nuovi clienti a partire dal 30 aprile 2026. FleetWise I clienti AWS IoT esistenti possono continuare a utilizzare il servizio. La [Guida per la mobilità connessa AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) fornisce indicazioni su come sviluppare e implementare servizi modulari per soluzioni di mobilità connessa che possono essere utilizzate per ottenere funzionalità equivalenti a quelle dell' AWS IoT FleetWise.

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 un FleetWise veicolo AWS IoT
<a name="update-vehicle-cli"></a>

**Importante**  
L'accesso a determinate FleetWise funzionalità AWS IoT è attualmente limitato. Per ulteriori informazioni, consulta [AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise](fleetwise-regions.md).

Puoi utilizzare l'operazione [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)API per aggiornare un veicolo esistente. Gli esempi seguenti utilizzano AWS CLI.

Per aggiornare un veicolo, esegui il comando seguente.

Sostituiscilo {{file-name}} con il nome del file.json che contiene la configurazione del veicolo.

```
aws iotfleetwise update-vehicle --cli-input-json file://{{file-name}}.json
```

**Example — configurazione del veicolo**  
+ Sostituisci {{vehicle-name}} con l'ID del veicolo che desideri aggiornare.
+ (Facoltativo) Sostituiscilo {{model-manifest-ARN}} con l'ARN del modello di veicolo (manifesto del modello) che utilizzi per sostituire il modello di veicolo in uso.
+ (Facoltativo) Sostituiscilo {{decoder-manifest-ARN}} con l'ARN del manifesto del decoder associato al nuovo modello di veicolo specificato.
+ (Facoltativo) Sostituiscilo {{attribute-update-mode}} con gli attributi del veicolo.
  + `Merge`— Unisce nuovi attributi in attributi esistenti aggiornando gli attributi esistenti con nuovi valori e aggiungendo nuovi attributi se non esistono.

    Per esempio, se un veicolo ha i seguenti attributi:`{"color": "black", "fuelType": "electric"}`, e aggiorni il veicolo con i seguenti attributi:`{"color": "", "fuelType": "gasoline", "model": "x"}`, il veicolo aggiornato ha i seguenti attributi:`{"fuelType": "gasoline", "model": "x"}`.
  + `Overwrite`— Sostituire gli attributi esistenti con nuovi attributi.

    Ad esempio, se un veicolo ha i seguenti attributi: e `{"color": "black", "fuelType": "electric"}` si aggiorna il veicolo con l'`{"model": "x"}`attributo, il veicolo aggiornato dispone dell'`{"model": "x"}`attributo.

  Questo è necessario se nell'input sono presenti degli attributi.
+ (Facoltativo) Per aggiungere nuovi attributi o aggiornare quelli esistenti con nuovi valori, configura`attributes`. Ad esempio, se hai un'auto elettrica, puoi specificare il seguente valore per un attributo:`{"fuelType": "electric"}`.

  Per eliminare gli attributi, configura `attributeUpdateMode` su`Merge`.
**Importante**  <a name="update-attributes-requirement"></a>
Gli attributi devono essere definiti nel modello di veicolo associato prima di poterli aggiungere ai singoli veicoli.

```
 { 
         "vehicleName": "{{vehicle-name}}",
         "modelManifestArn": "{{model-manifest-arn}}",
         "decoderManifestArn": "{{decoder-manifest-arn}}",
         "attributeUpdateMode": "{{attribute-update-mode}}"
         }         
}
```

**Example — aggiungere o rimuovere modelli di stato associati al veicolo**  
Puoi associare modelli di stato aggiuntivi o rimuovere le associazioni esistenti dal veicolo utilizzando i seguenti campi:  
+ `stateTemplatesToAdd` 
+ `stateTemplatesToRemove` 

```
aws iotfleetwise update-vehicle --cli-input-json file://{{update-vehicle.json}}
```
Dove il `{{update-vehicle.json}}` file contiene (ad esempio):  

```
{
    "vehicleName": "{{vehicle-name}}",
    "modelManifestArn": "{{model-manifest-arn}}",
    "decoderManifestArn": "{{decoder-manifest-arn}}",
    "attributeUpdateMode": "{{attribute-update-mode}}",
    "stateTemplatesToAdd": [ 
        {
            "identifier": "{{state-template-name}}",
            "stateTemplateUpdateStrategy": {
                "onChange": {}
            }
        }
    ],
    "stateTemplatesToRemove": ["{{state-template-name}}"]            
}
```

Se hai [abilitato la crittografia](key-management.md) utilizzando una AWS KMS chiave gestita dal cliente, includi la seguente dichiarazione di politica in modo che il tuo ruolo possa richiamare l'operazione dell'`UpdateVehicle`API. 

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kms:GenerateDataKey*",
                "kms:Decrypt"
            ],
            "Resource": [
                "arn:aws:kms:{{us-east-1}}:{{111122223333}}:key/{{KMS_KEY_ID}}"
            ]
        }
    ]
}
```

------