Skip to content

ImagePipeline

Source code in docs_src/capo_imagebuilder/types/image_pipeline.py
class ImagePipeline(TypedDict, closed=True):
    arn: NotRequired["capo_imagebuilder.types.image_builder_arn.ImageBuilderArn"]
    """<p>The Amazon Resource Name (ARN) of the image pipeline.</p>"""
    name: NotRequired["capo_imagebuilder.types.resource_name.ResourceName"]
    """<p>The name of the image pipeline.</p>"""
    description: NotRequired["capo_imagebuilder.types.non_empty_string.NonEmptyString"]
    """<p>The description of the image pipeline.</p>"""
    platform: NotRequired["capo_imagebuilder.types.platform.Platform"]
    """<p>The platform of the image pipeline, inherited from the recipe that the pipeline uses.</p>"""
    enhanced_image_metadata_enabled: NotRequired[
        "capo_imagebuilder.types.nullable_boolean.NullableBoolean"
    ]
    """<p>Specifies whether to collect additional information about the image being created, including the operating system (OS) version and package list. Defaults to <code>true</code>.</p>"""
    image_recipe_arn: NotRequired["capo_imagebuilder.types.arn.Arn"]
    """<p>The Amazon Resource Name (ARN) of the image recipe associated with this image pipeline.</p>"""
    container_recipe_arn: NotRequired["capo_imagebuilder.types.arn.Arn"]
    """<p>The Amazon Resource Name (ARN) of the container recipe that is used for this pipeline.</p>"""
    infrastructure_configuration_arn: NotRequired["capo_imagebuilder.types.arn.Arn"]
    """<p>The Amazon Resource Name (ARN) of the infrastructure configuration associated with this image pipeline.</p>"""
    distribution_configuration_arn: NotRequired["capo_imagebuilder.types.arn.Arn"]
    """<p>The Amazon Resource Name (ARN) of the distribution configuration associated with this image pipeline.</p>"""
    image_tests_configuration: NotRequired[
        "capo_imagebuilder.types.image_tests_configuration.ImageTestsConfiguration"
    ]
    """<p>The image tests configuration of the image pipeline.</p>"""
    schedule: NotRequired["capo_imagebuilder.types.schedule.Schedule"]
    """<p>The schedule of the image pipeline.</p>"""
    status: NotRequired["capo_imagebuilder.types.pipeline_status.PipelineStatus"]
    """<p>The status of the image pipeline. A disabled pipeline doesn't run on its schedule, but you can still start builds manually. Image Builder can also disable a pipeline automatically when consecutive scheduled builds fail.</p>"""
    date_created: NotRequired["capo_imagebuilder.types.date_time.DateTime"]
    """<p>The date on which this image pipeline was created.</p>"""
    date_updated: NotRequired["capo_imagebuilder.types.date_time.DateTime"]
    """<p>The date on which this image pipeline was last updated.</p>"""
    date_last_run: NotRequired["capo_imagebuilder.types.date_time.DateTime"]
    """<p>The date on which this image pipeline was last run.</p>"""
    last_run_status: NotRequired["capo_imagebuilder.types.image_status.ImageStatus"]
    """<p>The status of the last image that this pipeline built, such as <code>BUILDING</code>, <code>TESTING</code>, <code>FAILED</code>, or <code>AVAILABLE</code>.</p>"""
    date_next_run: NotRequired["capo_imagebuilder.types.date_time.DateTime"]
    """<p>The next date when the pipeline is scheduled to run.</p>"""
    tags: NotRequired["capo_imagebuilder.types.tag_map.TagMap"]
    """<p>The tags of this image pipeline.</p>"""
    image_scanning_configuration: NotRequired[
        "capo_imagebuilder.types.image_scanning_configuration.ImageScanningConfiguration"
    ]
    """<p>Contains settings for vulnerability scans that Amazon Inspector runs against the test instance during image creation.</p>"""
    image_tags: NotRequired["capo_imagebuilder.types.tag_map.TagMap"]
    """<p>The tags that Image Builder applies to the Image Builder image resource that this pipeline's scheduled executions create. These tags don't apply to the output AMI. Builds that you start manually use the tags from the <a href="https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_StartImagePipelineExecution.html">StartImagePipelineExecution</a> request instead.</p>"""
    execution_role: NotRequired[
        "capo_imagebuilder.types.role_name_or_arn.RoleNameOrArn"
    ]
    """<p>The name or Amazon Resource Name (ARN) for the IAM role you create that grants Image Builder access to perform workflow actions.</p>"""
    workflows: NotRequired[
        "capo_imagebuilder.types.workflow_configuration_list.WorkflowConfigurationList"
    ]
    """<p>Contains the workflows that run for the image pipeline.</p>"""
    logging_configuration: NotRequired[
        "capo_imagebuilder.types.pipeline_logging_configuration.PipelineLoggingConfiguration"
    ]
    """<p>The CloudWatch Logs configuration for the pipeline: the log group for image build logs and the log group for pipeline execution logs.</p>"""
    consecutive_failures: NotRequired[
        "capo_imagebuilder.types.consecutive_failures.ConsecutiveFailures"
    ]
    """<p>Image Builder tracks the number of consecutive failures for scheduled pipeline executions and takes one of the following actions each time it runs on a schedule:</p> <ul> <li> <p>If the pipeline execution is successful, the number of consecutive failures resets to zero.</p> </li> <li> <p>If the pipeline execution fails, Image Builder increments the number of consecutive failures. If the failure count reaches the limit defined in the <a>AutoDisablePolicy</a>, Image Builder disables the pipeline.</p> </li> </ul> <p>The consecutive failure count is also reset to zero under the following conditions:</p> <ul> <li> <p>The pipeline runs manually and succeeds.</p> </li> <li> <p>The pipeline configuration is updated.</p> </li> </ul> <p>If the pipeline runs manually and fails, the count remains the same. The next scheduled run continues to increment where it left off before.</p>"""

