Atualizar um veículo AWS de IoT FleetWise - 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. 

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "kms:GenerateDataKey*",
        "kms:Decrypt"
      ],
      "Resource": [
        "arn:aws:kms:KMS_KEY_REGION:KMS_KEY_ACCOUNT_ID:key/KMS_KEY_ID"
      ]
    },
  ]
}