> **Experimental**
>
> `@aws-cdk/aws-imagebuilder-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# ImagePipelineSchedule

The schedule settings for the image pipeline, which defines when a pipeline should be triggered.

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/image-pipeline.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0-alpha.0/packages/@aws-cdk/aws-imagebuilder-alpha/lib/image-pipeline.ts#L295)

## Example

```ts
const dailyPipeline = new imagebuilder.ImagePipeline(this, 'DailyPipeline', {
  recipe: exampleContainerRecipe,
  schedule: {
    expression: events.Schedule.rate(Duration.days(1))
  }
});
```

## Properties

- `autoDisableFailureCount`: number — The number of consecutive failures allowed before the pipeline is automatically disabled.

  **Default:** no auto-disable policy is configured and the pipeline is not automatically disabled on consecutive failures

  This value must be
  between 1 and 10.

- `expression`: [Schedule](/cdk/api/v2/docs/aws-cdk-lib.aws_events.Schedule.html) (required) — The schedule expression to use.

  This can either be a cron expression or a rate expression.

- `startCondition`: [ScheduleStartCondition](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.ScheduleStartCondition.html) — The start condition for the pipeline, indicating the condition under which a pipeline should be triggered.

  **Default:** ScheduleStartCondition.EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE