salt.states.at#

Configuration disposable regularly scheduled tasks for at.#

The at state can be add disposable regularly scheduled tasks for your system.

salt.states.at.absent(name, jobid=None, **kwargs)#

Changed in version 2017.7.0.

Remove a job from queue

jobid: string|int: Specific jobid to remove
tagstring: Job's tag
runasstring: Runs user-specified jobs
kwargs: Addition kwargs can be provided to filter jobs. See output of at.jobcheck for more.

example1:
  at.absent:

Warning

this will remove all jobs!

example2:
  at.absent:
    - year: 13

example3:
  at.absent:
    - tag: rose

example4:
  at.absent:
    - tag: rose
    - day: 13
    - hour: 16

example5:
  at.absent:
    - jobid: 4

salt.states.at.mod_watch(name, **kwargs)#

The at watcher, called to invoke the watch command.

Note

This state exists to support special handling of the watch requisite. It should not be called directly.

Parameters for this function should be set by the state being triggered.

name: The name of the atjob

salt.states.at.present(name, timespec, tag=None, user=None, job=None, unique_tag=False)#

Changed in version 2017.7.0.

Add a job to queue.

jobstring: Command to run.
timespecstring: The 'timespec' follows the format documented in the at(1) manpage.
tagstring: Make a tag for the job.
userstring: The user to run the at job .. versionadded:: 2014.1.4
unique_tagboolean: If set to True job will not be added if a job with the tag exists. .. versionadded:: 2017.7.0

rose:
  at.present:
    - job: 'echo "I love saltstack" > love'
    - timespec: '9:09 11/09/13'
    - tag: love
    - user: jam

salt.states.at.watch(name, timespec, tag=None, user=None, job=None, unique_tag=False)#

New in version 2017.7.0.

Add an at job if trigger by watch

jobstring: Command to run.
timespecstring: The 'timespec' follows the format documented in the at(1) manpage.
tagstring: Make a tag for the job.
userstring: The user to run the at job .. versionadded:: 2014.1.4
unique_tagboolean: If set to True job will not be added if a job with the tag exists. .. versionadded:: 2017.7.0

minion_restart:
  at.watch:
    - job: 'salt-call --local service.restart salt-minion'
    - timespec: 'now +1 min'
    - tag: minion_restart
    - unique_tag: trye
    - watch:
        - file: /etc/salt/minion

Table of Contents

salt.states.at#

Configuration disposable regularly scheduled tasks for at.#