Crea un FleetWise vehículo AWS de IoT - AWS IoT FleetWise
Creación de un vehículo (consola)Creación de un vehículo (AWS CLI)

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.

Puedes usar la FleetWise consola de AWS IoT o la API para crear un vehículo.

importante

Antes de comenzar, compruebe lo siguiente:

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.

  2. En el panel de navegación, elija Vehículos.

  3. En la página de resumen del vehículo, elija Crear vehículo y, a continuación, siga los siguientes pasos.

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.

  2. Elija un modelo de vehículo (manifiesto del modelo) de la lista.

  3. Elija un manifiesto del decodificador de la lista. El manifiesto del decodificador está asociado al modelo de vehículo.

  4. (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.

  5. (Opcional) Para asociar etiquetas al vehículo, elija Agregar etiqueta nueva. También puede agregar etiquetas una vez creado el vehículo.

  6. Elija Next (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).

  2. Elija Next (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.

  2. Elija Next (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 CreateVehicleAPI para crear un vehículo. El siguiente ejemplo utiliza AWS CLI.

Para crear un vehículo, ejecute el siguiente comando:

file-nameSustitú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
ejemplo — 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-nameSustitú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.

  • vehicle-nameSustitúyalo por uno de los siguientes.

    • El nombre de AWS IoT lo que quieres, si associationBehavior está configurado para elloValidateIotThingExists.

    • 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 (_) y dos puntos (:).

  • model-manifest-ARNSustitúyalo por el ARN del modelo de su vehículo (manifiesto del modelo).

  • decoder-manifest-ARNSustitú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"
    }
}
ejemplo — asociar una plantilla de estado al vehículo

Puede asociar plantillas de estado 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 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. 

{
  "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"
      ]
    },
  ]
}