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

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.

Obsolescencia de un recurso de comandos

Desactive los comandos para indicar que están desactualizados y no deben utilizarse. Por ejemplo, desactive los comandos que ya no se mantienen de forma activa o al crear comandos más nuevos con el mismo identificador pero con diferentes cargas útiles.

Consideraciones clave

Consideraciones importantes a la hora de dejar de usar comandos:

  • La desaprobación de un comando no lo elimina. Puede recuperar el comando con su ID y restaurarlo para volver a utilizarlo.

  • Al intentar iniciar nuevas ejecuciones de comandos obsoletos, se genera un error que impide el uso de comandos obsoletos.

  • Para ejecutar un comando obsoleto, restáurelo primero. Tras la restauración, el comando estará disponible para su uso y ejecución habituales en los dispositivos de destino.

  • Si desaprueba un comando mientras las ejecuciones están en curso, seguirán ejecutándose hasta que se complete. Aún puede recuperar el estado de ejecución.

Obsolescencia de un recurso de comandos (consola)

Para anular un comando de la consola, vaya al centro de comandos de la AWS IoT consola y lleve a cabo los siguientes pasos.

  1. Elija el comando que desee desaprobar y, a continuación, en Acciones, elija Depredar.

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

Obsolescencia de un recurso de comandos (CLI)

Marque los comandos como obsoletos mediante la update-command CLI. Debe desaprobar un comando antes de eliminarlo. Para usar un comando obsoleto, restaúrelo primero.

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

Usa la GetCommand API para determinar si un comando está obsoleto y cuándo fue obsoleto por última vez.

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

Este comando genera una respuesta que contiene información sobre el comando, incluidas las marcas de tiempo de creación y obsolescencia del último campo actualizado. Esto ayuda a determinar la duración del comando y si se debe eliminar o reutilizar. A continuación se muestra un ejemplo de respuesta para el turnOffAc comando:

{
    "commandId": "turnOffAC",
    "commandArn": "arn:aws:iot:us-east-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 o enviar el ACSwitch comando a su dispositivo, restaúrelo primero.

Para restaurar un comando desde la consola, ve al centro de comandos de la AWS IoT consola, elige el comando que deseas restaurar y, a continuación, en Acciones, selecciona Restaurar.

Para restaurar un comando mediante la AWS IoT Core API o la AWS CLI, utilice la operación UpdateCommand API o la update-command CLI. 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"
}