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