AWS A IoT não FleetWise estará mais aberta a novos clientes a partir de 30 de abril de 2026. Os FleetWise clientes de AWS IoT existentes podem continuar usando o serviço. O [Guia para Mobilidade Conectada AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) fornece orientação sobre como desenvolver e implantar serviços modulares para soluções de mobilidade conectada que podem ser usadas para obter recursos equivalentes aos da AWS IoT FleetWise.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Atualizar um veículo AWS de IoT FleetWise
<a name="update-vehicle-cli"></a>

**Importante**  
O acesso a determinados FleetWise recursos de AWS IoT está atualmente bloqueado. Para obter mais informações, consulte [AWS Disponibilidade de regiões e recursos na AWS IoT FleetWise](fleetwise-regions.md).

Você pode usar a operação [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)da API para atualizar um veículo existente. O exemplo a seguir usa a AWS CLI.

Para atualizar um veículo, execute o seguinte comando.

{{file-name}}Substitua pelo nome do arquivo.json que contém a configuração do seu veículo.

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

**Example — configuração do veículo**  
+ {{vehicle-name}}Substitua pela ID do veículo que você deseja atualizar.
+ (Opcional) {{model-manifest-ARN}} Substitua pelo ARN do modelo do veículo (manifesto do modelo) que você usa para substituir o modelo do veículo em uso.
+ (Opcional) {{decoder-manifest-ARN}} Substitua pelo ARN do manifesto do decodificador associado ao novo modelo de veículo que você especificou.
+ (Opcional) {{attribute-update-mode}} Substitua pelos atributos do veículo.
  + `Merge` — Mesclar novos atributos em atributos existentes atualizando este último com novos valores e adicionando novos atributos se eles não existirem.

    Por exemplo, se um veículo tiver os seguintes atributos: `{"color": "black", "fuelType": "electric"}`, e você atualizar o veículo com os seguintes atributos: `{"color": "", "fuelType": "gasoline", "model": "x"}`, o veículo atualizado terá os seguintes atributos: `{"fuelType": "gasoline", "model": "x"}`.
  + `Overwrite` — Substitua os atributos existentes por novos.

    Por exemplo, se um veículo tiver os seguintes atributos: `{"color": "black", "fuelType": "electric"}` e você atualizar o veículo pelo atributo `{"model": "x"}`, o veículo atualizado terá o atributo `{"model": "x"}`.

  Isso será necessário se houver atributos na entrada.
+ (Opcional) Para adicionar novos atributos ou atualizar os existentes com novos valores, configure `attributes`. Por exemplo, se você tiver um carro elétrico, poderá especificar o seguinte valor para um atributo: `{"fuelType": "electric"}`.

  Para excluir atributos, configure `attributeUpdateMode` como `Merge`.
**Importante**  <a name="update-attributes-requirement"></a>
Os atributos devem ser definidos no modelo de veículo associado antes de poder adicioná-los a veículos individuais.

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

**Example — adicionar ou remover modelos de estado associados ao veículo**  
Você pode associar modelos de estado adicionais ou remover associações existentes do veículo usando os seguintes campos:  
+ `stateTemplatesToAdd` 
+ `stateTemplatesToRemove` 

```
aws iotfleetwise update-vehicle --cli-input-json file://{{update-vehicle.json}}
```
Onde o `{{update-vehicle.json}}` arquivo contém (por exemplo):  

```
{
    "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 você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `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}}"
            ]
        }
    ]
}
```

------