AWS CodePipeline

{'pipelineExecutionSummaries': {'sourceRevisions': [{'actionName': 'string',
                                                     'revisionId': 'string',
                                                     'revisionSummary': 'string',
                                                     'revisionUrl': 'string'}]}}

Gets a summary of the most recent executions for a pipeline.

See also: AWS API Documentation

Request Syntax

client.list_pipeline_executions(
    pipelineName='string',
    maxResults=123,
    nextToken='string'
)

type pipelineName:

string

param pipelineName:

[REQUIRED]

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

type maxResults:

integer

param maxResults:

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned nextToken value. The available pipeline execution history is limited to the most recent 12 months, based on pipeline execution start times. Default value is 100.

type nextToken:

string

param nextToken:

The token that was returned from the previous ListPipelineExecutions call, which can be used to return the next set of pipeline executions in the list.

rtype:

dict

returns:

Response Syntax

{
    'pipelineExecutionSummaries': [
        {
            'pipelineExecutionId': 'string',
            'status': 'InProgress'|'Succeeded'|'Superseded'|'Failed',
            'startTime': datetime(2015, 1, 1),
            'lastUpdateTime': datetime(2015, 1, 1),
            'sourceRevisions': [
                {
                    'actionName': 'string',
                    'revisionId': 'string',
                    'revisionSummary': 'string',
                    'revisionUrl': '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.

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

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

        • (dict) --

          • actionName (string) --

          • revisionId (string) --

          • revisionSummary (string) --

          • revisionUrl (string) --

  • nextToken (string) --

    A token that can be used in the next ListPipelineExecutions call. To view all items in the list, continue to call this operation with each subsequent token until no more nextToken values are returned.