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.