Agendamento de quando a tarefa do AWS DataSync será executada - AWS DataSync
Como funciona o agendamento de tarefa do DataSyncCriação de um agendamento de tarefa do DataSyncPausa de um agendamento de tarefa do DataSyncVerificação do status do agendamento de uma tarefa do DataSync

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

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

Como funciona o agendamento de tarefa do DataSync

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 Amazon EventBridge User Guide.

Criação de um agendamento de tarefa do DataSync

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

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

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

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

    Para obter mais informações, consulte . Para onde posso transferir meus dados com AWS DataSync?

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

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 *)"
  }'

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

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

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

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

Pausa de um agendamento de tarefa do DataSync

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:

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

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

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

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

  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"
  }'

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

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

  4. Execute o comando update-task.

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

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

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

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

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

  1. Copie o seguinte comando describe-task:

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

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

  3. 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 problemas do DataSync da AWS.

{
    "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."
    },
    ...
}