

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

# Agendamento de quando a tarefa do AWS DataSync será executada
<a name="task-scheduling"></a>

Você pode configurar um agendamento de tarefa do AWS DataSync para transferir dados entre locais periodicamente.

## Como funciona o agendamento de tarefa do DataSync
<a name="how-task-scheduling-works"></a>

Uma tarefa agendada do DataSync é executada com a frequência que você configura, com intervalo mínimo de 1 hora. Você pode criar um agendamento de tarefas usando as expressões cron ou rate.

**Importante**  
Você não pode agendar uma tarefa para ser executada a intervalos de menos de 1 hora.

**Usar expressões cron**  
Use expressões cron para agendamentos de tarefas executadas em hora e dia específicos. Por exemplo, veja como você pode configurar o agendamento de uma tarefa na AWS CLI para ser executada todo domingo e toda quarta-feira às 12h UTC.  

```
cron(0 12 ? * SUN,WED *)
```

**Uso de expressões rate**  
Use expressões rate para agendamentos de tarefas que são executadas a intervalos regulares, como a cada 12 horas. Por exemplo, aqui está como você pode configurar o agendamento de uma tarefa na AWS CLI para ser executada a cada 12 horas:  

```
rate(12 hours)
```

**dica**  
Para obter mais informações sobre a sintaxe das expressões cron e rate, consulte o [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html).

## Criação de um agendamento de tarefa do DataSync
<a name="configure-task-schedule"></a>

Você pode agendar com que frequência a tarefa é executada usando o console do DataSync, a AWS CLI ou a API do DataSync.

### Utilizar o console do DataSync
<a name="configure-task-schedule-console"></a>

As instruções a seguir descrevem como configurar um agendamento ao criar uma tarefa. Você pode modificar o agendamento posteriormente quando editar a tarefa.

No console, algumas opções de agendamento permitem que você especifique a hora exata que a tarefa é executada (como diariamente às 22h30). Se você não incluir um horário para essas opções, a tarefa será executada no momento que você a criar (ou atualizar).

1. Abra o console do AWS DataSync em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. No painel de navegação esquerdo, expanda **Transferência de dados**, escolha **Tarefas** e, em seguida, escolha **Criar tarefa**.

1. Configure os locais de origem e destino da sua tarefa.

   Para obter mais informações, consulte . [Para onde posso transferir meus dados AWS DataSync?](working-with-locations.md)

1. Em **Frequência**, escolha uma das seguintes opções:
   + Escolha **Não agendada** se não quiser agendar a execução periódica da tarefa.
   + Escolha **A cada hora** e depois escolha a quantos minutos da hora você deseja que a tarefa seja executada. 
   + Escolha **Diariamente** e insira a hora UTC que você deseja que a tarefa seja executada.
   + Escolha **Semanalmente** e o dia da semana, e insira a hora UTC que você deseja que a tarefa seja executada.
   + Escolha **Dias da semana**, escolha um dia ou dias específicos e insira a hora UTC que a tarefa deve ser executada no formato HH:MM.
   + Escolha **Personalizado** e selecione **Expressão Cron** ou **Expressão rate**. Insira o agendamento da tarefa com um intervalo mínimo de 1 hora. 

### Como usar o AWS CLI
<a name="configure-task-schedule-api"></a>

Você pode criar um agendamento para a tarefa do DataSync usando o parâmetro `--schedule` com o comando `create-task`, `update-task` ou `start-task-execution`.

As instruções a seguir descrevem como fazer isso com o comando `create-task`.

1. Copie o seguinte comando `create-task`:

   ```
   aws datasync create-task \
     --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
     --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
     --schedule '{
       "ScheduleExpression": "cron(0 12 ? * SUN,WED *)"
     }'
   ```

1. No parâmetro `--source-location-arn`, especifique o nome do recurso da Amazon (ARN) do local de onde você está transferindo os dados.

1. No parâmetro `--destination-location-arn`, especifique o ARN do local para onde você está transferindo os dados.

