View a markdown version of this page

Atualizar um veículo AWS de IoT FleetWise - AWS IoT FleetWise

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

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.

Você pode usar a operação UpdateVehicleda 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-nameSubstitua 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
exemplo— configuração do veículo
  • vehicle-nameSubstitua 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

    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" } }
exemplo— 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 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" ] } ] }