Freigeben über


ScheduleRecurrence Klasse

Definiert die Häufigkeit, das Intervall und die Startzeit eines Pipeline-Schedule.

Mit ScheduleRecurrence können Sie auch die Zeitzone und die Stunden, Minuten oder Wochentage für die Serie angeben.

Initialisieren sie eine Zeitplanserie.

Es ermöglicht auch, die Zeitzone und die Stunden, Minuten oder Wochentage für die Wiederholung anzugeben.

Vererbung
builtins.object
ScheduleRecurrence

Konstruktor

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

Parameter

Name Beschreibung
frequency
Erforderlich
str

Die Zeiteinheit für die Häufigkeit der Zeitplanauslösung: Kann „Minute“, „Stunde“, „Tag“, „Woche“ oder „Monat“ sein.

interval
Erforderlich
int

Wert, mit dem angegeben wird, wie oft der Zeitplan basierend auf der Häufigkeit ausgelöst wird (Anzahl von Zeiteinheiten der Wartezeit, bis der Zeitplan erneut ausgelöst wird)

start_time
datetime oder str

Ein datetime-Objekt, das das Startdatum und die Startzeit beschreibt. Die tzinfo des datetime-Objekts sollte „None“ sein. Verwenden Sie die time_zone-Eigenschaft, um bei Bedarf eine Zeitzone anzugeben. Sie können diesen Parameter auch als Zeichenfolge in diesem Format angeben: JJJJ-MM-TTThh:mm:ss. Bei „None“ wird der erste Workload sofort ausgeführt, und die zukünftigen Workloads werden basierend auf dem Zeitplan ausgeführt. Wenn die Startzeit in der Vergangenheit liegt, wird die erste Workload zur nächsten berechneten Laufzeit ausgeführt.

Wenn start_time mit week_days und time_of_day (oder hours und minutes) übereinstimmt, wird der erste Workload nicht bei der start_time ausgeführt, sondern zur nächsten berechneten Ausführungszeit.

Standardwert: None
time_zone

Geben Sie die Zeitzone der start_time an. Bei „None“ wird UTC verwendet.

Standardwert: None
hours

Wenn Sie für „frequency“ die Option „Day“ oder „Week“ angeben, können Sie eine ganze Zahl oder eine kommagetrennte Liste mit ganzen Zahlen von 0 bis 23 als die Stunden des Tages angeben, zu denen der Workflow ausgeführt werden soll. Wenn Sie also etwa „10“, „12“ und „14“ angeben, erhalten Sie die vollen Stunden „10 Uhr“, „12 Uhr“ und „14 Uhr“. Es können nur time_of_day oder hours und minutes verwendet werden.

Standardwert: None
minutes

Wenn Sie für „frequency“ die Option „Day“ oder „Week“ angeben, können Sie eine ganze Zahl oder eine kommagetrennte Liste mit ganzen Zahlen von 0 bis 59 als die Minuten der Stunde angeben, zu denen der Workflow ausgeführt werden soll. Wenn Sie also beispielsweise „30“ als Minutenwert angeben und das vorherige Beispiel für Stunden des Tages verwenden, erhalten Sie „10:30 Uhr“, „12:30 Uhr“ und „14:30 Uhr“. Es können nur time_of_day oder hours und minutes verwendet werden.

Standardwert: None
week_days

Wenn Sie für „frequency“ die Option „Week“ angeben, können Sie einen Tag oder eine kommagetrennte Liste mit Tagen für die Workflowausführung angeben: „Monday“, „Tuesday“, „Wednesday“, „Thursday“, „Friday“, „Saturday“ oder „Sunday“

Standardwert: None
time_of_day
str

Wenn Sie für „frequency“ die Option „Day“ oder „Week“ angeben, können Sie eine Tageszeit als Zeichenfolge im Format hh:mm für den Zeitplan angeben, an dem er ausgeführt werden soll. Wenn Sie beispielsweise „15:30“ angeben, wird der Zeitplan um 15:30 Uhr ausgeführt. Hinweis: only time_of_day oder hours und minutes können verwendet werden.

