Eine Befehlsressource als veraltet kennzeichnen - AWS IoT Core
Wichtige ÜberlegungenEine Befehlsressource (Konsole) als veraltet kennzeichnenVerwerfen Sie eine Befehlsressource () CLIÜberprüfen Sie den Zeitpunkt und den Status der DeprecationStellen Sie eine Befehlsressource wieder her

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Eine Befehlsressource als veraltet kennzeichnen

Sie können einen Befehl als veraltet kennzeichnen, um anzugeben, dass er veraltet ist und nicht verwendet werden sollte. Sie könnten beispielsweise einen Befehl verwerfen, der nicht mehr aktiv verwaltet wird, oder Sie möchten einen neueren Befehl mit derselben Befehls-ID erstellen, der jedoch andere Payload-Informationen verwendet.

Wichtige Überlegungen

Im Folgenden sind einige wichtige Überlegungen zur Ablehnung eines Befehls aufgeführt:

  • Wenn Sie einen Befehl als veraltet markieren, wird er nicht gelöscht. Sie können den Befehl immer noch mit seiner Befehls-ID abrufen und wiederherstellen, wenn Sie den Befehl wiederverwenden möchten.

  • Wenn Sie versuchen, auf Ihrem Zielgerät eine neue Befehlsausführung für einen veralteten Befehl zu starten, wird ein Fehler generiert, der Sie daran hindert, Befehle zu verwenden out-of-date.

  • Um einen veralteten Befehl auf Ihrem Zielgerät auszuführen, müssen Sie ihn zunächst wiederherstellen. Nach der Wiederherstellung ist der Befehl verfügbar und kann als regulärer Befehl verwendet werden, und Sie können Befehlsausführungen auf dem Zielgerät ausführen.

  • Wenn Sie einen Befehl verwerfen, während die Befehlsausführungen ausgeführt werden, werden die Ausführungen auf dem Zielgerät weiter ausgeführt, bis sie abgeschlossen sind. Sie können auch den Status der Befehlsausführungen abrufen.

Eine Befehlsressource (Konsole) als veraltet kennzeichnen

Um einen Befehl aus der Konsole als veraltet zu kennzeichnen, gehen Sie zum Command Hub der AWS IoT Konsole und führen Sie die folgenden Schritte aus.

  1. Wählen Sie den Befehl aus, den Sie verwerfen möchten, und wählen Sie dann unter Aktionen die Option Veraltet aus.

  2. Bestätigen Sie, dass Sie den Befehl als veraltet markieren möchten, und wählen Sie dann Veraltet aus.

Verwerfen Sie eine Befehlsressource () CLI

Sie können einen Befehl mit dem als veraltet markieren. update-command CLI Sie müssen einen Befehl zuerst als veraltet markieren, bevor er gelöscht werden kann. Sobald ein Befehl veraltet ist und Sie ihn verwenden möchten, z. B. um eine Befehlsausführung an das Zielgerät zu senden, müssen Sie ihn rückgängig machen.

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

Wenn Sie beispielsweise den ACSwitch Befehl, den Sie im obigen Beispiel aktualisiert haben, als veraltet eingestuft haben, zeigt der folgende Code eine Beispielausgabe der Ausführung des Befehls.

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

Überprüfen Sie den Zeitpunkt und den Status der Deprecation

Sie können den GetCommand API Vorgang verwenden, um festzustellen, ob ein Befehl veraltet ist und wann er zuletzt als veraltet eingestuft wurde.

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

Wenn Sie diesen Befehl ausführen, wird eine Antwort generiert, die Informationen über den Befehl enthält. Anhand der zuletzt aktualisierten Informationen können Sie Informationen darüber abrufen, wann er erstellt wurde und wann er veraltet war. Anhand dieser Informationen können Sie die Gültigkeitsdauer eines Befehls bestimmen und feststellen, ob Sie den Befehl löschen oder wiederverwenden möchten. Im obigen turnOffAc Beispiel zeigt der folgende Code beispielsweise eine Beispielantwort. 

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

Stellen Sie eine Befehlsressource wieder her

Um den ACSwitch Befehl zu verwenden oder ihn an Ihr Gerät zu senden, müssen Sie ihn wiederherstellen.

Um einen Befehl von der Konsole wiederherzustellen, rufen Sie den Command Hub der AWS IoT Konsole auf, wählen Sie den Befehl aus, den Sie wiederherstellen möchten, und wählen Sie dann unter Aktionen die Option Wiederherstellen aus.

Um einen Befehl mithilfe von AWS IoT Core API oder wiederherzustellen AWS CLI, verwenden Sie die UpdateCommand API Operation oder update-commandCLI. Der folgende Code zeigt ein Beispiel für eine Anfrage und eine Antwort.

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

Der folgende Code zeigt eine Beispielausgabe.

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