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

The start condition for the pipeline, indicating the condition under which a pipeline should be triggered.

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

## Example

TypeScript:

```ts
const advancedSchedulePipeline = new imagebuilder.ImagePipeline(this, 'AdvancedSchedulePipeline', {
  recipe: exampleImageRecipe,
  schedule: {
    expression: events.Schedule.rate(Duration.days(7)),
    // Only trigger when dependencies are updated (new base images, components, etc.)
    startCondition: imagebuilder.ScheduleStartCondition.EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE,
    // Automatically disable after 3 consecutive failures
    autoDisableFailureCount: 3
  },
  // Start enabled
  status: imagebuilder.ImagePipelineStatus.ENABLED
});
```

Python:

```python
advanced_schedule_pipeline = imagebuilder.ImagePipeline(self, "AdvancedSchedulePipeline",
    recipe=example_image_recipe,
    schedule=imagebuilder.ImagePipelineSchedule(
        expression=events.Schedule.rate(Duration.days(7)),
        # Only trigger when dependencies are updated (new base images, components, etc.)
        start_condition=imagebuilder.ScheduleStartCondition.EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE,
        # Automatically disable after 3 consecutive failures
        auto_disable_failure_count=3
    ),
    # Start enabled
    status=imagebuilder.ImagePipelineStatus.ENABLED
)
```

Java:

```java
ImagePipeline advancedSchedulePipeline = ImagePipeline.Builder.create(this, "AdvancedSchedulePipeline")
        .recipe(exampleImageRecipe)
        .schedule(ImagePipelineSchedule.builder()
                .expression(Schedule.rate(Duration.days(7)))
                // Only trigger when dependencies are updated (new base images, components, etc.)
                .startCondition(ScheduleStartCondition.EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE)
                // Automatically disable after 3 consecutive failures
                .autoDisableFailureCount(3)
                .build())
        // Start enabled
        .status(ImagePipelineStatus.ENABLED)
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.ImageBuilder.Alpha
var advancedSchedulePipeline = new ImagePipeline(this, "AdvancedSchedulePipeline", new ImagePipelineProps {
    Recipe = exampleImageRecipe,
    Schedule = new ImagePipelineSchedule {
        Expression = Schedule.Rate(Duration.Days(7)),
        // Only trigger when dependencies are updated (new base images, components, etc.)
        StartCondition = ScheduleStartCondition.EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE,
        // Automatically disable after 3 consecutive failures
        AutoDisableFailureCount = 3
    },
    // Start enabled
    Status = ImagePipelineStatus.ENABLED
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awsimagebuilderalpha/v2
advancedSchedulePipeline := imagebuilder.NewImagePipeline(this, jsii.String("AdvancedSchedulePipeline"), &ImagePipelineProps{
	Recipe: exampleImageRecipe,
	Schedule: &ImagePipelineSchedule{
		Expression: events.Schedule_Rate(awscdk.Duration_Days(jsii.Number(7))),
		// Only trigger when dependencies are updated (new base images, components, etc.)
		StartCondition: imagebuilder.ScheduleStartCondition_EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE,
		// Automatically disable after 3 consecutive failures
		AutoDisableFailureCount: jsii.Number(3),
	},
	// Start enabled
	Status: imagebuilder.ImagePipelineStatus_ENABLED,
})
```

## Members

| Member | Description |
| --- | --- |
| `EXPRESSION_MATCH_ONLY` | Indicates to trigger a pipeline whenever its schedule is met. |
| `EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE` | Indicates to trigger a pipeline whenever its schedule is met, and there are matching dependency updates available, such as new versions of components or images to use in the pipeline build. |

## Referenced by

- [`ImagePipelineSchedule`](/v2/docs/@aws-cdk_aws-imagebuilder-alpha.ImagePipelineSchedule).startCondition
