Compartir a través de

ScheduleRecurrence Clase

  • Referencia

Define la frecuencia, el intervalo y la hora de inicio de un elemento Schedule de canalización.

ScheduleRecurrence también permite especificar la zona horaria y las horas, minutos o días de la semana para la periodicidad.

Inicialice una periodicidad de programación.

También permite especificar la zona horaria y las horas o minutos o días de semana para la periodicidad.

Herencia
builtins.object
ScheduleRecurrence

Constructor

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

Parámetros

frequency
str
Requerido

La unidad de tiempo que describe la frecuencia con que se activa la programación. Puede ser "Minuto", "Hora", "Día", "Semana" o "Mes".

interval
int
Requerido

Un valor que especifica con qué frecuencia se activa la programación según la frecuencia, que es el número de unidades de tiempo que debe esperar hasta que la programación se activa de nuevo.

start_time
datetime o str
valor predeterminado: None

Objeto datetime que describe la fecha y hora de inicio. El tzinfo del objeto datetime no debe ser ninguno; use la propiedad time_zone para especificar una zona horaria si es necesario. También puede especificar este parámetro como una cadena en este formato: YYYY-MM-DDThh:mm:ss. Si se proporciona None, la primera carga de trabajo se ejecuta de forma instantánea y las cargas de trabajo futuras se ejecutan en función de la programación. Si la hora de inicio pertenece al pasado, la primera carga de trabajo se ejecuta en el siguiente tiempo de ejecución calculado.

Si start_time coincide con week_days y time_of_day (o hours y minutes), la primera carga de trabajo no se ejecuta en start_time, sino que se ejecuta en el siguiente tiempo de ejecución calculado.

time_zone
TimeZone
valor predeterminado: None

Especifique la zona horaria de start_time. Si se proporciona None, se usa la hora UTC.

hours
list[int]
valor predeterminado: None

Si especifica "Día" o "Semana" para la frecuencia, puede especificar uno o varios enteros de 0 a 23, separados por comas, como las horas del día en las que desea ejecutar el flujo de trabajo. Por ejemplo, si especifica "10", "12" y "14", obtendrá 10 a. m., 12 p. m. y 2 p. m. como las marcas de hora. Nota: Solo se pueden usar time_of_day o hours y minutes.

minutes
list[int]
valor predeterminado: None

Si especifica "Día" o "Semana" para la frecuencia, puede especificar uno o varios enteros de 0 a 59, separados por comas, como los minutos de la hora en los que desea ejecutar el flujo de trabajo. Por ejemplo, puede especificar "30" como la marca de minuto y, utilizando el ejemplo anterior para las horas del día, obtendrá 10:30 a. m., 12:30 p. m. y las 2:30 p. m. Nota: Solo se pueden usar time_of_day o hours y minutes.

week_days
list[str]
valor predeterminado: None

Si especifica "Semana" para la frecuencia, puede especificar uno o varios días, separados por comas, cuando desee ejecutar el flujo de trabajo: "Lunes", "Martes", "Miércoles", "Jueves", "Viernes", "Sábado" y "Domingo".

time_of_day
str
valor predeterminado: None

Si especifica "Día" o "Semana" para la frecuencia, puede especificar una hora del día para que la programación se ejecute como una cadena con el formato hh:mm. Por ejemplo, si especifica "15:30", la programación se ejecutará a las 15:30. Nota: Se pueden usar only time_of_day o hours y minutes.

frequency
str
Requerido

La unidad de tiempo que describe la frecuencia con que se activa la programación. Puede ser "Minuto", "Hora", "Día", "Semana" o "Mes".

interval
int
Requerido

Un valor que especifica con qué frecuencia se activa la programación según la frecuencia, que es el número de unidades de tiempo que debe esperar hasta que la programación se activa de nuevo.

start_time
datetime o str
Requerido

Objeto datetime que describe la fecha y hora de inicio. El tzinfo del objeto datetime no debe ser ninguno, use time_zone propiedad para especificar una zona horaria si es necesario. También puede ser una cadena en este formato: AAAA-MM-DDThh:mm:ss. Si se proporciona Ninguno, la primera carga de trabajo se ejecuta al instante y las futuras cargas de trabajo se ejecutan según la programación. Si la hora de inicio pertenece al pasado, la primera carga de trabajo se ejecuta en el siguiente tiempo de ejecución calculado.

Si start_time coincide con week_days y time_of_day (o hours y minutes), la primera carga de trabajo no se ejecuta en start_time, sino que se ejecuta en el siguiente tiempo de ejecución calculado.

time_zone
TimeZone
Requerido

Especifique la zona horaria del start_time. Si se proporciona None, se usa la hora UTC.

hours
list[int]
Requerido

Si especifica "Día" o "Semana" para la frecuencia, puede especificar uno o varios enteros de 0 a 23, separados por comas, como las horas del día en las que desea ejecutar el flujo de trabajo. Por ejemplo, si especifica "10", "12" y "14", obtendrá 10 a. m., 12 p. m. y 2 p. m. como las marcas de hora. Nota: solo se pueden usar time_of_day o horas y minutos.

minutes
list[int]
Requerido

Si especifica "Día" o "Semana" para la frecuencia, puede especificar uno o varios enteros de 0 a 59, separados por comas, como los minutos de la hora en los que desea ejecutar el flujo de trabajo. Por ejemplo, puede especificar "30" como la marca de minuto y, utilizando el ejemplo anterior para las horas del día, obtendrá 10:30 a. m., 12:30 p. m. y las 2:30 p. m. Nota: solo se pueden usar time_of_day o horas y minutos.

week_days
list[str]
Requerido

Si especifica "Semana" para la frecuencia, puede especificar uno o varios días, separados por comas, cuando desee ejecutar el flujo de trabajo: "Lunes", "Martes", "Miércoles", "Jueves", "Viernes", "Sábado" y "Domingo".

time_of_day
str
Requerido

Si especifica "Día" o "Semana" para la frecuencia, puede especificar una hora del día para que la programación se ejecute como una cadena con el formato hh:mm. Por ejemplo, si especifica "15:30", la programación se ejecutará a las 15:30. Nota: solo se pueden usar time_of_day o horas y minutos.

Comentarios

ScheduleRecurrence se usa al crear una programación para una canalización como se muestra a continuación:


   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 continuación se muestran algunos ejemplos 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 la periodicidad de la programación.

validate

Valide la periodicidad de la programación.

validate()