Deployments
Schedules

CreateScheduledDriftDeployment

Creates a drift detection schedule for a stack using Pulumi Deployments. Drift detection identifies divergence between the declared infrastructure state in your Pulumi program and the actual state of resources in the cloud provider. The 'scheduleCron' field accepts a cron expression defining when drift detection should run (e.g. '0 */4 * * *' for every 4 hours). When 'autoRemediate' is set to true, a remediation update is automatically triggered to bring resources back into alignment with the declared state whenever drift is detected. Auto-remediation requires a Business Critical subscription. The stack must have deployment settings configured before a drift schedule can be created.

post/api/stacks/{orgName}/{projectName}/{stackName}/deployments/drift/schedules

Request

  • Base URL: https://api.pulumi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pulumi.com/api/stacks/{orgName}/{projectName}/{stackName}/deployments/drift/schedules
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

projectNamestring required

The project name

stackNamestring required

The stack name

Request body

autoRemediateboolean

If true, automatically run a remediation update when drift is detected.

scheduleCronstring

Cron expression defining when drift detection should run (e.g. '0 */4 * * *' for every 4 hours).

Response

OK

createdstring required

The timestamp when this scheduled action was created.

definitionobject required

The action definition, which varies based on the action kind.

idstring required

The unique identifier for this scheduled action.

kind'deployment' | 'environment_rotation' | 'scan' | 'agent_automation' required

The kind of action to be executed.

lastExecutedstring required

The timestamp of the last execution, if any.

modifiedstring required

The timestamp when this scheduled action was last modified.

nextExecutionstring required

The timestamp of the next scheduled execution.

orgIDstring required

The organization ID that owns this scheduled action.

pausedboolean required

Whether the scheduled action is currently paused.

scheduleCronstring

A cron expression defining the recurring schedule.

scheduleOncestring

A timestamp for a one-time scheduled execution.

Changes

No recorded changes to this operation across all 1 revision of this API.