Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Crea un FleetWise vehículo AWS de IoT
**importante**
El acceso a ciertas FleetWise funciones de AWS IoT está actualmente restringido. Para obtener más información, consulte [AWS Disponibilidad regional y de funciones en el AWS IoT FleetWise](fleetwise-regions.md).
Puedes usar la FleetWise consola de AWS IoT o la API para crear un vehículo.
**importante**
Antes de comenzar, compruebe lo siguiente:
Debe disponer de un modelo de vehículo y su estado debe ser `ACTIVE`. Para obtener más información, consulte [Gestione los modelos de FleetWise vehículos de AWS IoTModelos de vehículo](vehicle-models.md).
El modelo de vehículo debe estar asociado a un manifiesto del decodificador y el estado de dicho manifiesto debe ser `ACTIVE`. Para obtener más información, consulte [Gestione los AWS manifiestos de FleetWise decodificadores de IoT](decoder-manifests.md).
**Topics**
+ [Creación de un vehículo (consola)](#create-vehicle-console)
+ [Creación de un vehículo (AWS CLI)](#create-vehicle-cli)
## Creación de un vehículo (consola)
Puedes usar la FleetWise consola AWS IoT para crear un vehículo.
**Para crear un vehículo**
1. Abre la [ FleetWise consola AWS de IoT](https://console.aws.amazon.com/iotfleetwise).
1. En el panel de navegación, elija **Vehículos**.
1. En la página de resumen del vehículo, elija **Crear vehículo** y, a continuación, siga los siguientes pasos.
**Topics**
+ [Paso 1: Definir las propiedades del vehículo](#define-vehicle-properties-console)
+ [Paso 2: Configurar el certificado del vehículo](#define-vehicle-certificate-console)
+ [Paso 3: Asociar políticas al certificado](#attach-vehicle-policy-console)
+ [Paso 4: Revisar y crear](#review-and-create-vehicle-console)
### Paso 1: Definir las propiedades del vehículo
En este paso, debe asignar un nombre al vehículo y asociarlo al manifiesto del modelo y al manifiesto del decodificador.
1. Escriba un nombre único para el vehículo.
**importante**
Un vehículo corresponde a cualquier AWS IoT cosa. Si ya existe un objeto con ese nombre, elija **Asociar el vehículo a un objeto de IoT** para actualizarlo con el vehículo. O bien, elige un nombre de vehículo diferente y el AWS IoT FleetWise creará automáticamente algo nuevo para el vehículo.
1. Elija un modelo de vehículo (manifiesto del modelo) de la lista.
1. Elija un manifiesto del decodificador de la lista. El manifiesto del decodificador está asociado al modelo de vehículo.
1. (Opcional) Para asociar los atributos del vehículo, elija **Agregar atributos**. Si se salta este paso, tendrá que añadir atributos una vez creado el vehículo para poder implementarlo en las campañas.
1. (Opcional) Para asociar etiquetas al vehículo, elija **Agregar etiqueta nueva**. También puede agregar etiquetas una vez creado el vehículo.
1. Elija **Siguiente**.
### Paso 2: Configurar el certificado del vehículo
Para usar tu vehículo como una AWS IoT cosa, debes configurar un certificado de vehículo con una política adjunta. Si se salta este paso, debe configurar un certificado tras crear el vehículo para poder distribuirlo en las campañas.
1. Elija **Generar automáticamente un nuevo certificado (opción recomendada)**.
1. Elija **Siguiente**.
### Paso 3: Asociar políticas al certificado
Asocie una política al certificado que ha configurado en el paso anterior.
1. En **Políticas**, introduzca el nombre de una política existente. Para crear una nueva política, elija **Crear política**.
1. Elija **Siguiente**.
### Paso 4: Revisar y crear
Verifique las configuraciones del vehículo y, a continuación, elija **Crear vehículo**.
**importante**
Una vez creado el vehículo, debe descargar el certificado y las claves. Utilizará el certificado y la clave privada para conectar el vehículo en el FleetWise software Edge Agent para AWS IoT.
## Creación de un vehículo (AWS CLI)
Al crear un vehículo, debe utilizar un modelo de vehículo que esté asociado a un manifiesto del decodificador. Puedes usar la operación de la [CreateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateVehicle.html)API para crear un vehículo. El siguiente ejemplo utiliza AWS CLI.
Para crear un vehículo, ejecute el siguiente comando:
*file-name*Sustitúyalo por el nombre del archivo.json que contiene la configuración del vehículo.
```
aws iotfleetwise create-vehicle --cli-input-json file://file-name.json
```
**Example — configuración del vehículo**
+ (Opcional) El valor `associationBehavior` puede ser uno de los siguientes:
+ `CreateIotThing`— Cuando se crea tu vehículo, el AWS IoT crea FleetWise automáticamente una AWS IoT cosa con el nombre del identificador de tu vehículo.
+ `ValidateIotThingExists`: se utiliza un objeto de AWS IoT existente para crear un vehículo.
Para crear AWS IoT algo, ejecuta el siguiente comando. *thing-name*Sustitúyalo por el nombre de la cosa que desee crear.
```
aws iot create-thing --thing-name thing-name
```
Si no se especifica, el AWS IoT crea FleetWise automáticamente AWS IoT algo para tu vehículo.
**importante**
Asegúrese de que la AWS IoT cosa esté aprovisionada una vez creado el vehículo. Para obtener más información, consulte [Aprovisionamiento AWS de FleetWise vehículos de IoT](provision-vehicles.md).
+ *vehicle-name*Sustitúyalo por uno de los siguientes.
+ El nombre de AWS IoT lo que quieres, si `associationBehavior` está configurado para ello`ValidateIotThingExists`.
+ El ID del vehículo que debe crearse si `associationBehavior` está configurado como `CreateIotThing`.
El ID del vehículo puede tener de 1 a 100 caracteres. Caracteres válidos: a-z, A-Z, 0-9, guion (‐), guion bajo (\$1) y dos puntos (:).
+ *model-manifest-ARN*Sustitúyalo por el ARN del modelo de su vehículo (manifiesto del modelo).
+ *decoder-manifest-ARN*Sustitúyalo por el ARN del manifiesto del decodificador asociado al modelo de vehículo especificado.
+ (Opcional) Puede agregar atributos adicionales para distinguir este vehículo de otros vehículos creados a partir del mismo modelo de vehículo. Por ejemplo, si tiene un automóvil eléctrico, puede especificar el siguiente valor para un atributo: `{"fuelType": "electric"}`.
**importante**
Los atributos deben definirse en el modelo de vehículo asociado antes de poder agregarlos a vehículos individuales.
```
{
"associationBehavior": "associationBehavior",
"vehicleName": "vehicle-name",
"modelManifestArn": "model-manifest-ARN",
"decoderManifestArn": "decoder-manifest-ARN",
"attributes": {
"key": "value"
}
}
```
**Example — asociar una plantilla de estado al vehículo**
Puede asociar [plantillas de estado](state-templates.md) al vehículo para poder recopilar las actualizaciones de estado del vehículo en la nube mediante el uso del `stateTemplates` campo.
En este ejemplo, `stateTemplateUpdateStrategy` puede ser una de las siguientes:
+ `periodic`: le permite especificar una velocidad fija a la que el software Edge Agent enviará las actualizaciones de señal a la nube (el software Edge Agent enviará las actualizaciones incluso si el valor de la señal no ha cambiado entre las actualizaciones).
+ `onChange`: El software Edge Agent enviará actualizaciones de señal cada vez que la señal cambie.
```
aws iotfleetwise create-vehicle --cli-input-json file://create-vehicle.json
```
Dónde contiene el `create-vehicle.json` archivo (por ejemplo):
```
{
"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
}
}
}
}
]
}
```
Si has [activado el cifrado](key-management.md) mediante una AWS KMS clave gestionada por el cliente, incluye la siguiente declaración de política para que tu función pueda invocar la operación de la `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"
]
}
]
}
```
------