Skip to content

PipelineDeclaration

Source code in docs_src/capo_codepipeline/types/pipeline_declaration.py
class PipelineDeclaration(TypedDict, closed=True):
    name: "capo_codepipeline.types.pipeline_name.PipelineName"
    """<p>The name of the pipeline.</p>"""
    role_arn: "capo_codepipeline.types.role_arn.RoleArn"
    """<p>The Amazon Resource Name (ARN) for CodePipeline to use to either perform actions with no <code>actionRoleArn</code>, or to use to assume roles for actions with an <code>actionRoleArn</code>.</p>"""
    artifact_store: NotRequired["capo_codepipeline.types.artifact_store.ArtifactStore"]
    """<p>Represents information about the S3 bucket where artifacts are stored for the pipeline.</p> <note> <p>You must include either <code>artifactStore</code> or <code>artifactStores</code> in your pipeline, but you cannot use both. If you create a cross-region action in your pipeline, you must use <code>artifactStores</code>.</p> </note>"""
    artifact_stores: NotRequired[
        "capo_codepipeline.types.artifact_store_map.ArtifactStoreMap"
    ]
    """<p>A mapping of <code>artifactStore</code> objects and their corresponding Amazon Web Services Regions. There must be an artifact store for the pipeline Region and for each cross-region action in the pipeline.</p> <note> <p>You must include either <code>artifactStore</code> or <code>artifactStores</code> in your pipeline, but you cannot use both. If you create a cross-region action in your pipeline, you must use <code>artifactStores</code>.</p> </note>"""
    stages: "capo_codepipeline.types.pipeline_stage_declaration_list.PipelineStageDeclarationList"
    """<p>The stage in which to perform the action.</p>"""
    version: NotRequired["capo_codepipeline.types.pipeline_version.PipelineVersion"]
    """<p>The version number of the pipeline. A new pipeline always has a version number of 1. This number is incremented when a pipeline is updated.</p>"""
    execution_mode: NotRequired["capo_codepipeline.types.execution_mode.ExecutionMode"]
    """<p>The method that the pipeline will use to handle multiple executions. The default mode is SUPERSEDED.</p>"""
    pipeline_type: NotRequired["capo_codepipeline.types.pipeline_type.PipelineType"]
    """<p>CodePipeline provides the following pipeline types, which differ in characteristics and price, so that you can tailor your pipeline features and cost to the needs of your applications.</p> <ul> <li> <p>V1 type pipelines have a JSON structure that contains standard pipeline, stage, and action-level parameters.</p> </li> <li> <p>V2 type pipelines have the same structure as a V1 type, along with additional parameters for release safety and trigger configuration.</p> </li> </ul> <important> <p>Including V2 parameters, such as triggers on Git tags, in the pipeline JSON when creating or updating a pipeline will result in the pipeline having the V2 type of pipeline and the associated costs.</p> </important> <p>For information about pricing for CodePipeline, see <a href="http://aws.amazon.com/codepipeline/pricing/">Pricing</a>.</p> <p> For information about which type of pipeline to choose, see <a href="https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html">What type of pipeline is right for me?</a>.</p>"""
    variables: NotRequired[
        "capo_codepipeline.types.pipeline_variable_declaration_list.PipelineVariableDeclarationList"
    ]
    r"""<p>A list that defines the pipeline variables for a pipeline resource. Variable names can have alphanumeric and underscore characters, and the values must match <code>[A-Za-z0-9@\-_]+</code>.</p>"""
    triggers: NotRequired[
        "capo_codepipeline.types.pipeline_trigger_declaration_list.PipelineTriggerDeclarationList"
    ]
    """<p>The trigger configuration specifying a type of event, such as Git tags, that starts the pipeline.</p> <note> <p>When a trigger configuration is specified, default change detection for repository and branch commits is disabled.</p> </note>"""

artifact_store instance-attribute

artifact_store: NotRequired[ArtifactStore]

Represents information about the S3 bucket where artifacts are stored for the pipeline.

You must include either artifactStore or artifactStores in your pipeline, but you cannot use both. If you create a cross-region action in your pipeline, you must use artifactStores.

artifact_stores instance-attribute

artifact_stores: NotRequired[ArtifactStoreMap]

A mapping of artifactStore objects and their corresponding Amazon Web Services Regions. There must be an artifact store for the pipeline Region and for each cross-region action in the pipeline.

You must include either artifactStore or artifactStores in your pipeline, but you cannot use both. If you create a cross-region action in your pipeline, you must use artifactStores.

execution_mode instance-attribute

execution_mode: NotRequired[ExecutionMode]

The method that the pipeline will use to handle multiple executions. The default mode is SUPERSEDED.

name instance-attribute

The name of the pipeline.

pipeline_type instance-attribute

pipeline_type: NotRequired[PipelineType]

CodePipeline provides the following pipeline types, which differ in characteristics and price, so that you can tailor your pipeline features and cost to the needs of your applications.

  • V1 type pipelines have a JSON structure that contains standard pipeline, stage, and action-level parameters.

  • V2 type pipelines have the same structure as a V1 type, along with additional parameters for release safety and trigger configuration.

Including V2 parameters, such as triggers on Git tags, in the pipeline JSON when creating or updating a pipeline will result in the pipeline having the V2 type of pipeline and the associated costs.

For information about pricing for CodePipeline, see Pricing.

For information about which type of pipeline to choose, see What type of pipeline is right for me?.

role_arn instance-attribute

role_arn: RoleArn

The Amazon Resource Name (ARN) for CodePipeline to use to either perform actions with no actionRoleArn, or to use to assume roles for actions with an actionRoleArn.

stages instance-attribute

The stage in which to perform the action.

triggers instance-attribute

triggers: NotRequired[PipelineTriggerDeclarationList]

The trigger configuration specifying a type of event, such as Git tags, that starts the pipeline.

When a trigger configuration is specified, default change detection for repository and branch commits is disabled.

variables instance-attribute

variables: NotRequired[PipelineVariableDeclarationList]

A list that defines the pipeline variables for a pipeline resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9@\-_]+.

version instance-attribute

version: NotRequired[PipelineVersion]

The version number of the pipeline. A new pipeline always has a version number of 1. This number is incremented when a pipeline is updated.