aws-cdk-lib.aws_imagebuilder.CfnImagePipeline.ScheduleProperty

interface ScheduleProperty

LanguageType name
.NETAmazon.CDK.AWS.ImageBuilder.CfnImagePipeline.ScheduleProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsimagebuilder#CfnImagePipeline_ScheduleProperty
Javasoftware.amazon.awscdk.services.imagebuilder.CfnImagePipeline.ScheduleProperty
Pythonaws_cdk.aws_imagebuilder.CfnImagePipeline.ScheduleProperty
TypeScript aws-cdk-lib » aws_imagebuilder » CfnImagePipeline » ScheduleProperty

A schedule configures how often and when a pipeline will automatically create a new image.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_imagebuilder as imagebuilder } from 'aws-cdk-lib';
const scheduleProperty: imagebuilder.CfnImagePipeline.ScheduleProperty = {
  pipelineExecutionStartCondition: 'pipelineExecutionStartCondition',
  scheduleExpression: 'scheduleExpression',
};

Properties

NameTypeDescription
pipelineExecutionStartCondition?stringThe condition configures when the pipeline should trigger a new image build.
scheduleExpression?stringThe cron expression determines how often EC2 Image Builder evaluates your pipelineExecutionStartCondition .

pipelineExecutionStartCondition?

Type: string (optional)

The condition configures when the pipeline should trigger a new image build.

When the pipelineExecutionStartCondition is set to EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE , and you use semantic version filters on the base image or components in your image recipe, Image Builder will build a new image only when there are new versions of the image or components in your recipe that match the semantic version filter. When it is set to EXPRESSION_MATCH_ONLY , it will build a new image every time the CRON expression matches the current time. For semantic version syntax, see CreateComponent in the Image Builder API Reference .


scheduleExpression?

Type: string (optional)

The cron expression determines how often EC2 Image Builder evaluates your pipelineExecutionStartCondition .

For information on how to format a cron expression in Image Builder, see Use cron expressions in EC2 Image Builder .