{ "$schema": "https://json-structure.org/meta/core/v0/#", "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-ec2-image-builder/refs/heads/main/json-structure/ec2-image-builder-schedule-structure.json", "name": "Schedule", "description": "A schedule configures how often and when a pipeline will automatically create a new image.", "type": "object", "properties": { "scheduleExpression": { "allOf": [ { "$ref": "#/components/schemas/NonEmptyString" }, { "description": "

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.

" } ] }, "timezone": { "allOf": [ { "$ref": "#/components/schemas/Timezone" }, { "description": "The timezone that applies to the scheduling expression. For example, \"Etc/UTC\", \"America/Los_Angeles\" in the IANA timezone format. If not specified this defaults to UTC." } ] }, "pipelineExecutionStartCondition": { "allOf": [ { "$ref": "#/components/schemas/PipelineExecutionStartCondition" }, { "description": "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, EC2 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 EC2 Image Builder API Reference." } ] } } }