Glue / Client / get_blueprint_runs



Retrieves the details of blueprint runs for a specified blueprint.

See also: AWS API Documentation

Request Syntax

response = client.get_blueprint_runs(
  • BlueprintName (string) –


    The name of the blueprint.

  • NextToken (string) – A continuation token, if this is a continuation request.

  • MaxResults (integer) – The maximum size of a list to return.

Return type:



Response Syntax

    'BlueprintRuns': [
            'BlueprintName': 'string',
            'RunId': 'string',
            'WorkflowName': 'string',
            'StartedOn': datetime(2015, 1, 1),
            'CompletedOn': datetime(2015, 1, 1),
            'ErrorMessage': 'string',
            'RollbackErrorMessage': 'string',
            'Parameters': 'string',
            'RoleArn': 'string'
    'NextToken': 'string'

Response Structure

  • (dict) –

    • BlueprintRuns (list) –

      Returns a list of BlueprintRun objects.

      • (dict) –

        The details of a blueprint run.

        • BlueprintName (string) –

          The name of the blueprint.

        • RunId (string) –

          The run ID for this blueprint run.

        • WorkflowName (string) –

          The name of a workflow that is created as a result of a successful blueprint run. If a blueprint run has an error, there will not be a workflow created.

        • State (string) –

          The state of the blueprint run. Possible values are:

          • Running — The blueprint run is in progress.

          • Succeeded — The blueprint run completed successfully.

          • Failed — The blueprint run failed and rollback is complete.

          • Rolling Back — The blueprint run failed and rollback is in progress.

        • StartedOn (datetime) –

          The date and time that the blueprint run started.

        • CompletedOn (datetime) –

          The date and time that the blueprint run completed.

        • ErrorMessage (string) –

          Indicates any errors that are seen while running the blueprint.

        • RollbackErrorMessage (string) –

          If there are any errors while creating the entities of a workflow, we try to roll back the created entities until that point and delete them. This attribute indicates the errors seen while trying to delete the entities that are created.

        • Parameters (string) –

          The blueprint parameters as a string. You will have to provide a value for each key that is required from the parameter spec that is defined in the Blueprint$ParameterSpec.

        • RoleArn (string) –

          The role ARN. This role will be assumed by the Glue service and will be used to create the workflow and other entities of a workflow.

    • NextToken (string) –

      A continuation token, if not all blueprint runs have been returned.


  • Glue.Client.exceptions.EntityNotFoundException

  • Glue.Client.exceptions.InternalServiceException

  • Glue.Client.exceptions.OperationTimeoutException

  • Glue.Client.exceptions.InvalidInputException