MachineLearning / Client / describe_batch_predictions

describe_batch_predictions#

MachineLearning.Client.describe_batch_predictions(**kwargs)#

Returns a list of BatchPrediction operations that match the search criteria in the request.

See also: AWS API Documentation

Request Syntax

response = client.describe_batch_predictions(
    FilterVariable='CreatedAt'|'LastUpdatedAt'|'Status'|'Name'|'IAMUser'|'MLModelId'|'DataSourceId'|'DataURI',
    EQ='string',
    GT='string',
    LT='string',
    GE='string',
    LE='string',
    NE='string',
    Prefix='string',
    SortOrder='asc'|'dsc',
    NextToken='string',
    Limit=123
)
Parameters:
  • FilterVariable (string) –

    Use one of the following variables to filter a list of BatchPrediction:

    • CreatedAt - Sets the search criteria to the BatchPrediction creation date.

    • Status - Sets the search criteria to the BatchPrediction status.

    • Name - Sets the search criteria to the contents of the BatchPrediction Name.

    • IAMUser - Sets the search criteria to the user account that invoked the BatchPrediction creation.

    • MLModelId - Sets the search criteria to the MLModel used in the BatchPrediction.

    • DataSourceId - Sets the search criteria to the DataSource used in the BatchPrediction.

    • DataURI - Sets the search criteria to the data file(s) used in the BatchPrediction. The URL can identify either a file or an Amazon Simple Storage Solution (Amazon S3) bucket or directory.

  • EQ (string) – The equal to operator. The BatchPrediction results will have FilterVariable values that exactly match the value specified with EQ.

  • GT (string) – The greater than operator. The BatchPrediction results will have FilterVariable values that are greater than the value specified with GT.

  • LT (string) – The less than operator. The BatchPrediction results will have FilterVariable values that are less than the value specified with LT.

  • GE (string) – The greater than or equal to operator. The BatchPrediction results will have FilterVariable values that are greater than or equal to the value specified with GE.

  • LE (string) – The less than or equal to operator. The BatchPrediction results will have FilterVariable values that are less than or equal to the value specified with LE.

  • NE (string) – The not equal to operator. The BatchPrediction results will have FilterVariable values not equal to the value specified with NE.

  • Prefix (string) –

    A string that is found at the beginning of a variable, such as Name or Id.

    For example, a Batch Prediction operation could have the Name 2014-09-09-HolidayGiftMailer. To search for this BatchPrediction, select Name for the FilterVariable and any of the following strings for the Prefix:

    • 2014-09

    • 2014-09-09

    • 2014-09-09-Holiday

  • SortOrder (string) –

    A two-value parameter that determines the sequence of the resulting list of ``MLModel``s.

    • asc - Arranges the list in ascending order (A-Z, 0-9).

    • dsc - Arranges the list in descending order (Z-A, 9-0).

    Results are sorted by FilterVariable.

  • NextToken (string) – An ID of the page in the paginated results.

  • Limit (integer) – The number of pages of information to include in the result. The range of acceptable values is 1 through 100. The default value is 100.

Return type:

dict

Returns:

Response Syntax

{
    'Results': [
        {
            'BatchPredictionId': 'string',
            'MLModelId': 'string',
            'BatchPredictionDataSourceId': 'string',
            'InputDataLocationS3': 'string',
            'CreatedByIamUser': 'string',
            'CreatedAt': datetime(2015, 1, 1),
            'LastUpdatedAt': datetime(2015, 1, 1),
            'Name': 'string',
            'Status': 'PENDING'|'INPROGRESS'|'FAILED'|'COMPLETED'|'DELETED',
            'OutputUri': 'string',
            'Message': 'string',
            'ComputeTime': 123,
            'FinishedAt': datetime(2015, 1, 1),
            'StartedAt': datetime(2015, 1, 1),
            'TotalRecordCount': 123,
            'InvalidRecordCount': 123
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    Represents the output of a DescribeBatchPredictions operation. The content is essentially a list of ``BatchPrediction``s.

    • Results (list) –

      A list of BatchPrediction objects that meet the search criteria.

      • (dict) –

        Represents the output of a GetBatchPrediction operation.

        The content consists of the detailed metadata, the status, and the data file information of a Batch Prediction.

        • BatchPredictionId (string) –

          The ID assigned to the BatchPrediction at creation. This value should be identical to the value of the BatchPredictionID in the request.

        • MLModelId (string) –

          The ID of the MLModel that generated predictions for the BatchPrediction request.

        • BatchPredictionDataSourceId (string) –

          The ID of the DataSource that points to the group of observations to predict.

        • InputDataLocationS3 (string) –

          The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).

        • CreatedByIamUser (string) –

          The AWS user account that invoked the BatchPrediction. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.

        • CreatedAt (datetime) –

          The time that the BatchPrediction was created. The time is expressed in epoch time.

        • LastUpdatedAt (datetime) –

          The time of the most recent edit to the BatchPrediction. The time is expressed in epoch time.

        • Name (string) –

          A user-supplied name or description of the BatchPrediction.

        • Status (string) –

          The status of the BatchPrediction. This element can have one of the following values:

          • PENDING - Amazon Machine Learning (Amazon ML) submitted a request to generate predictions for a batch of observations.

          • INPROGRESS - The process is underway.

          • FAILED - The request to perform a batch prediction did not run to completion. It is not usable.

          • COMPLETED - The batch prediction process completed successfully.

          • DELETED - The BatchPrediction is marked as deleted. It is not usable.

        • OutputUri (string) –

          The location of an Amazon S3 bucket or directory to receive the operation results. The following substrings are not allowed in the s3 key portion of the outputURI field: ‘:’, ‘//’, ‘/./’, ‘/../’.

        • Message (string) –

          A description of the most recent details about processing the batch prediction request.

        • ComputeTime (integer) –

          Long integer type that is a 64-bit signed number.

        • FinishedAt (datetime) –

          A timestamp represented in epoch time.

        • StartedAt (datetime) –

          A timestamp represented in epoch time.

        • TotalRecordCount (integer) –

          Long integer type that is a 64-bit signed number.

        • InvalidRecordCount (integer) –

          Long integer type that is a 64-bit signed number.

    • NextToken (string) –

      The ID of the next page in the paginated results that indicates at least one more page follows.

Exceptions

  • MachineLearning.Client.exceptions.InvalidInputException

  • MachineLearning.Client.exceptions.InternalServerException