Skip to content

DescribePredictorResponse

Source code in docs_src/capo_forecast/types/describe_predictor_response.py
class DescribePredictorResponse(TypedDict, closed=True):
    predictor_arn: NotRequired["capo_forecast.types.name.Name"]
    """<p>The ARN of the predictor.</p>"""
    predictor_name: NotRequired["capo_forecast.types.name.Name"]
    """<p>The name of the predictor.</p>"""
    algorithm_arn: NotRequired["capo_forecast.types.arn.Arn"]
    """<p>The Amazon Resource Name (ARN) of the algorithm used for model training.</p>"""
    auto_ml_algorithm_arns: NotRequired["capo_forecast.types.arn_list.ArnList"]
    """<p>When <code>PerformAutoML</code> is specified, the ARN of the chosen algorithm.</p>"""
    forecast_horizon: NotRequired["capo_forecast.types.integer.Integer"]
    """<p>The number of time-steps of the forecast. The forecast horizon is also called the prediction length.</p>"""
    forecast_types: NotRequired["capo_forecast.types.forecast_types.ForecastTypes"]
    """<p>The forecast types used during predictor training. Default value is <code>["0.1","0.5","0.9"]</code> </p>"""
    perform_auto_ml: NotRequired["capo_forecast.types.boolean.Boolean"]
    """<p>Whether the predictor is set to perform AutoML.</p>"""
    auto_ml_override_strategy: NotRequired[
        "capo_forecast.types.auto_ml_override_strategy.AutoMLOverrideStrategy"
    ]
    """<note> <p> The <code>LatencyOptimized</code> AutoML override strategy is only available in private beta. Contact Amazon Web Services Support or your account manager to learn more about access privileges. </p> </note> <p>The AutoML strategy used to train the predictor. Unless <code>LatencyOptimized</code> is specified, the AutoML strategy optimizes predictor accuracy.</p> <p>This parameter is only valid for predictors trained using AutoML.</p>"""
    perform_hpo: NotRequired["capo_forecast.types.boolean.Boolean"]
    """<p>Whether the predictor is set to perform hyperparameter optimization (HPO).</p>"""
    training_parameters: NotRequired[
        "capo_forecast.types.training_parameters.TrainingParameters"
    ]
    """<p>The default training parameters or overrides selected during model training. When running AutoML or choosing HPO with CNN-QR or DeepAR+, the optimized values for the chosen hyperparameters are returned. For more information, see <a>aws-forecast-choosing-recipes</a>.</p>"""
    evaluation_parameters: NotRequired[
        "capo_forecast.types.evaluation_parameters.EvaluationParameters"
    ]
    """<p>Used to override the default evaluation parameters of the specified algorithm. Amazon Forecast evaluates a predictor by splitting a dataset into training data and testing data. The evaluation parameters define how to perform the split and the number of iterations.</p>"""
    hpo_config: NotRequired[
        "capo_forecast.types.hyper_parameter_tuning_job_config.HyperParameterTuningJobConfig"
    ]
    """<p>The hyperparameter override values for the algorithm.</p>"""
    input_data_config: NotRequired[
        "capo_forecast.types.input_data_config.InputDataConfig"
    ]
    """<p>Describes the dataset group that contains the data to use to train the predictor.</p>"""
    featurization_config: NotRequired[
        "capo_forecast.types.featurization_config.FeaturizationConfig"
    ]
    """<p>The featurization configuration.</p>"""
    encryption_config: NotRequired[
        "capo_forecast.types.encryption_config.EncryptionConfig"
    ]
    """<p>An Key Management Service (KMS) key and the Identity and Access Management (IAM) role that Amazon Forecast can assume to access the key.</p>"""
    predictor_execution_details: NotRequired[
        "capo_forecast.types.predictor_execution_details.PredictorExecutionDetails"
    ]
    """<p>Details on the the status and results of the backtests performed to evaluate the accuracy of the predictor. You specify the number of backtests to perform when you call the operation.</p>"""
    estimated_time_remaining_in_minutes: NotRequired["capo_forecast.types.long.Long"]
    """<p>The estimated time remaining in minutes for the predictor training job to complete.</p>"""
    is_auto_predictor: NotRequired["capo_forecast.types.boolean.Boolean"]
    """<p>Whether the predictor was created with <a>CreateAutoPredictor</a>.</p>"""
    dataset_import_job_arns: NotRequired["capo_forecast.types.arn_list.ArnList"]
    """<p>An array of the ARNs of the dataset import jobs used to import training data for the predictor.</p>"""
    status: NotRequired["capo_forecast.types.status.Status"]
    """<p>The status of the predictor. States include:</p> <ul> <li> <p> <code>ACTIVE</code> </p> </li> <li> <p> <code>CREATE_PENDING</code>, <code>CREATE_IN_PROGRESS</code>, <code>CREATE_FAILED</code> </p> </li> <li> <p> <code>DELETE_PENDING</code>, <code>DELETE_IN_PROGRESS</code>, <code>DELETE_FAILED</code> </p> </li> <li> <p> <code>CREATE_STOPPING</code>, <code>CREATE_STOPPED</code> </p> </li> </ul> <note> <p>The <code>Status</code> of the predictor must be <code>ACTIVE</code> before you can use the predictor to create a forecast.</p> </note>"""
    message: NotRequired["capo_forecast.types.message.Message"]
    """<p>If an error occurred, an informational message about the error.</p>"""
    creation_time: NotRequired["capo_forecast.types.timestamp.Timestamp"]
    """<p>When the model training task was created.</p>"""
    last_modification_time: NotRequired["capo_forecast.types.timestamp.Timestamp"]
    """<p>The last time the resource was modified. The timestamp depends on the status of the job:</p> <ul> <li> <p> <code>CREATE_PENDING</code> - The <code>CreationTime</code>.</p> </li> <li> <p> <code>CREATE_IN_PROGRESS</code> - The current timestamp.</p> </li> <li> <p> <code>CREATE_STOPPING</code> - The current timestamp.</p> </li> <li> <p> <code>CREATE_STOPPED</code> - When the job stopped.</p> </li> <li> <p> <code>ACTIVE</code> or <code>CREATE_FAILED</code> - When the job finished or failed.</p> </li> </ul>"""
    optimization_metric: NotRequired[
        "capo_forecast.types.optimization_metric.OptimizationMetric"
    ]
    """<p>The accuracy metric used to optimize the predictor.</p>"""

