AWS FleetWise El IoT dejará de estar abierto a nuevos clientes a partir del 30 de abril de 2026. FleetWise Los clientes actuales de AWS IoT pueden seguir utilizando el servicio. La [Guía para la movilidad conectada AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) proporciona orientación sobre cómo desarrollar e implementar servicios modulares para soluciones de movilidad conectada que se pueden utilizar para lograr capacidades equivalentes a las del AWS IoT FleetWise.
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.
# Active y desactive la recopilación de datos de estado mediante plantillas de estado
**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).
En las siguientes secciones se describe cómo activar y desactivar la ingesta de datos con plantillas de estado mediante el. AWS CLI
**importante**
Antes de empezar, asegúrate de haber creado una [plantilla de estado](state-templates.md) y de haberla asociado, junto con su estrategia de actualización, a un vehículo.
Debes activar una plantilla de estado para que el Edge Agent pueda enviar actualizaciones de señales a la nube.
Para realizar estas operaciones con plantillas de estado, primero cree un recurso de comando y, a continuación, inicie la ejecución del comando en el vehículo. En la siguiente sección, se describe cómo utilizar esta API y cómo activar y desactivar la ingesta de datos.
**Topics**
+ [Mediante la API de `CreateCommand`](#start-stop-ingestion-create-command)
+ [Ejemplo: activar una plantilla de estado](#start-stop-ingestion-activate-template)
+ [Ejemplo: desactivar una plantilla de estado](#start-stop-ingestion-deactivate-template)
## Mediante la API de `CreateCommand`
Cree un recurso de comandos en el espacio de nombres `AWS-IoTFleetwise` «» y utilice los siguientes parámetros al crear o enviar un recurso de comandos para una plantilla de estado:
+ `$stateTemplate.name`— El nombre de la plantilla de estado en la que se va a realizar la operación. La plantilla de estado debe aplicarse al vehículo antes de poder realizar una operación. Para obtener más información, consulte [Asociar una plantilla de FleetWise estado de AWS IoT a un vehículo](state-templates.md#apply-state-templates).
+ `$stateTemplate.operation`— La operación que se va a realizar en la plantilla de estado. Utilice uno de los siguientes valores para este parámetro:
+ `activate`— El Edge Agent comienza a enviar actualizaciones de señales a la nube en función de `stateTemplateUpdateStrategy` lo que especificaste (con cambios o periódicas) al aplicar la plantilla de estado al vehículo. Para obtener más información, consulte [Asociar una plantilla de FleetWise estado de AWS IoT a un vehículo](state-templates.md#apply-state-templates).
Además, puedes definir una hora de desactivación automática de la plantilla de estado para detener las actualizaciones después de un período de tiempo específico. Si no se proporciona una hora de desactivación automática, las plantillas de estado seguirán enviando actualizaciones hasta que se emita una llamada de desactivación.
Tan pronto como se reciba el `activate` comando, el dispositivo debería enviar las señales especificadas en la plantilla de estado de acuerdo con la estrategia de actualización. AWS IoT FleetWise recomienda que cuando el dispositivo reciba un comando de activación, el primer mensaje que envíe contenga una instantánea de todas las señales de la plantilla de estado. Los mensajes siguientes deben enviarse de acuerdo con la estrategia de actualización.
+ `deactivate`— El Edge Agent deja de enviar actualizaciones de señales a la nube.
+ `fetchSnapshot`— El Edge Agent envía una sola vez una instantánea de las señales definidas en la plantilla de estado, independientemente de las `stateTemplateUpdateStrategy` que haya especificado al aplicar la plantilla de estado al vehículo.
+ (Opcional)`$stateTemplate.deactivateAfterSeconds`: la plantilla de estado se desactiva automáticamente una vez transcurrido el tiempo especificado. Este parámetro solo se puede utilizar cuando el valor del `$stateTemplate.operation` parámetro es «activar». Si no se especifica este parámetro, o si el valor de este parámetro es 0, el Edge Agent sigue enviando actualizaciones de señales a la nube hasta que se reciba una operación de «desactivación» de la plantilla de estado. La plantilla de estado nunca se desactiva automáticamente.
Valor mínimo: 0, valor máximo: 4294967295.
**nota**
La API devuelve el resultado correcto en respuesta a una solicitud de activación de una plantilla que ya está en estado activo.
La API devuelve el resultado correcto en respuesta a una solicitud de desactivación de una plantilla que ya se encuentra en estado de desactivación.
La solicitud más reciente que realices en una plantilla de estado es la que surte efecto. Por ejemplo, si solicita la desactivación de una plantilla de estado en una hora y, a continuación, hace una segunda solicitud para que la misma plantilla se desactive en cuatro horas, la desactivación de cuatro horas entrará en vigor debido a que es la solicitud más reciente.
**importante**
Se puede producir una excepción de validación en cualquiera de los siguientes escenarios:
Se proporciona una plantilla de estado que no corresponde `ASSOCIATED` a un vehículo.
Se ha realizado una solicitud para activar una plantilla de estado, pero no ha estado `DEPLOYED` en un vehículo.
Se hace una solicitud a una plantilla de estado, pero se hace `DELETED` en un vehículo.
## Ejemplo: activar una plantilla de estado
Para activar una plantilla de estado, cree primero un recurso de comando. A continuación, puede enviar el siguiente comando al vehículo en el que desee activar la plantilla de estado. En este ejemplo se muestra cómo se pueden especificar los valores por defecto para los parámetros al crear un comando. Estos parámetros y sus valores se utilizan al iniciar la ejecución del comando para activar la plantilla de estado.
1.
**Creación de un recurso de comandos**
Antes de poder enviar un comando al vehículo, debe crear un recurso de comando. Puede especificar valores alternativos para los parámetros obligatorios al enviar el comando al vehículo. Para obtener más información, consulte [Creación de un recurso de comandos](create-manage-remote-command-cli.md#create-remote-command-cli).
**importante**
`$stateTemplate.name`y `$stateTemplate.operation` los parámetros deben proporcionarse como un tipo de datos de cadena. Si se proporciona cualquier otro tipo de datos, o si falta alguno de estos dos parámetros, se produce un error en la ejecución del comando y se produce una excepción de validación. El `$stateTemplate.deactivateAfterSeconds` parámetro debe proporcionarse como un tipo `Long` de datos.
```
aws iot create-command \
--description "This command activates a state template on a vehicle"
--command-id ActivateStateTemplate \
--display-name "Activate State Template" \
--namespace AWS-IoTFleetWise \
--mandatory-parameters '[
{
"name": "$stateTemplate.name",
"defaultValue": {"S": "ST123"}
},
{
"name": "$stateTemplate.operation",
"defaultValue": {"S": "activate"}
},
{
"name": "$stateTemplate.deactivateAfterSeconds",
"defaultValue": {"L": "120"}
}
]'
```
1.
**Inicie la ejecución del comando en el vehículo**
Una vez creado el comando, envíelo al vehículo. Si no especificó valores para los parámetros obligatorios al crear el recurso de comando, debe especificarlos ahora. Para obtener más información, consulte [Envía un comando ()AWS CLI](send-monitor-remote-command-cli.md#send-remote-command-cli).
**importante**
Asegúrese de utilizar el punto final de la API del plano de datos de AWS IoT trabajos específico de la cuenta para la operación de la API.
```
aws iot-jobs-data start-command-execution \
--endpoint-url \
--command-arn arn:aws:iot:{{region}}:{{111122223333}}:command/ActivateStateTemplate \
--target-arn arn:aws:iot:{{region}}:{{111122223333}}:thing/{{}}
```
1.
**Recupera el estado de la operación de la plantilla de estado**
Tras iniciar la ejecución del comando, puede utilizar la `GetCommandExecution` API para recuperar la plantilla de estado.
```
aws iot get-command-execution --execution-id {{}}
```
## Ejemplo: desactivar una plantilla de estado
Para desactivar una plantilla de estado, cree primero un recurso de comando. A continuación, puede enviar el siguiente comando al vehículo en el que desee desactivar la plantilla de estado. En este ejemplo se muestra cómo se pueden especificar los valores por defecto para los parámetros al crear un comando. Estos parámetros y sus valores se utilizan al iniciar la ejecución del comando para desactivar la plantilla de estado.
1.
**Creación de un recurso de comandos**
Antes de poder enviar un comando al vehículo, debe crear un recurso de comando. Puede especificar valores alternativos para los parámetros obligatorios al enviar el comando al vehículo. Para obtener más información, consulte [Creación de un recurso de comandos](create-manage-remote-command-cli.md#create-remote-command-cli).
```
aws iot create-command \
--description "This command deactivates a state template on a vehicle"
--command-id DeactivateStateTemplate \
--display-name "Deactivate State Template" \
--namespace AWS-IoTFleetWise \
--mandatory-parameters '[
{
"name": "$stateTemplate.name",
"defaultValue": {"S": "ST123"}
},
{
"name": "$stateTemplate.operation",
"defaultValue": {"S": "deactivate"}
}
]'
```
1.
**Inicie la ejecución del comando en el vehículo**
Una vez creado el comando, envíelo al vehículo. Si no especificó valores para los parámetros obligatorios al crear el recurso de comando, debe especificarlos ahora. Para obtener más información, consulte [Envía un comando ()AWS CLI](send-monitor-remote-command-cli.md#send-remote-command-cli).
```
aws iot-jobs-data start-command-execution \
--endpoint-url \
--command-arn arn:aws:iot:{{region}}:{{111122223333}}:command/DeactivateStateTemplate \
--target-arn arn:aws:iot:{{region}}:{{111122223333}}:thing/{{}}
```
1.
**Recupera el estado de la operación de la plantilla de estado**
Tras iniciar la ejecución del comando, puede utilizar la `GetCommandExecution` API para recuperar la plantilla de estado.
```
aws iot get-command-execution --execution-id {{}}
```