Werkwijze Voor: gebruikers

Geplande taken

Een virtuele machine eenmalig of terugkerend in- of uitschakelen in de console, een geplande taak direct uitvoeren, wijzigen en verwijderen.

Een geplande taak schakelt een virtuele machine op een vast tijdstip in of uit, eenmalig of terugkerend. Een terugkerende taak wordt na elke uitvoering opnieuw ingesteld.

In de console

  1. Selecteer op de startpagina Geplante taken. De lijst toont elke taak met haar virtuele machine, haar actie, haar schema, de kolom Volgende run en de kolom Status.

    Geplande taken met hun planning, volgende uitvoering en acties (Groter weergeven)
  2. Selecteer Geplande taak maken. Het dialoogvenster opent. Voer een Naam in, optioneel een Beschrijving, en kies de Virtuele machine.
  3. Kies de Actie: Inschakelen of Uitschakelen.
  4. Kies het Schema en vul in wat het vraagt:
    • Eenmalig: stel Uitvoeren om in. U voert lokale tijd in en Kyvernon slaat die op als UTC.
    • Uurlijks: stel het Interval in uren in en de Minuut.
    • Dagelijks: stel het interval in dagen in, het Uur (UTC) en de minuut. Het uur is UTC.
    • Wekelijks: stel het interval in weken in, de Dagen van de week, het uur en de minuut.
    • Maandelijks op dag: stel het interval in maanden in, het uur, de minuut en de Dag van de maand, van 1 tot 31 of -1 voor de laatste dag van de maand.
    • Maandelijks op weekdag: stel het interval in maanden in, het uur, de minuut, Welke in de maand (eerste tot vierde, of laatste) en de Weekdag.
  5. Stel optioneel Stoppen na in, waarna een terugkerende taak stopt, en Per e-mail melden, een adres dat een bericht krijgt wanneer de taak is uitgevoerd. Schakel Taak is ingeschakeld uit om de taak te bewaren zonder haar uit te voeren.
  6. Selecteer Geplande taak maken.

    Venster Geplande taak maken met virtuele machine, actie en planning (Groter weergeven)

In de lijst is de status In wachtrij, Bezig, Geslaagd, Fout of Uitgeschakeld. Nu uitvoeren voert een taak direct uit, Bewerken wijzigt haar en Verwijderen verwijdert haar na een bevestiging. Een uitvoering die al bezig is, wordt niet gestopt door een verwijdering. De virtuele machine van een taak kan niet veranderen: maak een nieuwe taak voor een andere machine.

Resultaat

De taak verschijnt met het tijdstip van de volgende uitvoering. Na een uitvoering verandert de status in Geslaagd of Fout, en de uitvoering is een taak in het takenvenster. Het meldingsadres wordt gebruikt wanneer SMTP op de controller is ingeschakeld.

Automatisering

Met de CLI

Shell
kyvernon scheduled-tasks create --body-file nightly-off.json
kyvernon scheduled-tasks list --entity <vm-id>
kyvernon scheduled-tasks get <id>
kyvernon scheduled-tasks reconfigure <id> --body-file nightly-off.json
kyvernon scheduled-tasks run <id>
kyvernon scheduled-tasks delete <id>

nightly-off.json schakelt een virtuele machine elke dag om 21:30 UTC uit:

JSON
{
  "name": "nightly-off",
  "entityId": "vm-42",
  "action": "power_off",
  "recurrence": {"kind": "daily", "interval": 1, "hour": 21, "minute": 30}
}

Met de API

POST /v1/scheduled-tasks accepteert de bovenstaande body. PUT /v1/scheduled-tasks/{id} herconfigureert een taak, POST /v1/scheduled-tasks/{id}/run voert haar direct uit en GET /v1/scheduled-tasks toont de taken die de aanroeper mag zien.

  • action is power_on of power_off.
  • recurrence.kind is once, hourly, daily, weekly, monthly_by_day of monthly_by_weekday. Elk type behalve once accepteert interval en minute; daily, weekly en de maandtypen accepteren ook hour. weekly neemt de dagen als vlaggen, monday tot sunday. monthly_by_day accepteert day. monthly_by_weekday accepteert weekday (0 tot 6) en offset, van first tot fourth of last.
  • runAt (RFC 3339) is het tijdstip van een eenmalige taak en is standaard nu.
  • enabled, description, activeTime, expireTime en notification zijn optioneel.

Versie 0.1. Laatst gewijzigd: 2026-11-14