algorithm_arn instance-attribute

algorithm_arn: NotRequired[Arn]

The Amazon Resource Name (ARN) of the algorithm used for model training.

auto_ml_algorithm_arns instance-attribute

auto_ml_algorithm_arns: NotRequired[ArnList]

When PerformAutoML is specified, the ARN of the chosen algorithm.

auto_ml_override_strategy instance-attribute

auto_ml_override_strategy: NotRequired[AutoMLOverrideStrategy]

The LatencyOptimized AutoML override strategy is only available in private beta. Contact Amazon Web Services Support or your account manager to learn more about access privileges.

The AutoML strategy used to train the predictor. Unless LatencyOptimized is specified, the AutoML strategy optimizes predictor accuracy.

This parameter is only valid for predictors trained using AutoML.

creation_time instance-attribute

creation_time: NotRequired[Timestamp]

When the model training task was created.

dataset_import_job_arns instance-attribute

dataset_import_job_arns: NotRequired[ArnList]

An array of the ARNs of the dataset import jobs used to import training data for the predictor.

encryption_config instance-attribute

encryption_config: NotRequired[EncryptionConfig]

An Key Management Service (KMS) key and the Identity and Access Management (IAM) role that Amazon Forecast can assume to access the key.

estimated_time_remaining_in_minutes instance-attribute

estimated_time_remaining_in_minutes: NotRequired[Long]

The estimated time remaining in minutes for the predictor training job to complete.

evaluation_parameters instance-attribute

evaluation_parameters: NotRequired[EvaluationParameters]

Used to override the default evaluation parameters of the specified algorithm. Amazon Forecast evaluates a predictor by splitting a dataset into training data and testing data. The evaluation parameters define how to perform the split and the number of iterations.

featurization_config instance-attribute

featurization_config: NotRequired[FeaturizationConfig]

The featurization configuration.

forecast_horizon instance-attribute

forecast_horizon: NotRequired[Integer]

The number of time-steps of the forecast. The forecast horizon is also called the prediction length.

forecast_types instance-attribute

forecast_types: NotRequired[ForecastTypes]

The forecast types used during predictor training. Default value is ["0.1","0.5","0.9"]

hpo_config instance-attribute

hpo_config: NotRequired[HyperParameterTuningJobConfig]

The hyperparameter override values for the algorithm.

input_data_config instance-attribute

input_data_config: NotRequired[InputDataConfig]

Describes the dataset group that contains the data to use to train the predictor.

is_auto_predictor instance-attribute

is_auto_predictor: NotRequired[Boolean]

Whether the predictor was created with CreateAutoPredictor.

last_modification_time instance-attribute

last_modification_time: NotRequired[Timestamp]

The last time the resource was modified. The timestamp depends on the status of the job:

  • CREATE_PENDING - The CreationTime.

  • CREATE_IN_PROGRESS - The current timestamp.

  • CREATE_STOPPING - The current timestamp.

  • CREATE_STOPPED - When the job stopped.

  • ACTIVE or CREATE_FAILED - When the job finished or failed.

message instance-attribute

message: NotRequired[Message]

If an error occurred, an informational message about the error.

optimization_metric instance-attribute

optimization_metric: NotRequired[OptimizationMetric]

The accuracy metric used to optimize the predictor.

perform_auto_ml instance-attribute

perform_auto_ml: NotRequired[Boolean]

Whether the predictor is set to perform AutoML.

perform_hpo instance-attribute

perform_hpo: NotRequired[Boolean]

Whether the predictor is set to perform hyperparameter optimization (HPO).

predictor_arn instance-attribute

predictor_arn: NotRequired[Name]

The ARN of the predictor.

predictor_execution_details instance-attribute

predictor_execution_details: NotRequired[PredictorExecutionDetails]

Details on the the status and results of the backtests performed to evaluate the accuracy of the predictor. You specify the number of backtests to perform when you call the operation.

predictor_name instance-attribute

predictor_name: NotRequired[Name]

The name of the predictor.

status instance-attribute

status: NotRequired[Status]

The status of the predictor. States include:

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • CREATE_STOPPING, CREATE_STOPPED

The Status of the predictor must be ACTIVE before you can use the predictor to create a forecast.

training_parameters instance-attribute

training_parameters: NotRequired[TrainingParameters]

The default training parameters or overrides selected during model training. When running AutoML or choosing HPO with CNN-QR or DeepAR+, the optimized values for the chosen hyperparameters are returned. For more information, see aws-forecast-choosing-recipes.