View a markdown version of this page

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

Elimine los comandos para indicar que están desactualizados y no deben usarse. Por ejemplo, los comandos obsoletos que ya no se mantienen activamente o al crear comandos más nuevos con el mismo ID pero con cargas útiles diferentes.

Consideraciones clave

Consideraciones importantes a la hora de desaprobar los comandos:

  • Al desaprobar un comando, no se borra. Puede recuperar el comando con su ID y restaurarlo para volver a usarlo.

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

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

  • Si desactivas un comando mientras las ejecuciones están en curso, seguirán ejecutándose hasta su finalización. Aún puedes 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. Elige el comando que quieres dejar en desuso y, a continuación, en Acciones, selecciona Desaprobar.

  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 CLI. update-command Debe desaprobar un comando antes de eliminarlo. Para usar un comando obsoleto, restaure primero el comando.

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á en desuso y cuándo estuvo 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 desactivación 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 al dispositivo, restaure primero el comando.

Para restaurar un comando desde la consola, ve al centro de comandos de la AWS IoT consola, elige el comando que quieres 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 de la 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"
}