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á.

# Excluindo uma agenda no Scheduler EventBridge
<a name="managing-schedule-delete"></a>

Você pode excluir um agendamento configurando a exclusão automática ou excluindo manualmente um agendamento individual. Use os tópicos a seguir para saber como excluir um agendamento usando os dois métodos e por que você pode escolher um método em vez do outro.

**Topics**
+ [Exclusão após a conclusão do agendamento](#managing-schedule-automatic-deletion)
+ [Exclusão manual](#managing-schedule-manual-deletion)

## Exclusão após a conclusão do agendamento
<a name="managing-schedule-automatic-deletion"></a>

Configure a exclusão automática após a conclusão do cronograma se quiser evitar ter que gerenciar individualmente seus recursos de EventBridge agendamento no Scheduler. Em aplicativos em que você cria milhares de agendamentos ao mesmo tempo e precisa de flexibilidade para aumentar a escala verticalmente do número de seus agendamentos sob demanda, a exclusão automática pode garantir que você não atinja a cota da sua conta para o [número de agendamentos](scheduler-quotas.md) em uma região específica.

Quando você configura a exclusão automática de um EventBridge agendamento, o Scheduler exclui o agendamento após sua última invocação de destino. Para agendamentos únicos, isso ocorre após o agendamento ter invocado seu destino uma vez. Para agendamentos recorrentes que você configura com expressões rate ou cron, seu agendamento é excluído após a última invocação. A última invocação de um agendamento recorrente é a invocação que ocorre mais próxima da [https://docs.aws.amazon.com/scheduler/latest/APIReference/API_CreateSchedule.html#scheduler-CreateSchedule-request-EndDate](https://docs.aws.amazon.com/scheduler/latest/APIReference/API_CreateSchedule.html#scheduler-CreateSchedule-request-EndDate) que você especificou. Se você configurar um agendamento com exclusão automática, mas não especificar um valor para`EndDate`, o EventBridge Agendador não excluirá automaticamente o agendamento.

Você pode configurar a exclusão automática ao criar um agendamento pela primeira vez ou atualizar as preferências de um agendamento existente. As etapas a seguir descrevem como configurar exclusão automática para um agendamento existente.

------
#### [ Console de gerenciamento da AWS ]

1. Abra o console do EventBridge Scheduler em. [https://console.aws.amazon.com/scheduler/](https://console.aws.amazon.com/scheduler/)

1.  Na lista de agendamentos, selecione o agendamento que você deseja editar e escolha **Editar**. 

1.  No painel de navegação à esquerda, selecione **Configurações**. 

1.  Na seção **Ação após a conclusão do agendamento**, selecione **EXCLUIR** na lista suspensa e salve suas alterações. 

------
#### [ AWS CLI ]

1.  Abra uma nova janela de prompt. 

1.  Use o AWS CLI comando [update-schedule]() para atualizar uma agenda existente, conforme mostrado a seguir. O comando define o `--action-after-completion` para `DELETE`. Este exemplo pressupõe que você definiu sua configuração de destino localmente em um arquivo JSON. Para atualizar um agendamento, você deve fornecer a meta, bem como quaisquer outros parâmetros de agendamento que você queira configurar para o seu agendamento existente. 

    Essa é um agendamento recorrente com uma taxa de uma invocação por hora. Portanto, você especifica uma data de término ao definir o parâmetro `--action-after-completion`. 

   ```
   $ aws scheduler update-schedule --name schedule-name \
   --action-after-completion 'DELETE' \
   --schedule-expression 'rate(1 hour)' \
   --end-date '2024-01-01T00:00:00'
   --target file://target-configuration.json \
   --flexible-time-window '{ "Mode": "OFF"}' \
   ```

------

## Exclusão manual
<a name="managing-schedule-manual-deletion"></a>

 Quando não precisar mais de um agendamento, você pode excluí-lo usando a operação [https://docs.aws.amazon.com/scheduler/latest/APIReference/API_DeleteSchedule.html](https://docs.aws.amazon.com/scheduler/latest/APIReference/API_DeleteSchedule.html). 

**Example AWS CLI**  

```
$ aws scheduler delete-schedule --name your-schedule
```

**Example Python SDK**  

```
import boto3
scheduler = boto3.client('scheduler')
    
scheduler.delete_schedule(Name="your-schedule")
```