Standardwert: None
frequency
Erforderlich
str

Die Zeiteinheit für die Häufigkeit der Zeitplanauslösung: Kann „Minute“, „Stunde“, „Tag“, „Woche“ oder „Monat“ sein.

interval
Erforderlich
int

Wert, mit dem angegeben wird, wie oft der Zeitplan basierend auf der Häufigkeit ausgelöst wird (Anzahl von Zeiteinheiten der Wartezeit, bis der Zeitplan erneut ausgelöst wird)

start_time
Erforderlich
datetime oder str

Ein datetime-Objekt, das das Startdatum und die Startzeit beschreibt. Das tzinfo des datetime-Objekts sollte keine sein. Verwenden Sie time_zone -Eigenschaft, um bei Bedarf eine Zeitzone anzugeben. Kann auch eine Zeichenfolge im folgenden Format sein: JJJJ-MM-TTThh:mm:ss. Wenn Keine angegeben wird, wird die erste Workload sofort ausgeführt, und die zukünftigen Workloads werden basierend auf dem Zeitplan ausgeführt. Wenn die Startzeit in der Vergangenheit liegt, wird die erste Workload zur nächsten berechneten Laufzeit ausgeführt.

Wenn start_time mit week_days und time_of_day (oder hours und minutes) übereinstimmt, wird der erste Workload nicht bei der start_time ausgeführt, sondern zur nächsten berechneten Ausführungszeit.

time_zone
Erforderlich

Geben Sie die Zeitzone des start_time an. Bei „None“ wird UTC verwendet.

hours
Erforderlich

Wenn Sie für „frequency“ die Option „Day“ oder „Week“ angeben, können Sie eine ganze Zahl oder eine kommagetrennte Liste mit ganzen Zahlen von 0 bis 23 als die Stunden des Tages angeben, zu denen der Workflow ausgeführt werden soll. Wenn Sie also etwa „10“, „12“ und „14“ angeben, erhalten Sie die vollen Stunden „10 Uhr“, „12 Uhr“ und „14 Uhr“. Hinweis: Es können nur time_of_day oder Stunden und Minuten verwendet werden.

minutes
Erforderlich

Wenn Sie für „frequency“ die Option „Day“ oder „Week“ angeben, können Sie eine ganze Zahl oder eine kommagetrennte Liste mit ganzen Zahlen von 0 bis 59 als die Minuten der Stunde angeben, zu denen der Workflow ausgeführt werden soll. Wenn Sie also beispielsweise „30“ als Minutenwert angeben und das vorherige Beispiel für Stunden des Tages verwenden, erhalten Sie „10:30 Uhr“, „12:30 Uhr“ und „14:30 Uhr“. Hinweis: Es können nur time_of_day oder Stunden und Minuten verwendet werden.

week_days
Erforderlich

Wenn Sie "Week" für die Häufigkeit angeben, können Sie einen oder mehrere Tage, getrennt durch Kommas, angeben, wenn Sie den Workflow ausführen möchten: "Montag", "Dienstag", "Mittwoch", "Donnerstag", "Freitag", "Samstag" und "Sonntag".

time_of_day
Erforderlich
str

Wenn Sie für „frequency“ die Option „Day“ oder „Week“ angeben, können Sie eine Tageszeit als Zeichenfolge im Format hh:mm für den Zeitplan angeben, an dem er ausgeführt werden soll. Wenn Sie beispielsweise „15:30“ angeben, wird der Zeitplan um 15:30 Uhr ausgeführt. Hinweis: Es können nur time_of_day oder Stunden und Minuten verwendet werden.

Hinweise

Beim Erstellen eines Zeitplans für eine Pipeline wird ScheduleRecurrence wie folgt verwendet:


   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)

Im Folgenden sind einige Beispiele für gültige ScheduleRecurrences aufgeführt:


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

Methoden

validate

Die Zeitplanserie validieren.

validate

Die Zeitplanserie validieren.

validate()