Obsolescence d’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 (CLI)Vé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.

Obsolescence d’une ressource de commande

Dépréciez les commandes pour indiquer qu'elles sont obsolètes et ne doivent pas être utilisées. Par exemple, dépréciez les commandes qui ne sont plus maintenues activement ou lorsque vous créez de nouvelles commandes avec le même identifiant mais des charges utiles différentes.

Considérations clés

Considérations importantes à prendre en compte lors de la dépréciation de commandes :

  • La dépréciation d'une commande ne la supprime pas. Vous pouvez récupérer la commande à l'aide de son identifiant et la restaurer pour la réutiliser.

  • Toute tentative de lancement de nouvelles exécutions sur des commandes obsolètes génère une erreur, empêchant ainsi l'utilisation de commandes obsolètes.

  • Pour exécuter une commande obsolète, restaurez-la d'abord. Après restauration, la commande devient disponible pour une utilisation et une exécution régulières sur les appareils cibles.

  • Si vous désapprouvez une commande alors que son exécution est en cours, elle continue de s'exécuter jusqu'à la fin. Vous pouvez toujours récupérer le statut d'exécution.

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)

Marquez les commandes comme obsolètes à l'aide de la CLIupdate-command. Vous devez déprécier une commande avant de la supprimer. Pour utiliser une commande obsolète, restaurez-la d'abord.

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

Utilisez l'GetCommandAPI 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>

Cette commande génère une réponse contenant des informations de commande, notamment les horodatages de création et de dépréciation à partir du dernier champ mis à jour. Cela permet de déterminer la durée de vie des commandes et de déterminer s'il faut les supprimer ou les réutiliser. Voici un exemple de réponse à la turnOffAc commande :

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

Restaurer une ressource de commande

Pour utiliser ou envoyer la ACSwitch commande sur votre appareil, restaurez-la d'abord.

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 de l' AWS IoT Core API ou du AWS CLI, utilisez l'opération UpdateCommand API ou la update-command CLI. 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"
}