

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.

# Actualizar un FleetWise vehículo AWS de IoT
<a name="update-vehicle-cli"></a>

**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 operación de la [UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html)API para actualizar un vehículo existente. El siguiente ejemplo utiliza AWS CLI.

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

*file-name*Sustitúyalo por 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
```

**Example — configuración del vehículo**  
+ *vehicle-name*Sustitúyala por la ID del vehículo que deseas actualizar.
+ (Opcional) *model-manifest-ARN* Sustitúyalo por el ARN del modelo de vehículo (manifiesto del modelo) que utilizas para sustituir el modelo de vehículo en uso.
+ (Opcional) *decoder-manifest-ARN* Sustitúyalo por el ARN del manifiesto del decodificador asociado al nuevo modelo de vehículo que especificaste.
+ (Opcional) Sustitúyalo por *attribute-update-mode* 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**  <a name="update-attributes-requirement"></a>
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"
         }         
}
```

**Example — 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 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 `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"
            ]
        }
    ]
}
```

------