CodePipeline / Client / get_pipeline_execution

get_pipeline_execution#

CodePipeline.Client.get_pipeline_execution(**kwargs)#

Returns information about an execution of a pipeline, including details about artifacts, the pipeline execution ID, and the name, version, and status of the pipeline.

See also: AWS API Documentation

Request Syntax

response = client.get_pipeline_execution(
    pipelineName='string',
    pipelineExecutionId='string'
)
Parameters:

  • pipelineName (string) –

    [REQUIRED]

    The name of the pipeline about which you want to get execution details.

  • pipelineExecutionId (string) –

    [REQUIRED]

    The ID of the pipeline execution about which you want to get execution details.

Return type:

dict

Returns:

Response Syntax

{
    'pipelineExecution': {
        'pipelineName': 'string',
        'pipelineVersion': 123,
        'pipelineExecutionId': 'string',
        'status': 'Cancelled'|'InProgress'|'Stopped'|'Stopping'|'Succeeded'|'Superseded'|'Failed',
        'statusSummary': 'string',
        'artifactRevisions': [
            {
                'name': 'string',
                'revisionId': 'string',
                'revisionChangeIdentifier': 'string',
                'revisionSummary': 'string',
                'created': datetime(2015, 1, 1),
                'revisionUrl': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) –

    Represents the output of a GetPipelineExecution action.

    • pipelineExecution (dict) –

      Represents information about the execution of a pipeline.

      • pipelineName (string) –

        The name of the pipeline with the specified pipeline execution.

      • pipelineVersion (integer) –

        The version number of the pipeline with the specified pipeline execution.

      • pipelineExecutionId (string) –

        The ID of the pipeline execution.

      • status (string) –

        The status of the pipeline execution.

        • Cancelled: The pipeline’s definition was updated before the pipeline execution could be completed.

        • InProgress: The pipeline execution is currently running.

        • Stopped: The pipeline execution was manually stopped. For more information, see Stopped Executions.

        • Stopping: The pipeline execution received a request to be manually stopped. Depending on the selected stop mode, the execution is either completing or abandoning in-progress actions. For more information, see Stopped Executions.

        • Succeeded: The pipeline execution was completed successfully.

        • Superseded: While this pipeline execution was waiting for the next stage to be completed, a newer pipeline execution advanced and continued through the pipeline instead. For more information, see Superseded Executions.

        • Failed: The pipeline execution was not completed successfully.

      • statusSummary (string) –

        A summary that contains a description of the pipeline execution status.

      • artifactRevisions (list) –

        A list of ArtifactRevision objects included in a pipeline execution.

        • (dict) –

          Represents revision details of an artifact.

          • name (string) –

            The name of an artifact. This name might be system-generated, such as “MyApp”, or defined by the user when an action is created.

          • revisionId (string) –

            The revision ID of the artifact.

          • revisionChangeIdentifier (string) –

            An additional identifier for a revision, such as a commit date or, for artifacts stored in Amazon S3 buckets, the ETag value.

          • revisionSummary (string) –

            Summary information about the most recent revision of the artifact. For GitHub and CodeCommit repositories, the commit message. For Amazon S3 buckets or actions, the user-provided content of a codepipeline-artifact-revision-summary key specified in the object metadata.

          • created (datetime) –

            The date and time when the most recent revision of the artifact was created, in timestamp format.

          • revisionUrl (string) –

            The commit ID for the artifact revision. For artifacts stored in GitHub or CodeCommit repositories, the commit ID is linked to a commit details page.

Exceptions

  • CodePipeline.Client.exceptions.ValidationException

  • CodePipeline.Client.exceptions.PipelineNotFoundException

  • CodePipeline.Client.exceptions.PipelineExecutionNotFoundException