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á.
# Gerencie AWS veículos de IoT FleetWise
Veículos são instâncias de modelos de veículos. Os veículos devem ser criados com base em um modelo de veículo e associados a um manifesto do decodificador. Os veículos carregam um ou mais fluxos de dados para a nuvem. Por exemplo, um veículo pode enviar dados de quilometragem, temperatura do motor e estado do ar quente para a nuvem. Cada veículo contém as seguintes informações:
`vehicleName`
Um ID que identifica o veículo.
Não inclua informações de identificação pessoal (PII) nem outras informações confidenciais ou sigilosas em nomes de filas. Os nomes dos veículos podem ser acessados por outros AWS serviços, incluindo a Amazon CloudWatch. Os nomes dos veículos não se destinam a ser usados para dados privados ou confidenciais.
`modelManifestARN`
O nome de recurso da Amazon (ARN) de um modelo de veículo (manifesto do modelo). Cada veículo é criado usando um modelo de veículo. Os veículos criados usando o mesmo modelo de veículo consistem no mesmo grupo de sinais herdados do modelo de veículo. Esses sinais são definidos e padronizados no catálogo de sinais.
`decoderManifestArn`
O ARN do manifesto do decodificador. Um manifesto do decodificador fornece informações de decodificação que a AWS IoT FleetWise pode usar para transformar dados brutos do sinal (dados binários) em valores legíveis por humanos. Um manifesto do decodificador deve estar associado a um modelo de veículo. AWS A IoT FleetWise usa o mesmo manifesto do decodificador para decodificar dados brutos de veículos criados com base no mesmo modelo de veículo.
`attributes`
Atributos são pares de valores-chave que contêm informações estáticas. Os veículos podem conter atributos herdados do modelo do veículo. Você pode adicionar outros atributos para distinguir um veículo individual de outros veículos criados usando o mesmo modelo de veículo. Por exemplo, se você tiver um carro preto, poderá especificar o seguinte valor para um atributo: `{"color": "black"}`.
Os atributos devem ser definidos no modelo de veículo associado antes de poder adicioná-los a veículos individuais.
Para obter mais informações sobre modelos de veículos, manifestos de decodificadores e atributos, consulte [Modelos de AWS veículos de IoT FleetWise](vehicle-modeling.md).
AWS A IoT FleetWise fornece as seguintes operações de API que você pode usar para criar e gerenciar veículos.
+ [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html)— Cria um novo veículo.
+ [BatchCreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchCreateVehicle.html)— Cria um ou mais veículos novos.
+ [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)— Atualiza um veículo existente.
+ [BatchUpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchUpdateVehicle.html)— Atualiza um ou mais veículos existentes.
+ [DeleteVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteVehicle.html)— Exclui um veículo existente.
+ [ListVehicles](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehicles.html)— Recupera uma lista paginada de resumos de todos os veículos.
+ [GetVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicle.html)— Recupera informações sobre um veículo.
**Topics**
+ [Provisionar AWS veículos de IoT FleetWise](provision-vehicles.md)
+ [Tópicos reservados em AWS IoT FleetWise](reserved-topics.md)
+ [Crie um veículo AWS de IoT FleetWise](create-vehicle.md)
+ [Crie vários veículos AWS de IoT FleetWise](create-vehicles-cli.md)
+ [Atualizar um veículo AWS de IoT FleetWise](update-vehicle-cli.md)
+ [Atualize vários veículos AWS de IoT FleetWise](update-vehicles-cli.md)
+ [Excluir um veículo AWS de IoT FleetWise](delete-vehicle.md)
+ [Obtenha informações sobre AWS veículos de IoT FleetWise](get-vehicle-information-cli.md)
# Provisionar AWS veículos de IoT FleetWise
O FleetWise software Edge Agent para AWS IoT executado em seu veículo coleta e transfere dados para a nuvem. AWS A IoT FleetWise se integra AWS IoT Core para oferecer suporte à comunicação segura entre o software Edge Agent e a nuvem por meio do MQTT. Cada veículo corresponde a AWS IoT alguma coisa. Você pode usar AWS IoT algo existente para criar um veículo ou configurar a AWS IoT FleetWise para criar automaticamente AWS IoT algo para seu veículo. Para obter mais informações, consulte [Crie um veículo AWS de IoT FleetWise](create-vehicle.md).
AWS IoT Core oferece suporte à [autenticação](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html) e [autorização](https://docs.aws.amazon.com/iot/latest/developerguide/iot-authorization.html) que ajudam a controlar com segurança o acesso aos recursos de IoT AWS . FleetWise Os veículos podem usar certificados X.509 para serem autenticados (conectados) para usar a AWS IoT FleetWise e AWS IoT Core políticas para serem autorizados (ter permissões) a realizar ações específicas.
## Autenticar veículos
Você pode criar AWS IoT Core políticas para autenticar seus veículos.
**Para autenticar seu veículo**
+ Para criar uma AWS IoT Core política, execute o comando a seguir.
+ *policy-name*Substitua pelo nome da política que você deseja criar.
+ *file-name*Substitua pelo nome do arquivo JSON que contém a AWS IoT Core política.
```
aws iot create-policy --policy-name policy-name --policy-document file://file-name.json
```
### Exemplo AWS IoT Core de política
Antes de usar a política de exemplo, faça o seguinte:
+ *us-east-1*Substitua pela AWS região em que você criou recursos de AWS IoT. FleetWise
+ *111122223333*Substitua pelo ID AWS da sua conta.
Este exemplo inclui tópicos reservados pela AWS IoT FleetWise. Você deve adicionar os tópicos à política. Para obter mais informações, consulte [Tópicos reservados em AWS IoT FleetWise](reserved-topics.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iot:Connect"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:client/${iot:Connection.Thing.ThingName}"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Publish"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/checkins",
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/signals"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Subscribe"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:topicfilter/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/collection_schemes",
"arn:aws:iot:us-east-1:111122223333:topicfilter/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/decoder_manifests"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Receive"
],
"Resource": [
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/collection_schemes",
"arn:aws:iot:us-east-1:111122223333:topic/$aws/iotfleetwise/vehicles/${iot:Connection.Thing.ThingName}/decoder_manifests"
]
}
]
}
```
------
## Autorizar veículos
Você pode criar certificados X.509 para autorizar seus veículos.
**Para autorizar seu veículo**
**Importante**
Recomendamos que você crie um novo certificado para cada veículo.
1. Para criar um par de chaves RSA e emitir um certificado X.509, execute o comando a seguir.
+ *cert*Substitua pelo nome do arquivo que salva o conteúdo de saída do comando do CertificatePem.
+ *public-key*Substitua pelo nome do arquivo que salva o conteúdo de saída do comando do KeyPair. PublicKey.
+ *private-key*Substitua pelo nome do arquivo que salva o conteúdo de saída do comando do KeyPair. PrivateKey.
```
aws iot create-keys-and-certificate \
--set-as-active \
--certificate-pem-outfile cert.pem \
--public-key-outfile public-key.key" \
--private-key-outfile private-key.key"
```
1. Copie o nome de recurso da Amazon (ARN) do certificado da saída.
1. Para anexar a política ao certificado, execute o comando a seguir.
+ *policy-name*Substitua pelo nome da AWS IoT Core política que você criou.
+ *certificate-arn*Substitua pelo ARN do certificado que você copiou.
```
aws iot attach-policy \
--policy-name policy-name\
--target "certificate-arn"
```
1. Para anexar o certificado à coisa, execute o seguinte comando.
+ *thing-name*Substitua pelo nome da sua AWS IoT coisa ou pela ID do seu veículo.
+ *certificate-arn*Substitua pelo ARN do certificado que você copiou.
```
aws iot attach-thing-principal \
--thing-name thing-name \
--principal "certificate-arn"
```
# Tópicos reservados em AWS 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](fleetwise-regions.md).
AWS A IoT FleetWise reserva o uso dos seguintes tópicos. Se o tópico reservado permitir, você poderá se inscrever ou publicar nele. No entanto, não é possível criar novos tópicos que comecem com um cifrão (\$1). Se você usar operações de publicação ou assinatura incompatível com tópicos reservados, isso poderá resultar no fim da conexão.
| Tópico | Operação do cliente permitida | Description |
| --- | --- | --- |
| `$aws/iotfleetwise/vehicles/vehicleName/checkins` | Publicar | O software Edge Agent publica informações de status do veículo neste tópico. As informações de status do veículo são trocadas no formato de buffers de protocolo (Protobuf). Para obter mais informações, consulte o Guia do [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
| `$aws/iotfleetwise/vehicles/vehicleName/signals` | Publicar | O software Edge Agent publica sinais para este tópico. As informações do sinal são trocadas no formato de buffers de protocolo (Protobuf). Para obter mais informações, consulte o Guia do [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
| `$aws/iotfleetwise/vehicles/vehicleName/collection_schemes` | Assinar | AWS A IoT FleetWise publica esquemas de coleta de dados sobre esse tópico. Os veículos consomem esses esquemas de coleta de dados. |
| `$aws/iotfleetwise/vehicles/vehicleName/decoder_manifests` | Assinar | AWS A IoT FleetWise publica manifestos de decodificadores para esse tópico. Os veículos consomem esses manifestos do decodificador. |
| `$aws/iotfleetwise/vehicles/vehicleName/command/request` | Assinar | AWS A IoT FleetWise publica solicitações para executar comandos neste tópico. Os veículos então consomem essas solicitações de comando. |
| `$aws/iotfleetwise/vehicles/vehicleName/command/response` | Publicar | O software Edge Agent publica respostas de comando do veículo a este tópico. As respostas dos comandos são trocadas no formato de buffers de protocolo (Protobuf). Para obter mais informações, consulte o Guia do [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
| `$aws/iotfleetwise/vehicles/vehicleName/command/notification` | Assinar | AWS A IoT FleetWise publica atualizações de status de comando para este tópico. As notificações são enviadas em formato JSON. |
| `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_states/config` | Assinar | AWS A IoT FleetWise publica configurações de modelo de estado para este tópico. Os veículos consomem essas configurações de modelo de estado. |
| `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_states/data` | Publicar | O software Edge Agent publica dados coletados dos sinais para este tópico. |
| `$aws/iotfleetwise/vehicles/$vehicle_name/last_known_state/$state_template_name/data` | Assinar | AWS A IoT FleetWise publica dados coletados dos sinais configurados no tópico especificado`$state_template_name`. As atualizações podem ser parciais. Por exemplo, se uma associação de modelo de estado contiver vários sinais com a estratégia de atualização em andamento, somente os sinais que foram alterados estarão contidos em uma determinada mensagem. As informações do sinal são trocadas no formato de buffers de protocolo (Protobuf). Para obter mais informações, consulte o Guia do [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-dev-guide.md#data-models). |
# Crie 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](fleetwise-regions.md).
Você pode usar o FleetWise console de AWS IoT ou a API para criar um veículo.
**Importante**
Antes de começar, verifique o seguinte:
Você deve ter um modelo de veículo, e o status dele deve ser `ACTIVE`. Para obter mais informações, consulte [Gerencie modelos AWS de veículos de IoT FleetWiseModelos de veículos](vehicle-models.md).
O modelo do veículo deve estar associado a um manifesto do decodificador, e o status do manifesto do decodificador deve ser `ACTIVE`. Para obter mais informações, consulte [Gerencie manifestos AWS de decodificadores de IoT FleetWise](decoder-manifests.md).
**Topics**
+ [Criar um veículo (console)](#create-vehicle-console)
+ [Criar um veículo (AWS CLI)](#create-vehicle-cli)
## Criar um veículo (console)
Você pode usar o FleetWise console de AWS IoT para criar um veículo.
**Para criar um veículo**
1. Abra o console [AWS de IoT. FleetWise ](https://console.aws.amazon.com/iotfleetwise)
1. No painel de navegação, selecione **Veículos**.
1. Na página de resumo do veículo, selecione **Criar veículo** e execute as etapas a seguir.
**Topics**
+ [Etapa 1: definir as propriedades do veículo](#define-vehicle-properties-console)
+ [Etapa 2: configurar o certificado do veículo](#define-vehicle-certificate-console)
+ [Etapa 3: anexar políticas ao certificado](#attach-vehicle-policy-console)
+ [Etapa 4: revisar e criar](#review-and-create-vehicle-console)
### Etapa 1: definir as propriedades do veículo
Nesta etapa, você dá um nome para o veículo e o associa ao manifesto do modelo e ao manifesto do decodificador.
1. Insira um nome para o veículo.
**Importante**
Um veículo corresponde a qualquer AWS IoT coisa. Se já existir alguma coisa com esse nome, selecione **Associar o veículo a uma coisa de IoT** para atualizar a coisa com o veículo. Ou escolha um nome de veículo diferente e a AWS IoT FleetWise criará automaticamente algo novo para o veículo.
1. Selecione um modelo de veículo (manifesto do modelo) na lista.
1. Selecione um manifesto de decodificador na lista. O manifesto do decodificador está associado ao modelo do veículo.
1. (Opcional) Para associar atributos do veículo, escolha **Adicionar atributos**. Se você ignorar esta etapa, deverá adicionar atributos após a criação do veículo antes de poder implementá-lo em campanhas.
1. (Opcional) Para associar etiquetas ao veículo, selecione **Adicionar nova etiqueta**. Você também poderá adicionar tags após a criação do veículo.
1. Escolha **Próximo**.
### Etapa 2: configurar o certificado do veículo
Para usar seu veículo como uma AWS IoT coisa, você deve configurar um certificado de veículo com uma política anexada. Se você ignorar esta etapa, deverá configurar um certificado após a criação do veículo antes de poder implantá-lo em campanhas.
1. Selecione **Gerar automaticamente um novo certificado (recomendado).**
1. Escolha **Próximo**.
### Etapa 3: anexar políticas ao certificado
Anexar uma política ao certificado que você configurou na etapa anterior.
1. Em **Políticas**, insira um nome de política existente. Para criar uma política, selecione **Criar política**.
1. Escolha **Próximo**.
### Etapa 4: revisar e criar
Verifique as configurações do veículo e selecione **Criar veículo**.
**Importante**
Depois que o veículo for criado, você deverá baixar o certificado e as chaves. Você usará o certificado e a chave privada para conectar o veículo no software Edge Agent for AWS IoT FleetWise .
## Criar um veículo (AWS CLI)
Ao criar um veículo, você deve usar um modelo de veículo associado a um manifesto do decodificador. Você pode usar a operação [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html)da API para criar um veículo. O exemplo a seguir usa a AWS CLI.
Para criar um veículo, execute o seguinte comando.
*file-name*Substitua pelo nome do arquivo.json que contém a configuração do veículo.
```
aws iotfleetwise create-vehicle --cli-input-json file://file-name.json
```
**Example — configuração do veículo**
+ (Opcional) O valor `associationBehavior` pode ser um dos seguintes:
+ `CreateIotThing`— Quando seu veículo é criado, AWS a IoT cria FleetWise automaticamente AWS IoT algo com o nome do ID do veículo.
+ `ValidateIotThingExists` — Use uma coisa da AWS IoT existente para criar um veículo.
Para criar AWS IoT algo, execute o comando a seguir. *thing-name*Substitua pelo nome da coisa que você deseja criar.
```
aws iot create-thing --thing-name thing-name
```
Se não for especificado, a AWS IoT cria FleetWise automaticamente AWS IoT algo para seu veículo.
**Importante**
Certifique-se de que a AWS IoT coisa seja provisionada após a criação do veículo. Para obter mais informações, consulte [Provisionar AWS veículos de IoT FleetWise](provision-vehicles.md).
+ *vehicle-name*Substitua por um dos seguintes.
+ O nome da sua AWS IoT coisa, se `associationBehavior` estiver configurado para`ValidateIotThingExists`.
+ O ID do veículo a ser criado se `associationBehavior` estiver configurado como `CreateIotThing`.
O ID do veículo pode ter de 1 a 100 caracteres. Caracteres válidos: a–z, A–Z, 0–9, traço (‐), sublinhado (\$1) e dois pontos (:).
+ *model-manifest-ARN*Substitua pelo ARN do modelo do seu veículo (manifesto do modelo).
+ *decoder-manifest-ARN*Substitua pelo ARN do manifesto do decodificador associado ao modelo de veículo especificado.
+ (Opcional) Você pode adicionar outros atributos para distinguir este veículo de outros veículos criados usando o mesmo modelo de veículo. Por exemplo, se você tiver um carro elétrico, poderá especificar o seguinte valor para um atributo: `{"fuelType": "electric"}`.
**Importante**
Os atributos devem ser definidos no modelo de veículo associado antes de poder adicioná-los a veículos individuais.
```
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
}
}
```
**Example — associar um modelo de estado ao veículo**
Você pode associar [modelos de estado](state-templates.md) ao veículo para permitir a coleta de atualizações de estado do veículo na nuvem usando o `stateTemplates` campo.
Neste exemplo, `stateTemplateUpdateStrategy` pode ser um dos seguintes:
+ `periodic`: permite especificar uma taxa fixa na qual o software Edge Agent enviará atualizações de sinal para a nuvem (o software Edge Agent enviará atualizações mesmo que o valor do sinal não tenha sido alterado entre as atualizações).
+ `onChange`: O software Edge Agent enviará atualizações de sinal sempre que o sinal mudar.
```
aws iotfleetwise create-vehicle --cli-input-json file://create-vehicle.json
```
Onde o `create-vehicle.json` arquivo contém (por exemplo):
```
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
},
"stateTemplates": [
{
"identifier": "state-template-name",
"stateTemplateUpdateStrategy": {
"periodic": {
"stateTemplateUpdateRate": {
"unit": "SECOND",
"value": 10
}
}
}
}
]
}
```
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 `CreateVehicle` 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"
]
}
]
}
```
------
# Crie vários veículos AWS de IoT FleetWise
Você pode usar a operação [BatchCreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchCreateVehicle.html)da API para criar vários veículos ao mesmo tempo. O exemplo a seguir usa a AWS CLI.
Para criar vários veículos, execute o seguinte comando.
*file-name*Substitua pelo nome do arquivo.json que contém as configurações de vários veículos.
```
aws iotfleetwise batch-create-vehicle --cli-input-json file://file-name.json
```
**Example — configurações de veículos**
```
{
"vehicles": [
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
}
},
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
}
}
]
}
```
Você pode criar até 10 veículos para cada operação em lote. Para obter mais informações sobre a configuração do veículo, consulte [Crie um veículo AWS de IoT FleetWise](create-vehicle.md).
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 `BatchCreateVehicle` 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"
]
}
]
}
```
------
# 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](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**
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"
]
}
]
}
```
------
# Atualize vários veículos AWS de IoT FleetWise
Você pode usar a operação [BatchUpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_BatchUpdateVehicle.html)da API para atualizar vários veículos existentes ao mesmo tempo. O exemplo a seguir usa a AWS CLI.
Para atualizar vários veículos, execute o seguinte comando.
*file-name*Substitua pelo nome do arquivo.json que contém as configurações de vários veículos.
```
aws iotfleetwise batch-update-vehicle --cli-input-json file://file-name.json
```
**Example — configurações de veículos**
```
{
"vehicles": [
{
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-arn",
"decoderManifestArn": "decoder-manifest-arn",
"mergeAttributes": true,
"attributes": {
"key": "value"
}
},
{
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-arn",
"decoderManifestArn": "decoder-manifest-arn",
"mergeAttributes": true,
"attributes": {
"key": "value"
}
}
]
}
```
Você pode atualizar até 10 veículos para cada operação em lote. Para obter mais informações sobre a configuração de cada veículo, consulte [Atualizar um veículo AWS de IoT FleetWise](update-vehicle-cli.md).
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 `BatchUpdateVehicle` 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"
]
}
]
}
```
------
# Excluir um veículo AWS de IoT FleetWise
Você pode usar o FleetWise console de AWS IoT ou a API para excluir veículos.
**Importante**
Depois que um veículo é excluído, a AWS IoT remove FleetWise automaticamente o veículo das frotas e campanhas associadas. Para obter mais informações, consulte [Gerencie frotas na IoT AWS FleetWise](fleets.md) e [Colete FleetWise dados de AWS IoT com campanhas](campaigns.md). No entanto, o veículo ainda existe como uma coisa ou ainda está associado a uma coisa dentro AWS IoT Core. Para obter instruções sobre como excluir uma coisa, consulte [Excluir uma coisa](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html#delete-thing) no *Guia do desenvolvedor do AWS IoT Core *.
## Excluir um veículo (console)
Você pode usar o FleetWise console de AWS IoT para excluir um veículo.
**Para excluir um veículo**
1. Abra o console [AWS de IoT. FleetWise ](https://console.aws.amazon.com/iotfleetwise)
1. No painel de navegação, selecione **Veículos**.
1. Na página **Veículos**, selecione o botão ao lado do veículo que você quer excluir.
1. Escolha **Excluir**.
1. Em **Excluir **vehicle-name****, insira o nome do veículo e selecione **Excluir**.
## Excluir um veículo (AWS CLI)
Você pode usar a operação [DeleteVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteVehicle.html)da API para excluir um veículo. O exemplo a seguir usa AWS CLI.
Para excluir um veículo, execute o seguinte comando.
*vehicle-name*Substitua pela ID do veículo que você deseja excluir.
```
aws iotfleetwise delete-vehicle --vehicle-name vehicle-name
```
### Verifique a exclusão do veículo
Você pode usar a operação [ListVehicles](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListVehicles.html)da API para verificar se um veículo foi excluído. O exemplo a seguir usa a AWS CLI.
Para recuperar uma lista paginada de resumos de todos os veículos, execute o seguinte comando.
```
aws iotfleetwise list-vehicles
```
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 `ListVehicles` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Obtenha informações sobre AWS veículos 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](fleetwise-regions.md).
Você pode usar a operação [GetVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicle.html)da API para recuperar informações do veículo. O exemplo a seguir usa a AWS CLI.
Para recuperar os metadados de um veículo, execute o seguinte comando.
*vehicle-name*Substitua pela ID do veículo que você deseja recuperar.
```
aws iotfleetwise get-vehicle --vehicle-name vehicle-name
```
**nota**
Essa operação é [eventualmente consistente](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). Em outras palavras, as alterações no veículo podem não ser refletidas imediatamente.
Você pode usar a operação da [GetVehicleStatus](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetVehicleStatus.html)API para recuperar o status dos recursos associados a um veículo. O exemplo a seguir usa a AWS CLI.
Para recuperar o status dos recursos associados a um veículo, execute o comando a seguir.
+ *vehicle-name*Substitua pela ID do veículo ao qual os recursos estão associados.
+ *type*Substitua pelo tipo do recurso cujo status você deseja recuperar. Os valores válidos para `type` são `CAMPAIGN`, `STATE_TEMPLATE` e `DECODER`.
```
aws iotfleetwise get-vehicle-status --vehicle-name vehicle-name --type type
```
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 as operações `GetVehicle` ou a `GetVehicleStatus` API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------