Appflow / Client / describe_flow_execution_records

describe_flow_execution_records#

Appflow.Client.describe_flow_execution_records(**kwargs)#

Fetches the execution history of the flow.

See also: AWS API Documentation

Request Syntax

response = client.describe_flow_execution_records(
    flowName='string',
    maxResults=123,
    nextToken='string'
)
Parameters:
  • flowName (string) –

    [REQUIRED]

    The specified name of the flow. Spaces are not allowed. Use underscores (_) or hyphens (-) only.

  • maxResults (integer) – Specifies the maximum number of items that should be returned in the result set. The default for maxResults is 20 (for all paginated API operations).

  • nextToken (string) – The pagination token for the next page of data.

Return type:

dict

Returns:

Response Syntax

{
    'flowExecutions': [
        {
            'executionId': 'string',
            'executionStatus': 'InProgress'|'Successful'|'Error'|'CancelStarted'|'Canceled',
            'executionResult': {
                'errorInfo': {
                    'putFailuresCount': 123,
                    'executionMessage': 'string'
                },
                'bytesProcessed': 123,
                'bytesWritten': 123,
                'recordsProcessed': 123,
                'numParallelProcesses': 123,
                'maxPageSize': 123
            },
            'startedAt': datetime(2015, 1, 1),
            'lastUpdatedAt': datetime(2015, 1, 1),
            'dataPullStartTime': datetime(2015, 1, 1),
            'dataPullEndTime': datetime(2015, 1, 1),
            'metadataCatalogDetails': [
                {
                    'catalogType': 'GLUE',
                    'tableName': 'string',
                    'tableRegistrationOutput': {
                        'message': 'string',
                        'result': 'string',
                        'status': 'InProgress'|'Successful'|'Error'|'CancelStarted'|'Canceled'
                    },
                    'partitionRegistrationOutput': {
                        'message': 'string',
                        'result': 'string',
                        'status': 'InProgress'|'Successful'|'Error'|'CancelStarted'|'Canceled'
                    }
                },
            ]
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • flowExecutions (list) –

      Returns a list of all instances when this flow was run.

      • (dict) –

        Specifies information about the past flow run instances for a given flow.

        • executionId (string) –

          Specifies the identifier of the given flow run.

        • executionStatus (string) –

          Specifies the flow run status and whether it is in progress, has completed successfully, or has failed.

        • executionResult (dict) –

          Describes the result of the given flow run.

          • errorInfo (dict) –

            Provides any error message information related to the flow run.

            • putFailuresCount (integer) –

              Specifies the failure count for the attempted flow.

            • executionMessage (string) –

              Specifies the error message that appears if a flow fails.

          • bytesProcessed (integer) –

            The total number of bytes processed by the flow run.

          • bytesWritten (integer) –

            The total number of bytes written as a result of the flow run.

          • recordsProcessed (integer) –

            The number of records processed in the flow run.

          • numParallelProcesses (integer) –

            The number of processes that Amazon AppFlow ran at the same time when it retrieved your data.

          • maxPageSize (integer) –

            The maximum number of records that Amazon AppFlow receives in each page of the response from your SAP application.

        • startedAt (datetime) –

          Specifies the start time of the flow run.

        • lastUpdatedAt (datetime) –

          Specifies the time of the most recent update.

        • dataPullStartTime (datetime) –

          The timestamp that determines the first new or updated record to be transferred in the flow run.

        • dataPullEndTime (datetime) –

          The timestamp that indicates the last new or updated record to be transferred in the flow run.

        • metadataCatalogDetails (list) –

          Describes the metadata catalog, metadata table, and data partitions that Amazon AppFlow used for the associated flow run.

          • (dict) –

            Describes the metadata catalog, metadata table, and data partitions that Amazon AppFlow used for the associated flow run.

            • catalogType (string) –

              The type of metadata catalog that Amazon AppFlow used for the associated flow run. This parameter returns the following value:

              GLUE

              The metadata catalog is provided by the Glue Data Catalog. Glue includes the Glue Data Catalog as a component.

            • tableName (string) –

              The name of the table that stores the metadata for the associated flow run. The table stores metadata that represents the data that the flow transferred. Amazon AppFlow stores the table in the metadata catalog.

            • tableRegistrationOutput (dict) –

              Describes the status of the attempt from Amazon AppFlow to register the metadata table with the metadata catalog. Amazon AppFlow creates or updates this table for the associated flow run.

              • message (string) –

                Explains the status of the registration attempt from Amazon AppFlow. If the attempt fails, the message explains why.

              • result (string) –

                Indicates the number of resources that Amazon AppFlow created or updated. Possible resources include metadata tables and data partitions.

              • status (string) –

                Indicates the status of the registration attempt from Amazon AppFlow.

            • partitionRegistrationOutput (dict) –

              Describes the status of the attempt from Amazon AppFlow to register the data partitions with the metadata catalog. The data partitions organize the flow output into a hierarchical path, such as a folder path in an S3 bucket. Amazon AppFlow creates the partitions (if they don’t already exist) based on your flow configuration.

              • message (string) –

                Explains the status of the registration attempt from Amazon AppFlow. If the attempt fails, the message explains why.

              • result (string) –

                Indicates the number of resources that Amazon AppFlow created or updated. Possible resources include metadata tables and data partitions.

              • status (string) –

                Indicates the status of the registration attempt from Amazon AppFlow.

    • nextToken (string) –

      The pagination token for the next page of data.

Exceptions

  • Appflow.Client.exceptions.ValidationException

  • Appflow.Client.exceptions.ResourceNotFoundException

  • Appflow.Client.exceptions.InternalServerException