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
<a name="iot-remote-command-deprecate"></a>

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
<a name="iot-remote-command-deprecate-considerations"></a>

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)
<a name="iot-remote-command-deprecate-console"></a>

Para descontinuar um comando do console, acesse o [Command Hub](https://console.aws.amazon.com/iot/home#/commandHub) do AWS IoT console e execute as etapas a seguir.

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

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

## Suspender um recurso de comando (CLI)
<a name="iot-remote-command-deprecate-cli"></a>

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
<a name="iot-remote-command-deprecate-check"></a>

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
<a name="iot-remote-command-undeprecate"></a>

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

Para restaurar um comando do console, acesse o [Hub de Comando](https://console.aws.amazon.com/iot/home#/commandHub) 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"
}
```