Déprécier une ressource de commande - AWS IoT Core
Considérations clésDéprécier une ressource de commande (console)Déprécier une ressource de commande () CLIVérifiez l'heure et le statut de la dépréciationRestaurer une ressource de commande

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Déprécier une ressource de commande

Vous pouvez déprécier une commande pour indiquer qu'elle n'est pas à jour et qu'elle ne doit pas être utilisée. Par exemple, vous pouvez rendre obsolète une commande qui n'est plus activement maintenue, ou vous pouvez créer une commande plus récente avec le même ID de commande mais utilisant des informations de charge utile différentes.

Considérations clés

Voici quelques points importants à prendre en compte lors de la dépréciation d'une commande :

  • Lorsque vous désapprouvez une commande, elle n'est pas supprimée. Vous pouvez toujours récupérer la commande à l'aide de son ID de commande et la restaurer si vous souhaitez la réutiliser.

  • Si vous essayez de démarrer l'exécution d'une nouvelle commande sur votre machine cible pour une commande obsolète, cela génère une erreur qui vous empêche d'utiliser out-of-date les commandes.

  • Pour exécuter une commande obsolète sur votre machine cible, vous devez d'abord la restaurer. Une fois restaurée, la commande devient disponible et peut être utilisée comme commande normale et vous pouvez exécuter des commandes sur le périphérique cible.

  • Si vous désapprouvez une commande alors que son exécution est en cours, les exécutions continueront de s'exécuter sur le périphérique cible jusqu'à ce qu'elles soient terminées. Vous pouvez également récupérer le statut des exécutions de commandes.

Déprécier une ressource de commande (console)

Pour désactiver une commande depuis la console, accédez au hub de commande de la AWS IoT console et effectuez les étapes suivantes.

  1. Choisissez la commande que vous souhaitez déprécier, puis sous Actions, choisissez Déprécier.

  2. Confirmez que vous souhaitez déprécier la commande, puis choisissez Déprécier.

Déprécier une ressource de commande () CLI

Vous pouvez marquer une commande comme obsolète à l'aide du. update-command CLI Vous devez d'abord déprécier une commande avant de pouvoir la supprimer. Une fois qu'une commande est devenue obsolète, si vous souhaitez l'utiliser, par exemple pour envoyer une exécution de commande à l'appareil cible, vous devez la déprécier.

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

Par exemple, si vous avez déconseillé la ACSwitch commande que vous avez mise à jour dans l'exemple ci-dessus, le code suivant montre un exemple de sortie de l'exécution de la commande.

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

Vérifiez l'heure et le statut de la dépréciation

Vous pouvez utiliser cette GetCommand API opération pour déterminer si une commande est obsolète et quand elle l'a été pour la dernière fois.

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

L'exécution de cette commande génère une réponse contenant des informations sur la commande. Vous pouvez obtenir des informations indiquant quand il a été créé et quand il a été déconseillé à l'aide des dernières informations mises à jour. Ces informations peuvent vous aider à déterminer la durée de vie d'une commande et à déterminer si vous souhaitez la supprimer ou la réutiliser. Par exemple, dans l'turnOffAcexemple ci-dessus, le code suivant montre un exemple de réponse. 

{
    "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
}

Restaurer une ressource de commande

Pour utiliser la ACSwitch commande ou pour l'envoyer à votre appareil, vous devez la restaurer.

Pour restaurer une commande depuis la console, accédez au hub de commande de la AWS IoT console, choisissez la commande que vous souhaitez restaurer, puis sous Actions, choisissez Restaurer.

Pour restaurer une commande à l'aide du AWS IoT Core API ou du AWS CLI, utilisez l'UpdateCommandAPIopération ou le update-commandCLI. Le code suivant montre un exemple de demande et de réponse.

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

Le code suivant montre un exemple de sortie.

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