predictΒΆ

predict(**kwargs)

Generates a prediction for the observation using the specified ML Model .

Note: Not all response parameters will be populated. Whether a response parameter is populated depends on the type of model requested.

See also: AWS API Documentation

Request Syntax

response = client.predict(
    MLModelId='string',
    Record={
        'string': 'string'
    },
    PredictEndpoint='string'
)
Parameters
  • MLModelId (string) --

    [REQUIRED]

    A unique identifier of the MLModel .

  • Record (dict) --

    [REQUIRED]

    A map of variable name-value pairs that represent an observation.

    • (string) --

      The name of a variable. Currently it's used to specify the name of the target value, label, weight, and tags.

      • (string) --

        The value of a variable. Currently it's used to specify values of the target value, weights, and tag variables and for filtering variable values.

  • PredictEndpoint (string) -- [REQUIRED]
Return type

dict

Returns

Response Syntax

{
    'Prediction': {
        'predictedLabel': 'string',
        'predictedValue': ...,
        'predictedScores': {
            'string': ...
        },
        'details': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) --

    • Prediction (dict) --

      The output from a Predict operation:

      • Details - Contains the following attributes: DetailsAttributes.PREDICTIVE_MODEL_TYPE - REGRESSION | BINARY | MULTICLASS DetailsAttributes.ALGORITHM - SGD
      • PredictedLabel - Present for either a BINARY or MULTICLASS MLModel request.
      • PredictedScores - Contains the raw classification score corresponding to each label.
      • PredictedValue - Present for a REGRESSION MLModel request.
      • predictedLabel (string) --

        The prediction label for either a BINARY or MULTICLASS MLModel .

      • predictedValue (float) --

        The prediction value for REGRESSION MLModel .

      • predictedScores (dict) --

        Provides the raw classification score corresponding to each label.

        • (string) --
          • (float) --
      • details (dict) --

        Provides any additional details regarding the prediction.

        • (string) --

          Contains the key values of DetailsMap :

          • PredictiveModelType - Indicates the type of the MLModel .
          • Algorithm - Indicates the algorithm that was used for the MLModel .
          • (string) --

Exceptions

  • MachineLearning.Client.exceptions.InvalidInputException
  • MachineLearning.Client.exceptions.ResourceNotFoundException
  • MachineLearning.Client.exceptions.LimitExceededException
  • MachineLearning.Client.exceptions.InternalServerException
  • MachineLearning.Client.exceptions.PredictorNotMountedException