recurring.highstate

Available methods

Description

Provides methods to handle recurring highstates for minions, system groups and organizations.

Namespace:

recurring.highstate

Method: create

HTTP POST

Description:

Create a new recurring highstate action.

Parameters:

  • string sessionKey

  • struct actionProps

    • string "entity_type" - the type of the target entity. One of the following:

      • minion

      • group

      • org

    • int "entity_id" - the ID of the target entity

    • string "name" - the name of the recurring action

    • string "cron_expr" - the execution frequency of the action as a cron expression

    • boolean "test" - whether the action should be executed in test mode (optional)

Returns:

  • int id - the ID of the newly created recurring action

Method: update

HTTP POST

Description:

Update the properties of a recurring highstate action.

Parameters:

  • string sessionKey

  • struct actionProps

    • int "id" - the ID of the action to update

    • string "name" - the name of the action (optional)

    • string "cron_expr" - the execution frequency of the action (optional)

    • boolean "test" - whether the action should be executed in test mode (optional)

    • boolean "active" - whether the action should be active (optional)

Returns:

  • int id - the ID of the updated recurring action