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"
            ]
        }
    ]
}
```

------