View a markdown version of this page

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 deprezzamentoRipristinare 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

Elimina i comandi per indicare che sono obsoleti e non devono essere utilizzati. Ad esempio, depreca i comandi che non sono più gestiti 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 il riutilizzo.

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

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

  • Se si depreca un comando mentre sono in corso delle esecuzioni, queste continuano a essere eseguite fino al completamento. È ancora possibile recuperare lo stato di esecuzione.

Deprecare una risorsa di comando (console)

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

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

  2. Conferma che desideri deprecare il comando, quindi scegli Deprecate.

Deprecare una risorsa di comando (CLI)

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

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

Ad esempio, se avete reso obsoleto il ACSwitch comando che avete 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 deprezzamento

Usa 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 le informazioni sul comando, inclusi i timestamp di creazione e deprecazione dell'ultimo campo aggiornato. Ciò consente di determinare la durata del comando e se eliminarlo o riutilizzarlo. Di seguito viene mostrato 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
}

Ripristinare 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, usa 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 esempio di output.

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