Actualizar 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 UpdateVehicleAPIoperación para actualizar un vehículo existente. El siguiente ejemplo utiliza AWS CLI.

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

Reemplazar file-name con el nombre del archivo.json que contiene la configuración de tu vehículo.

aws iotfleetwise update-vehicle --cli-input-json file://file-name.json

ejemplo — configuración del vehículo

• Reemplazar vehicle-name con el identificador del vehículo que quieres actualizar.

• (Opcional) Sustituya model-manifest-ARN por el modelo ARN de vehículo (manifiesto del modelo) que utilice para reemplazar el modelo de vehículo en uso.

• (Opcional) Sustituya decoder-manifest-ARN por el manifiesto ARN del decodificador asociado al nuevo modelo de vehículo que especificaste.

• (Opcional) Sustituya attribute-update-mode con los atributos del vehículo.

  • Merge: los atributos nuevos se combinan con los atributos existentes actualizándolos con nuevos valores y agregando nuevos atributos si no existen.

    Por ejemplo, si un vehículo tiene los atributos {"color": "black", "fuelType": "electric"} y lo actualiza con los atributos {"color": "", "fuelType": "gasoline", "model": "x"}, el vehículo actualizado tendrá los siguientes atributos: {"fuelType": "gasoline", "model": "x"}.

  • Overwrite: los atributos existentes se sustituyen por atributos nuevos.

    Por ejemplo, si un vehículo tiene los atributos {"color": "black", "fuelType": "electric"} y lo actualiza con el atributo {"model": "x"}, el vehículo actualizado tendrá el atributo {"model": "x"}.

  Esto es obligatorio si la entrada contiene atributos.

• (Opcional) Para agregar nuevos atributos o actualizar los existentes con nuevos valores, configure attributes. Por ejemplo, si tiene un automóvil eléctrico, puede especificar el siguiente valor para un atributo: {"fuelType": "electric"}.

  Para eliminar atributos, configure attributeUpdateMode como Merge.

  importante

  Los atributos deben definirse en el modelo de vehículo asociado antes de poder agregarlos a vehículos individuales.

 { 
         "vehicleName": "vehicle-name",
         "modelManifestArn": "model-manifest-arn",
         "decoderManifestArn": "decoder-manifest-arn",
         "attributeUpdateMode": "attribute-update-mode"
         }         
}

ejemplo — añadir o eliminar plantillas de estado asociadas al vehículo

Puede asociar plantillas de estado adicionales o eliminar las asociaciones existentes del vehículo mediante los siguientes campos:

• stateTemplatesToAdd

• stateTemplatesToRemove

aws iotfleetwise update-vehicle --cli-input-json file://update-vehicle.json

Dónde contiene el update-vehicle.json archivo (por ejemplo):

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

Si ha activado el cifrado mediante una AWS KMS clave gestionada por el cliente, incluya la siguiente declaración de política para que su función pueda invocar la UpdateVehicle API operación.

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