CodePipeline / Paginator / ListPipelineExecutions

ListPipelineExecutions#

class CodePipeline.Paginator.ListPipelineExecutions#
paginator = client.get_paginator('list_pipeline_executions')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from CodePipeline.Client.list_pipeline_executions().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    pipelineName='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • pipelineName (string) –

    [REQUIRED]

    The name of the pipeline for which you want to get execution summary information.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'pipelineExecutionSummaries': [
        {
            'pipelineExecutionId': 'string',
            'status': 'Cancelled'|'InProgress'|'Stopped'|'Stopping'|'Succeeded'|'Superseded'|'Failed',
            'startTime': datetime(2015, 1, 1),
            'lastUpdateTime': datetime(2015, 1, 1),
            'sourceRevisions': [
                {
                    'actionName': 'string',
                    'revisionId': 'string',
                    'revisionSummary': 'string',
                    'revisionUrl': 'string'
                },
            ],
            'trigger': {
                'triggerType': 'CreatePipeline'|'StartPipelineExecution'|'PollForSourceChanges'|'Webhook'|'CloudWatchEvent'|'PutActionRevision',
                'triggerDetail': 'string'
            },
            'stopTrigger': {
                'reason': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    Represents the output of a ListPipelineExecutions action.

    • pipelineExecutionSummaries (list) –

      A list of executions in the history of a pipeline.

      • (dict) –

        Summary information about a pipeline execution.

        • pipelineExecutionId (string) –

          The ID of the pipeline execution.

        • status (string) –

          The status of the pipeline execution.

          • 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.

        • startTime (datetime) –

          The date and time when the pipeline execution began, in timestamp format.

        • lastUpdateTime (datetime) –

          The date and time of the last change to the pipeline execution, in timestamp format.

        • sourceRevisions (list) –

          A list of the source artifact revisions that initiated a pipeline execution.

          • (dict) –

            Information about the version (or revision) of a source artifact that initiated a pipeline execution.

            • actionName (string) –

              The name of the action that processed the revision to the source artifact.

            • revisionId (string) –

              The system-generated unique ID that identifies the revision number of the artifact.

            • revisionSummary (string) –

              Summary information about the most recent revision of the artifact. For GitHub and AWS 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.

            • revisionUrl (string) –

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

        • trigger (dict) –

          The interaction or event that started a pipeline execution, such as automated change detection or a StartPipelineExecution API call.

          • triggerType (string) –

            The type of change-detection method, command, or user interaction that started a pipeline execution.

          • triggerDetail (string) –

            Detail related to the event that started a pipeline execution, such as the webhook ARN of the webhook that triggered the pipeline execution or the user ARN for a user-initiated start-pipeline-execution CLI command.

        • stopTrigger (dict) –

          The interaction that stopped a pipeline execution.

          • reason (string) –

            The user-specified reason the pipeline was stopped.

    • NextToken (string) –

      A token to resume pagination.