schedule_asset_execution
Automate recurring compliance assessments by scheduling asset execution with custom cron expressions, control periods, and duration settings.
Instructions
Schedule automated execution for a asset.
IMPORTANT WORKFLOW & SAFETY RULES:
User inputs (runPrefixName, cronTab) are mandatory and cannot be bypassed or assumed.
The
cronTabstring MUST be constructed explicitly from the user's schedule instructions (e.g., frequency, time-of-day, timezone). Never auto-generate it without user confirmation.controlPeriodMUST be one of the supported values.controlDurationMUST be a positive integer provided by the user. Args:assetId (str): Id of the asset to be scheduled.
runPrefixName (str): Human-readable name/prefix for this scheduled run.
description (str): Description for the scheduled run.
cronTab (str): Full cron expression including timezone (e.g.
TZ=Asia/Calcutta 0 0 * * *), explicitly provided/confirmed by the user. Must not be assumed or defaulted.controlPeriod (str): Control period for the assessment run, type selected by the user. Allowed values: - DAY → Last few days - WEEK → Last few weeks - MONTH → Last few months - CAL_WEEK → Last few calendar weeks - CAL_MONTH → Last few calendar months
controlDuration (int): Duration count for the selected control period Returns:
success (bool): Indicates if the schedule was created successfully.
scheduleId (str): ID of the created schedule (only present if successful).
error (Optional[str]): An error message if any issues occurred during creation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assetId | Yes | ||
| runPrefixName | Yes | ||
| description | Yes | ||
| cronTab | Yes | ||
| controlPeriod | Yes | ||
| controlDuration | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||