Partilhar via


ScheduleRecurrence Classe

Define a frequência, o intervalo e a hora de início de um pipeline Schedule.

ScheduleRecurrence também permite especificar o fuso horário e as horas ou minutos ou dias da semana para a recorrência.

Inicializar uma recorrência de agendamento.

Ele também permite especificar o fuso horário e as horas ou minutos ou dias da semana para a recorrência.

Construtor

ScheduleRecurrence(frequency, interval, start_time=None, time_zone=None, hours=None, minutes=None, week_days=None, time_of_day=None)

Parâmetros

Name Description
frequency
Necessário
str

A unidade de tempo que descreve a frequência com que o cronograma é acionado. Pode ser "Minuto", "Hora", "Dia", "Semana" ou "Mês".

interval
Necessário
int

Um valor que especifica a frequência com que a agenda é acionada com base na frequência, que é o número de unidades de tempo a aguardar até que a agenda seja acionada novamente.

start_time

Um objeto datetime que descreve a data e hora de início. O tzinfo do objeto datetime deve ser none, use time_zone a propriedade para especificar um fuso horário, se necessário. Você também pode especificar esse parâmetro como uma cadeia de caracteres neste formato: AAAA-MM-DDThh:mm:ss. Se Nenhum for fornecido, a primeira carga de trabalho será executada instantaneamente e as cargas de trabalho futuras serão executadas com base na agenda. Se a hora de início estiver no passado, a primeira carga de trabalho será executada no próximo tempo de execução calculado.

Se start_time corresponder week_days e time_of_day (ou hours e minutes), a primeira carga de trabalho não será executada na start_time, mas sim executada no próximo tempo de execução calculado.

Default value: None
time_zone

Especifique o fuso start_timehorário do . Se Nenhum for fornecido, o UTC será usado.

Default value: None
hours

Se você especificar "Dia" ou "Semana" para frequência, poderá especificar um ou mais inteiros de 0 a 23, separados por vírgulas, como as horas do dia em que deseja executar o fluxo de trabalho. Por exemplo, se você especificar "10", "12" e "14", obterá 10h, 12h e 14h como marcas de hora. Nota: apenas time_of_day ou hours e minutes pode ser usado.

Default value: None
minutes

Se você especificar "Dia" ou "Semana" para frequência, poderá especificar um ou mais inteiros de 0 a 59, separados por vírgulas, como os minutos da hora em que deseja executar o fluxo de trabalho. Por exemplo, você pode especificar "30" como a marca de minuto e, usando o exemplo anterior para horas do dia, você obtém 10h30, 12h30 e 14h30. Nota: apenas time_of_day ou hours e minutes pode ser usado.

Default value: None
week_days

Se você especificar "Semana" para frequência, poderá especificar um ou mais dias, separados por vírgulas, quando quiser executar o fluxo de trabalho: "Segunda-feira", "Terça-feira", "Quarta-feira", "Quinta-feira", "Sexta-feira", "Sábado" e "Domingo".

Default value: None
time_of_day
str

Se você especificar "Dia" ou "Semana" para frequência, poderá especificar uma hora do dia para que a agenda seja executada como uma cadeia de caracteres no formato hh:mm. Por exemplo, se você especificar "15:30", o horário será executado às 15h30. Nota: only time_of_day ou hours e minutes pode ser usado.

Default value: None
frequency
Necessário
str

A unidade de tempo que descreve a frequência com que o cronograma é acionado. Pode ser "Minuto", "Hora", "Dia", "Semana" ou "Mês".

interval
Necessário
int

Um valor que especifica a frequência com que a agenda é acionada com base na frequência, que é o número de unidades de tempo a aguardar até que a agenda seja acionada novamente.

start_time
Necessário

Um objeto datetime que descreve a data e hora de início. O tzinfo do objeto datetime deve ser none, use time_zone propriedade para especificar um fuso horário, se necessário. Também pode ser uma cadeia de caracteres neste formato: AAAA-MM-DDThh:mm:ss. Se Nenhum for fornecido, a primeira carga de trabalho será executada instantaneamente e as cargas de trabalho futuras serão executadas com base na programação. Se a hora de início estiver no passado, a primeira carga de trabalho será executada no próximo tempo de execução calculado.

Se start_time corresponder week_days e time_of_day (ou hours e minutes), a primeira carga de trabalho não será executada na start_time, mas sim executada no próximo tempo de execução calculado.

time_zone
Necessário

Especifique o fuso horário do start_time. Se Nenhum for fornecido, o UTC será usado.

hours
Necessário

Se você especificar "Dia" ou "Semana" para frequência, poderá especificar um ou mais inteiros de 0 a 23, separados por vírgulas, como as horas do dia em que deseja executar o fluxo de trabalho. Por exemplo, se você especificar "10", "12" e "14", obterá 10h, 12h e 14h como marcas de hora. Nota: só podem ser utilizados time_of_day ou horas e minutos.

minutes
Necessário

Se você especificar "Dia" ou "Semana" para frequência, poderá especificar um ou mais inteiros de 0 a 59, separados por vírgulas, como os minutos da hora em que deseja executar o fluxo de trabalho. Por exemplo, você pode especificar "30" como a marca de minuto e, usando o exemplo anterior para horas do dia, você obtém 10h30, 12h30 e 14h30. Nota: só podem ser utilizados time_of_day ou horas e minutos.

week_days
Necessário

Se você especificar "Semana" para frequência, poderá especificar um ou mais dias, separados por vírgulas, quando quiser executar o fluxo de trabalho: "Segunda-feira", "Terça-feira", "Quarta-feira", "Quinta-feira", "Sexta-feira", "Sábado" e "Domingo"

time_of_day
Necessário
str

Se você especificar "Dia" ou "Semana" para frequência, poderá especificar uma hora do dia para que a agenda seja executada como uma cadeia de caracteres no formato hh:mm. Por exemplo, se você especificar "15:30", o horário será executado às 15h30. Nota: só podem ser utilizados time_of_day ou horas e minutos.

Observações

Um ScheduleRecurrence é usado ao criar um Schedule para um Pipeline da seguinte maneira:


   from azureml.pipeline.core import Schedule, ScheduleRecurrence

   recurrence = ScheduleRecurrence(frequency="Hour", interval=12)
   schedule = Schedule.create(workspace, name="TestSchedule", pipeline_id=pipeline.id,
                              experiment_name="experiment_name", recurrence=recurrence)

A seguir estão alguns exemplos de ScheduleRecurrences válidos:


   from azureml.pipeline.core import ScheduleRecurrence

   # Submit the Pipeline every 15 minutes
   recurrence = ScheduleRecurrence(frequency="Minute", interval=15)
   # Submit the Pipeline every 2 weeks on Monday and Wednesday at 6:30pm UTC
   recurrence = ScheduleRecurrence(frequency="Week", interval=2, week_days=["Monday", "Wednesday"],
                                   time_of_day="18:30")
   # Submit the Pipeline on the first day of every month starting November 1, 2019 at 9AM
   recurrence = ScheduleRecurrence(frequency="Month", interval=1, start_time="2019-11-01T09:00:00")
   # Submit the Pipeline every hour on the 55th minute starting on January 13th, 2020 at 12:55pm
   # if the specified start time is in the past, the first workload is run at the next future 55th minute
   # of the hour.
   recurrence = ScheduleRecurrence(frequency="Hour", interval=1, start_time="2020-01-13T12:55:00")

Métodos

validate

Valide a recorrência do agendamento.

validate

Valide a recorrência do agendamento.

validate()