1. No parâmetro `--schedule`, especifique uma expressão cron ou rate para o agendamento.

   No exemplo, a expressão cron `cron(0 12 ? * SUN,WED *)` define um agendamento de tarefa para execução todo domingo e toda quarta-feira às 12h UTC.

1. Execute o comando `create-task` para criar a tarefa com o agendamento.

## Pausa de um agendamento de tarefa do DataSync
<a name="pause-task-schedule"></a>

Pode haver situações em que você precise pausar o agendamento de tarefas do DataSync. Por exemplo, pode ser necessário desabilitar temporariamente uma transferência recorrente para corrigir um problema com a tarefa ou realizar a manutenção do sistema de armazenamento.

O DataSync pode desabilitar o agendamento da tarefa automaticamente pelos seguintes motivos:
+ Falhas recorrentes na tarefa com o mesmo erro.
+ Você [desabilita uma Região da AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) que a tarefa está usando.

### Utilizar o console do DataSync
<a name="pause-scheduled-task-console"></a>

1. Abra o console do AWS DataSync em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. No painel de navegação esquerdo, expanda **Transferência de dados** e selecione **Tarefas**.

1. Escolha a tarefa cujo agendamento você deseja pausar e escolha **Editar**.

1. Em **Agendamento**, desative **Habilitar agendamento**. Escolha **Salvar alterações**.

### Como usar o AWS CLI
<a name="pause-scheduled-task-cli"></a>

1. Copie o seguinte comando `update-task`:

   ```
   aws datasync update-task \
     --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
     --schedule '{
       "ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
       "Status": "DISABLED"
     }'
   ```

1. No parâmetro `--task-arn`, especifique o ARN da tarefa cujo agendamento você deseja pausar.

1. No parâmetro `--schedule` faça o seguinte:
   + Em `ScheduleExpression`, especifique uma expressão cron ou rate para o agendamento.

     No exemplo, a expressão `cron(0 12 ? * SUN,WED *)` define o agendamento de uma tarefa para execução todo domingo e toda quarta-feira às 12h UTC.
   + Em `Status`, especifique `DISABLED` para pausar o agendamento da tarefa.

1. Execute o comando `update-task`.

1. Para retomar o agendamento, execute o mesmo comando `update-task` com `Status` definido como `ENABLED`.

## Verificação do status do agendamento de uma tarefa do DataSync
<a name="check-scheduled-task"></a>

Você pode ver se o agendamento da tarefa do DataSync está habilitado. 

### Utilizar o console do DataSync
<a name="check-scheduled-task-console"></a>

1. Abra o console do AWS DataSync em [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. No painel de navegação esquerdo, expanda **Transferência de dados** e selecione **Tarefas**.

1. Na coluna **Agendamento**, verifique se o agendamento da tarefa está habilitado ou desabilitado.

### Como usar o AWS CLI
<a name="check-scheduled-task-cli"></a>

1. Copie o seguinte comando `describe-task`:

   ```
   aws datasync describe-task \
     --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh
   ```

1. No parâmetro `--task-arn`, especifique o ARN da tarefa sobre a qual você deseja informações.

1. Execute o comando `describe-task`.

Você recebe uma resposta que fornece detalhes sobre a tarefa, incluindo seu agendamento. (O foco do exemplo a seguir é principalmente na configuração do agendamento de tarefa e não mostra uma resposta completa a `describe-task`.)

O exemplo mostra que o agendamento da tarefa foi desabilitado manualmente. Se o agendamento foi desabilitado pelo `SERVICE` DataSync, você verá uma mensagem de erro para `DisabledReason` para ajudar a entender por que a tarefa continua apresentando falhas. Para obter mais informações, consulte [Solução de AWS DataSync problemas](troubleshooting-datasync.md).

```
{
    "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh",
    "Status": "AVAILABLE",
    "Schedule": {
        "ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
        "Status": "DISABLED",
        "StatusUpdateTime": 1697736000,
        "DisabledBy": "USER",
        "DisabledReason": "Manually disabled by user."
    },
    ...
}
```