arn instance-attribute

arn: NotRequired[ImageBuilderArn]

The Amazon Resource Name (ARN) of the image pipeline.

consecutive_failures instance-attribute

consecutive_failures: NotRequired[ConsecutiveFailures]

Image Builder tracks the number of consecutive failures for scheduled pipeline executions and takes one of the following actions each time it runs on a schedule:

  • If the pipeline execution is successful, the number of consecutive failures resets to zero.

  • If the pipeline execution fails, Image Builder increments the number of consecutive failures. If the failure count reaches the limit defined in the AutoDisablePolicy, Image Builder disables the pipeline.

The consecutive failure count is also reset to zero under the following conditions:

  • The pipeline runs manually and succeeds.

  • The pipeline configuration is updated.

If the pipeline runs manually and fails, the count remains the same. The next scheduled run continues to increment where it left off before.

container_recipe_arn instance-attribute

container_recipe_arn: NotRequired[Arn]

The Amazon Resource Name (ARN) of the container recipe that is used for this pipeline.

date_created instance-attribute

date_created: NotRequired[DateTime]

The date on which this image pipeline was created.

date_last_run instance-attribute

date_last_run: NotRequired[DateTime]

The date on which this image pipeline was last run.

date_next_run instance-attribute

date_next_run: NotRequired[DateTime]

The next date when the pipeline is scheduled to run.

date_updated instance-attribute

date_updated: NotRequired[DateTime]

The date on which this image pipeline was last updated.

description instance-attribute

description: NotRequired[NonEmptyString]

The description of the image pipeline.

distribution_configuration_arn instance-attribute

distribution_configuration_arn: NotRequired[Arn]

The Amazon Resource Name (ARN) of the distribution configuration associated with this image pipeline.

enhanced_image_metadata_enabled instance-attribute

enhanced_image_metadata_enabled: NotRequired[NullableBoolean]

Specifies whether to collect additional information about the image being created, including the operating system (OS) version and package list. Defaults to true.

execution_role instance-attribute

execution_role: NotRequired[RoleNameOrArn]

The name or Amazon Resource Name (ARN) for the IAM role you create that grants Image Builder access to perform workflow actions.

image_recipe_arn instance-attribute

image_recipe_arn: NotRequired[Arn]

The Amazon Resource Name (ARN) of the image recipe associated with this image pipeline.

image_scanning_configuration instance-attribute

image_scanning_configuration: NotRequired[ImageScanningConfiguration]

Contains settings for vulnerability scans that Amazon Inspector runs against the test instance during image creation.

image_tags instance-attribute

image_tags: NotRequired[TagMap]

The tags that Image Builder applies to the Image Builder image resource that this pipeline's scheduled executions create. These tags don't apply to the output AMI. Builds that you start manually use the tags from the StartImagePipelineExecution request instead.

image_tests_configuration instance-attribute

image_tests_configuration: NotRequired[ImageTestsConfiguration]

The image tests configuration of the image pipeline.

infrastructure_configuration_arn instance-attribute

infrastructure_configuration_arn: NotRequired[Arn]

The Amazon Resource Name (ARN) of the infrastructure configuration associated with this image pipeline.

last_run_status instance-attribute

last_run_status: NotRequired[ImageStatus]

The status of the last image that this pipeline built, such as BUILDING, TESTING, FAILED, or AVAILABLE.

logging_configuration instance-attribute

logging_configuration: NotRequired[PipelineLoggingConfiguration]

The CloudWatch Logs configuration for the pipeline: the log group for image build logs and the log group for pipeline execution logs.

name instance-attribute

name: NotRequired[ResourceName]

The name of the image pipeline.

platform instance-attribute

platform: NotRequired[Platform]

The platform of the image pipeline, inherited from the recipe that the pipeline uses.

schedule instance-attribute

schedule: NotRequired[Schedule]

The schedule of the image pipeline.

status instance-attribute

status: NotRequired[PipelineStatus]

The status of the image pipeline. A disabled pipeline doesn't run on its schedule, but you can still start builds manually. Image Builder can also disable a pipeline automatically when consecutive scheduled builds fail.

tags instance-attribute

tags: NotRequired[TagMap]

The tags of this image pipeline.

workflows instance-attribute

workflows: NotRequired[WorkflowConfigurationList]

Contains the workflows that run for the image pipeline.