Compartir a través de

ScheduleRecurrence Clase

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

ScheduleRecurrence también permite especificar la zona horaria y las horas o 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 la semana para la periodicidad.

Constructor

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

Parámetros

Nombre Description
frequency
Requerido
str

Unidad de tiempo que describe la frecuencia con la que se desencadena la programación. Puede ser "Minute", "Hour", "Day", "Week" o "Month".
interval
Requerido
int

Valor que especifica la frecuencia con la que se desencadena la programación en función de la frecuencia, que es el número de unidades de tiempo que se esperarán hasta que se active la programación de nuevo.
start_time
datetime o str

Objeto datetime que describe la fecha y hora de inicio. El tzinfo del objeto datetime no debe ser ninguno, use la time_zone propiedad para especificar una zona horaria si es necesario. También puede especificar este parámetro como 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 cargas de trabajo futuras 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 week_days con 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.

Valor predeterminado: None
time_zone
TimeZone

Especifique la zona horaria de start_time. Si se proporciona Ninguno UTC.

Valor predeterminado: None
hours
list[int]

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 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 time_of_day o hours y minutes se pueden usar.

Valor predeterminado: None
minutes
list[int]

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 cuando quiera 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 time_of_day o hours y minutes se pueden usar.

Valor predeterminado: None
week_days
list[str]

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

Valor predeterminado: None
time_of_day
str

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 en el formato hh:mm. Por ejemplo, si especifica "15:30", la programación se ejecutará a las 3:30 p. m. Nota: only time_of_day o hours y minutes se pueden usar.

Valor predeterminado: None
frequency
Requerido
str

Unidad de tiempo que describe la frecuencia con la que se desencadena la programación. Puede ser "Minute", "Hour", "Day", "Week" o "Month".
interval
Requerido
int

Valor que especifica la frecuencia con la que se desencadena la programación en función de la frecuencia, que es el número de unidades de tiempo que se esperarán hasta que se active la programación de nuevo.
start_time
Requerido
datetime o str

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 none se proporciona, 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 week_days con 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
Requerido
TimeZone

Especifique la zona horaria del start_time. Si se proporciona Ninguno UTC.
hours
Requerido
list[int]

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 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
Requerido
list[int]

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 cuando quiera 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
Requerido
list[str]

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
Requerido
str

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 en el formato hh:mm. Por ejemplo, si especifica "15:30", la programación se ejecutará a las 3:30 p. m. Nota: solo se pueden usar time_of_day o horas y minutos.

Comentarios

Se usa ScheduleRecurrence al crear una programación para una canalización de la siguiente manera:


   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()