Freigeben über


ScheduleRecurrence Klasse

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

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

Initialisieren sie eine Terminserie.

Außerdem können sie die Zeitzone und die Stunden oder Minuten oder Wochentage für die Serie angeben.

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, die beschreibt, wie oft der Zeitplan ausgelöst wird. Kann "Minute", "Stunde", "Tag", "Woche" oder "Monat" sein.

interval
Erforderlich
int

Ein Wert, der angibt, wie oft der Zeitplan basierend auf der Häufigkeit ausgelöst wird. Dabei handelt es sich um die Anzahl der Zeiteinheiten, die gewartet werden sollen, 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 keine sein, verwenden Sie time_zone die Eigenschaft, um bei Bedarf eine Zeitzone anzugeben. Sie können diesen Parameter auch als Zeichenfolge in diesem Format angeben: JJJJ-MM-DDThh:mm:ss. Wenn Keine angegeben wird, wird die erste Workload sofort ausgeführt, und die zukünftigen Arbeitslasten 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 Übereinstimmungen week_days und time_of_day (oder hours und minutes) übereinstimmen, wird die erste Arbeitslast nicht ausgeführt start_time, sondern stattdessen zur nächsten berechneten Laufzeit ausgeführt.

Standardwert: None
time_zone

Geben Sie die Zeitzone der start_time. Wenn "None" angegeben wird, wird UTC verwendet.

Standardwert: None
hours

Wenn Sie "Tag" oder "Woche" für häufigkeit angeben, können Sie eine oder mehrere ganze Zahlen zwischen 0 und 23 angeben, getrennt durch Kommas, als Stunden des Tages, wenn Sie den Workflow ausführen möchten. Wenn Sie also etwa „10“, „12“ und „14“ angeben, erhalten Sie die vollen Stunden „10 Uhr“, „12 Uhr“ und „14 Uhr“. Hinweis: Nur time_of_day oder hours und minutes kann verwendet werden.

Standardwert: None
minutes

Wenn Sie "Tag" oder "Woche" für die Häufigkeit angeben, können Sie eine oder mehrere ganze Zahlen zwischen 0 und 59 angeben, getrennt durch Kommas, als Minuten der Stunde, wenn Sie den Workflow ausführen möchten. 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: Nur time_of_day oder hours und minutes kann verwendet werden.

Standardwert: None
week_days

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

Standardwert: None
time_of_day
str

Wenn Sie "Tag" oder "Woche" für häufigkeit angeben, können Sie eine Tageszeit für den Zeitplan angeben, der als Zeichenfolge im Format hh:mm ausgeführt werden soll. Wenn Sie beispielsweise "15:30" angeben, wird der Zeitplan um 3:30 Uhr ausgeführt. Hinweis: only time_of_day oder hours und minutes kann verwendet werden.

Standardwert: None
frequency
Erforderlich
str

Die Zeiteinheit, die beschreibt, wie oft der Zeitplan ausgelöst wird. Kann "Minute", "Stunde", "Tag", "Woche" oder "Monat" sein.

interval
Erforderlich
int

Ein Wert, der angibt, wie oft der Zeitplan basierend auf der Häufigkeit ausgelöst wird. Dabei handelt es sich um die Anzahl der Zeiteinheiten, die gewartet werden sollen, bis der Zeitplan erneut ausgelöst wird.

start_time
Erforderlich
datetime oder str

Ein Datetime-Objekt, das das Startdatum und die Startzeit beschreibt. Die tzinfo des datetime-Objekts sollte keine sein, verwenden Sie time_zone Eigenschaft, um bei Bedarf eine Zeitzone anzugeben. Kann auch eine Zeichenfolge in diesem Format sein: JJJJ-MM-DDThh:mm:ss. Wenn "None" bereitgestellt 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 Übereinstimmungen week_days und time_of_day (oder hours und minutes) übereinstimmen, wird die erste Arbeitslast nicht ausgeführt start_time, sondern stattdessen zur nächsten berechneten Laufzeit ausgeführt.

time_zone
Erforderlich

Geben Sie die Zeitzone des start_time an. Wenn "None" angegeben wird, wird UTC verwendet.

hours
Erforderlich

Wenn Sie "Tag" oder "Woche" für häufigkeit angeben, können Sie eine oder mehrere ganze Zahlen zwischen 0 und 23 angeben, getrennt durch Kommas, als Stunden des Tages, wenn Sie den Workflow ausführen möchten. 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 "Tag" oder "Woche" für die Häufigkeit angeben, können Sie eine oder mehrere ganze Zahlen zwischen 0 und 59 angeben, getrennt durch Kommas, als Minuten der Stunde, wenn Sie den Workflow ausführen möchten. 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 "Woche" für 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 "Tag" oder "Woche" für häufigkeit angeben, können Sie eine Tageszeit für den Zeitplan angeben, der als Zeichenfolge im Format hh:mm ausgeführt werden soll. Wenn Sie beispielsweise "15:30" angeben, wird der Zeitplan um 3:30 Uhr ausgeführt. Hinweis: Es können nur time_of_day oder Stunden und Minuten verwendet werden.

Hinweise

Eine ScheduleRecurrence wird beim Erstellen eines Zeitplans für eine Pipeline 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

Überprüfen Sie die Terminserie.

validate

Überprüfen Sie die Terminserie.

validate()