Deprecare una risorsa di comando - AWS IoT Core
Considerazioni chiaveDeprecare una risorsa di comando (console)Deprecare una risorsa di comando (CLI)Controlla l'ora e lo stato di deprecazioneRipristina una risorsa di comando

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Deprecare una risorsa di comando

Deprecate i comandi per indicare che sono obsoleti e non devono essere utilizzati. Ad esempio, i comandi obsoleti non vengono più mantenuti attivamente o quando si creano comandi più recenti con lo stesso ID ma payload diversi.

Considerazioni chiave

Considerazioni importanti sulla deprecazione dei comandi:

  • La deprecazione di un comando non lo elimina. È possibile recuperare il comando utilizzando il relativo ID e ripristinarlo per riutilizzarlo.

  • Il tentativo di avviare nuove esecuzioni su comandi obsoleti genera un errore che impedisce l'uso di comandi obsoleti.

  • Per eseguire un comando obsoleto, è necessario innanzitutto ripristinarlo. Dopo il ripristino, il comando diventa disponibile per l'uso e l'esecuzione regolari sui dispositivi di destinazione.

  • Se si rende obsoleto un comando mentre le esecuzioni sono in corso, queste continuano a funzionare fino al completamento. È comunque possibile recuperare lo stato di esecuzione.

Deprecare una risorsa di comando (console)

Per rendere obsoleto un comando dalla console, accedi al Command Hub della AWS IoT console ed esegui i seguenti passaggi.

  1. Scegli il comando che desideri rendere obsoleto, quindi in Azioni scegli Deprecate.

  2. Conferma che desideri rendere obsoleto il comando, quindi scegli Deprecate.

Deprecare una risorsa di comando (CLI)

Contrassegna i comandi come obsoleti utilizzando la CLI. update-command È necessario rendere obsoleto un comando prima dell'eliminazione. Per utilizzare un comando obsoleto, ripristinalo prima.

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

Ad esempio, se avete reso obsoleto il ACSwitch comando aggiornato nell'esempio precedente, il codice seguente mostra un esempio di output dell'esecuzione del comando.

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

Controlla l'ora e lo stato di deprecazione

Utilizza l'GetCommandAPI per determinare se un comando è obsoleto e quando è stato deprecato l'ultima volta.

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

Questo comando genera una risposta contenente informazioni sul comando, inclusi i timestamp di creazione e deprecazione relativi all'ultimo campo aggiornato. Ciò consente di determinare la durata del comando e se eliminarlo o riutilizzarlo. Di seguito viene illustrato un esempio di risposta per il 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
}

Ripristina una risorsa di comando

Per utilizzare o inviare il ACSwitch comando al dispositivo, ripristinalo prima.

Per ripristinare un comando dalla console, vai al Command Hub della AWS IoT console, scegli il comando che desideri ripristinare, quindi in Azioni scegli Ripristina.

Per ripristinare un comando utilizzando l' AWS IoT Core API o il AWS CLI, utilizza l'operazione UpdateCommand API o la update-command CLI. Il codice seguente mostra un esempio di richiesta e risposta.

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

Il codice seguente mostra un output di esempio.

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