Amazon EC2 Image Builder · JSON Structure

Ec2 Image Builder Schedule Structure

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

Type: object Properties: 3
Amazon Web ServicesAutomationContainer ImagesEC2Image BuildingVirtual Machine Images

Schedule is a JSON Structure definition published by Amazon EC2 Image Builder, describing 3 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

scheduleExpression timezone pipelineExecutionStartCondition

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$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": "<p>The cron expression determines how often EC2 Image Builder evaluates your <code>pipelineExecutionStartCondition</code>.</p> <p>For information on how to format a cron expression in Image Builder, see <a href=\"https://docs.aws.amazon.com/imagebuilder/latest/userguide/image-builder-cron.html\">Use cron expressions in EC2 Image Builder</a>.</p>"
        }
      ]
    },
    "timezone": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Timezone"
        },
        {
          "description": "The timezone that applies to the scheduling expression. For example, \"Etc/UTC\", \"America/Los_Angeles\" in the <a href=\"https://www.joda.org/joda-time/timezones.html\">IANA timezone format</a>. 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 <code>pipelineExecutionStartCondition</code> is set to <code>EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE</code>, 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 <code>EXPRESSION_MATCH_ONLY</code>, it will build a new image every time the CRON expression matches the current time. For semantic version syntax, see <a href=\"https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateComponent.html\">CreateComponent</a> in the <i> EC2 Image Builder API Reference</i>."
        }
      ]
    }
  }
}