Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1433170151.6 KB

Creates an ML model for data inference.

A machine-learning (ML) model is a mathematical model that finds patterns in your data. In Amazon Lookout for Equipment, the model learns the patterns of normal behavior and detects abnormal behavior that could be potential equipment failure (or maintenance events). The models are made by analyzing normal data and abnormalities in machine behavior that have already occurred.

Your model is trained using a portion of the data from your dataset and uses that data to learn patterns of normal behavior and abnormal patterns that lead to equipment failure. Another portion of the data is used to evaluate the model's accuracy.

post/#X-Amz-Target=AWSLookoutEquipmentFrontendService.CreateModel

Headers

X-Amz-Target'AWSLookoutEquipmentFrontendService.CreateModel' required

Request body

ModelNamestring required

The name for the ML model to be created.

DatasetNamestring required

The name of the dataset for the ML model being created.

ClientTokenstring required

A unique identifier for the request. If you do not set the client request token, Amazon Lookout for Equipment generates one.

TrainingDataStartTimestring date-time

Indicates the time reference in the dataset that should be used to begin the subset of training data for the ML model.

TrainingDataEndTimestring date-time

Indicates the time reference in the dataset that should be used to end the subset of training data for the ML model.

EvaluationDataStartTimestring date-time

Indicates the time reference in the dataset that should be used to begin the subset of evaluation data for the ML model.

EvaluationDataEndTimestring date-time

Indicates the time reference in the dataset that should be used to end the subset of evaluation data for the ML model.

RoleArnstring

The Amazon Resource Name (ARN) of a role with permission to access the data source being used to create the ML model.

ServerSideKmsKeyIdstring

Provides the identifier of the KMS key used to encrypt model data by Amazon Lookout for Equipment.

OffConditionstring

Indicates that the asset associated with this sensor has been shut off. As long as this condition is met, Lookout for Equipment will not use data from this asset for training, evaluation, or inference.

Response

Success

ModelArnstring

The Amazon Resource Name (ARN) of the model being created.

Status'IN_PROGRESS' | 'SUCCESS' | 'FAILED'

Indicates the status of the <code>CreateModel</code> operation.