Obsolescencia de un recurso de comandos - AWS IoT Core
Consideraciones claveObsolescencia de un recurso de comandos (consola)Obsolescencia de un recurso de comandos (CLI)Comprobación del tiempo y el estado de obsolescenciaRestauración de un recurso de comando

Obsolescencia de un recurso de comandos

Puede dar de baja un comando para indicar que está desactualizado y no debería utilizarse. Por ejemplo, puede dar de baja un comando que ya no se mantenga activo o es posible que desee crear un comando más reciente con el mismo ID de comando, pero con otra información sobre la carga útil.

Consideraciones clave

A continuación, se indican una serie de consideraciones importantes a la hora de dar de baja un comando:

  • Cuando se da de baja un comando, este no se elimina. Aún puede recuperar el comando con el ID de comando y restaurarlo si desea volver a utilizarlo.

  • Si intenta iniciar la ejecución de un nuevo comando en el dispositivo de destino para un comando que ha quedado obsoleto, se generará un error que le impedirá utilizar comandos desactualizados.

  • Para ejecutar un comando obsoleto en el dispositivo de destino, primero debe restaurarlo. Una vez restaurado, el comando pasa a estar disponible y se puede utilizar como un comando normal. También podrá ejecutar comandos en el dispositivo de destino.

  • Si da de baja un comando mientras se está ejecutando, las ejecuciones seguirán llevándose a cabo en el dispositivo de destino hasta que se completen. También puede recuperar el estado de las ejecuciones de comandos.

Obsolescencia de un recurso de comandos (consola)

Para dar de baja un comando desde la consola, vaya al Centro de comandos de la consola de AWS IoT y lleve a cabo los siguientes pasos.

  1. Elija el comando que desea dar de baja y, a continuación, en Acciones, elija Dejar de utilizar.

  2. Confirme que desea dar de baja el comando y, a continuación, seleccione Dejar de utilizar.

Obsolescencia de un recurso de comandos (CLI)

Puede marcar un comando como obsoleto mediante la CLI update-command. Primero debe dar de baja un comando para poder eliminarlo. Una vez que un comando haya quedado obsoleto, si quiere usarlo, por ejemplo, para enviar una ejecución de comando al dispositivo de destino, debe anular su obsolescencia.

aws iot update-command \ 
    --command-id <command-id> \ 
    --deprecated

Por ejemplo, si ha dado de baja el comando ACSwitch que actualizó en el ejemplo anterior, en el código siguiente se muestra un ejemplo del resultado de la ejecución del comando.

{
    "commandId": "turnOffAc",
    "deprecated": true,
    "lastUpdatedAt": "2024-05-09T23:16:51.370000-07:00"
}

Comprobación del tiempo y el estado de obsolescencia

Puede utilizar la operación de la API GetCommand para determinar si un comando ha quedado obsoleto y cuándo se ha dejado de utilizar por última vez.

aws iot get-command --command-id <turnOffAC>

Al ejecutar este comando, se genera una respuesta que incluye información sobre el comando. Puede obtener más información sobre cuándo se creó y cuándo quedó obsoleto mediante la última información actualizada. Esta información puede ayudarlo a determinar la duración de un comando y si desea eliminarlo o volver a utilizarlo. Por ejemplo, en el anterior ejemplo de turnOffAc, en el siguiente código se muestra una respuesta de ejemplo. 

{
    "commandId": "turnOffAC",
    "commandArn": "arn:aws:iot:ap-south-1:123456789012:command/turnOffAC",
    "namespace": "AWS-IoT",
    "payload": {
        "content": "testPayload.json",
        "contentType": "application/json"
    },
    "createdAt": "2024-03-23T00:50:10.095000-07:00",
    "lastUpdatedAt": "2024-05-09T23:16:51.370000-07:00",
    "deprecated": false
}

Restauración de un recurso de comando

Para usar el comando ACSwitch o enviar este comando al dispositivo, debe restaurarlo.

Para restaurar un comando desde la consola, vaya al Centro de comandos de la consola de AWS IoT, elija el comando que desee restaurar y, a continuación, en Acciones, elija Restaurar.

Para restaurar un comando mediante la API de AWS IoT Core o la AWS CLI, utilice la operación de la API UpdateCommand o la CLI update-command. En el siguiente código se muestra una solicitud y una respuesta de ejemplo.

aws iot update-command \ 
    --command-id <command-id> 
    --no-deprecated

En el siguiente código se muestra un resultado de ejemplo.

{
    "commandId": "ACSwitch",
    "deprecated": false,
    "lastUpdatedAt": "2024-05-09T23:17:21.954000-07:00"
}