Suspender um recurso de comando - AWS IoT Core
Considerações importantesSuspender um recurso de comando (console)Suspender um recurso de comando (CLI)Conferir a hora e o status da suspensãoRestaurar um recurso de comando

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Suspender um recurso de comando

Desative os comandos para indicar que estão desatualizados e não devem ser usados. Por exemplo, os comandos obsoletos não são mais mantidos ativamente ou ao criar comandos mais novos com o mesmo ID, mas com cargas diferentes.

Considerações importantes

Considerações importantes ao descontinuar comandos:

  • A descontinuação de um comando não o exclui. Você pode recuperar o comando usando seu ID e restaurá-lo para reutilização.

  • A tentativa de iniciar novas execuções em comandos obsoletos gera um erro, impedindo o uso de comandos desatualizados.

  • Para executar um comando obsoleto, primeiro restaure-o. Após a restauração, o comando fica disponível para uso e execução regulares nos dispositivos de destino.

  • Se você descontinuar um comando enquanto as execuções estiverem em andamento, elas continuarão em execução até serem concluídas. Você ainda pode recuperar o status de execução.

Suspender um recurso de comando (console)

Para descontinuar um comando do console, acesse o Command Hub do AWS IoT console e execute as etapas a seguir.

  1. Escolha o comando que você deseja descontinuar e, em Ações, escolha Descontinuar.

  2. Confirme que você deseja suspender o comando e, depois, selecione Suspender.

Suspender um recurso de comando (CLI)

Marque os comandos como obsoletos usando a CLI. update-command Você deve descontinuar um comando antes de excluí-lo. Para usar um comando obsoleto, restaure-o primeiro.

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

Por exemplo, se você suspendeu o comando ACSwitch atualizado no exemplo acima, o código a seguir mostrará um exemplo de saída da execução.

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

Conferir a hora e o status da suspensão

Use a GetCommand API para determinar se um comando está obsoleto e quando foi descontinuado pela última vez.

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

Esse comando gera uma resposta contendo informações do comando, incluindo registros de data e hora de criação e descontinuação do último campo atualizado. Isso ajuda a determinar a vida útil do comando e se ele deve ser excluído ou reutilizado. Veja a seguir um exemplo de resposta para o 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
}

Restaurar um recurso de comando

Para usar ou enviar o ACSwitch comando para seu dispositivo, restaure-o primeiro.

Para restaurar um comando do console, acesse o Hub de Comando do AWS IoT console, escolha o comando que você deseja restaurar e, em Ações, escolha Restaurar.

Para restaurar um comando usando a AWS IoT Core API ou a AWS CLI, use a operação da UpdateCommand API ou a update-command CLI. O código a seguir mostra um exemplo de solicitação e resposta.

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

O código a seguir mostra um exemplo de saída.

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