Interface GetMlModelResponse.Builder
- All Superinterfaces:
AwsResponse.Builder
,Buildable
,CopyableBuilder<GetMlModelResponse.Builder,
,GetMlModelResponse> MachineLearningResponse.Builder
,SdkBuilder<GetMlModelResponse.Builder,
,GetMlModelResponse> SdkPojo
,SdkResponse.Builder
- Enclosing class:
GetMlModelResponse
-
Method Summary
Modifier and TypeMethodDescriptioncomputeTime
(Long computeTime) The approximate CPU time in milliseconds that Amazon Machine Learning spent processing theMLModel
, normalized and scaled on computation resources.The time that theMLModel
was created.createdByIamUser
(String createdByIamUser) The AWS user account from which theMLModel
was created.default GetMlModelResponse.Builder
endpointInfo
(Consumer<RealtimeEndpointInfo.Builder> endpointInfo) The current endpoint of theMLModel
endpointInfo
(RealtimeEndpointInfo endpointInfo) The current endpoint of theMLModel
finishedAt
(Instant finishedAt) The epoch time when Amazon Machine Learning marked theMLModel
asCOMPLETED
orFAILED
.inputDataLocationS3
(String inputDataLocationS3) The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).lastUpdatedAt
(Instant lastUpdatedAt) The time of the most recent edit to theMLModel
.A link to the file that contains logs of theCreateMLModel
operation.A description of the most recent details about accessing theMLModel
.The MLModel ID, which is same as theMLModelId
in the request.mlModelType
(String mlModelType) Identifies theMLModel
category.mlModelType
(MLModelType mlModelType) Identifies theMLModel
category.A user-supplied name or description of theMLModel
.The recipe to use when training theMLModel
.The schema used by all of the data files referenced by theDataSource
.scoreThreshold
(Float scoreThreshold) The scoring threshold is used in binary classificationMLModel
models.scoreThresholdLastUpdatedAt
(Instant scoreThresholdLastUpdatedAt) The time of the most recent edit to theScoreThreshold
.sizeInBytes
(Long sizeInBytes) Sets the value of the SizeInBytes property for this object.The epoch time when Amazon Machine Learning marked theMLModel
asINPROGRESS
.The current status of theMLModel
.status
(EntityStatus status) The current status of theMLModel
.trainingDataSourceId
(String trainingDataSourceId) The ID of the trainingDataSource
.trainingParameters
(Map<String, String> trainingParameters) A list of the training parameters in theMLModel
.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.services.machinelearning.model.MachineLearningResponse.Builder
build, responseMetadata, responseMetadata
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
Methods inherited from interface software.amazon.awssdk.core.SdkResponse.Builder
sdkHttpResponse, sdkHttpResponse
-
Method Details
-
mlModelId
The MLModel ID, which is same as the
MLModelId
in the request.- Parameters:
mlModelId
- The MLModel ID, which is same as theMLModelId
in the request.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
trainingDataSourceId
The ID of the training
DataSource
.- Parameters:
trainingDataSourceId
- The ID of the trainingDataSource
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
createdByIamUser
The AWS user account from which the
MLModel
was created. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.- Parameters:
createdByIamUser
- The AWS user account from which theMLModel
was created. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
createdAt
The time that the
MLModel
was created. The time is expressed in epoch time.- Parameters:
createdAt
- The time that theMLModel
was created. The time is expressed in epoch time.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
lastUpdatedAt
The time of the most recent edit to the
MLModel
. The time is expressed in epoch time.- Parameters:
lastUpdatedAt
- The time of the most recent edit to theMLModel
. The time is expressed in epoch time.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
name
A user-supplied name or description of the
MLModel
.- Parameters:
name
- A user-supplied name or description of theMLModel
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
status
The current status of the
MLModel
. This element can have one of the following values:-
PENDING
- Amazon Machine Learning (Amazon ML) submitted a request to describe aMLModel
. -
INPROGRESS
- The request is processing. -
FAILED
- The request did not run to completion. The ML model isn't usable. -
COMPLETED
- The request completed successfully. -
DELETED
- TheMLModel
is marked as deleted. It isn't usable.
- Parameters:
status
- The current status of theMLModel
. This element can have one of the following values:-
PENDING
- Amazon Machine Learning (Amazon ML) submitted a request to describe aMLModel
. -
INPROGRESS
- The request is processing. -
FAILED
- The request did not run to completion. The ML model isn't usable. -
COMPLETED
- The request completed successfully. -
DELETED
- TheMLModel
is marked as deleted. It isn't usable.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
status
The current status of the
MLModel
. This element can have one of the following values:-
PENDING
- Amazon Machine Learning (Amazon ML) submitted a request to describe aMLModel
. -
INPROGRESS
- The request is processing. -
FAILED
- The request did not run to completion. The ML model isn't usable. -
COMPLETED
- The request completed successfully. -
DELETED
- TheMLModel
is marked as deleted. It isn't usable.
- Parameters:
status
- The current status of theMLModel
. This element can have one of the following values:-
PENDING
- Amazon Machine Learning (Amazon ML) submitted a request to describe aMLModel
. -
INPROGRESS
- The request is processing. -
FAILED
- The request did not run to completion. The ML model isn't usable. -
COMPLETED
- The request completed successfully. -
DELETED
- TheMLModel
is marked as deleted. It isn't usable.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
sizeInBytes
Sets the value of the SizeInBytes property for this object.- Parameters:
sizeInBytes
- The new value for the SizeInBytes property for this object.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
endpointInfo
The current endpoint of the
MLModel
- Parameters:
endpointInfo
- The current endpoint of theMLModel
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
endpointInfo
default GetMlModelResponse.Builder endpointInfo(Consumer<RealtimeEndpointInfo.Builder> endpointInfo) The current endpoint of the
This is a convenience method that creates an instance of theMLModel
RealtimeEndpointInfo.Builder
avoiding the need to create one manually viaRealtimeEndpointInfo.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toendpointInfo(RealtimeEndpointInfo)
.- Parameters:
endpointInfo
- a consumer that will call methods onRealtimeEndpointInfo.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
trainingParameters
A list of the training parameters in the
MLModel
. The list is implemented as a map of key-value pairs.The following is the current set of training parameters:
-
sgd.maxMLModelSizeInBytes
- The maximum allowed size of the model. Depending on the input data, the size of the model might affect its performance.The value is an integer that ranges from
100000
to2147483648
. The default value is33554432
. -
sgd.maxPasses
- The number of times that the training process traverses the observations to build theMLModel
. The value is an integer that ranges from1
to10000
. The default value is10
. -
sgd.shuffleType
- Whether Amazon ML shuffles the training data. Shuffling data improves a model's ability to find the optimal solution for a variety of data types. The valid values areauto
andnone
. The default value isnone
. We strongly recommend that you shuffle your data. -
sgd.l1RegularizationAmount
- The coefficient regularization L1 norm. It controls overfitting the data by penalizing large coefficients. This tends to drive coefficients to zero, resulting in a sparse feature set. If you use this parameter, start by specifying a small value, such as1.0E-08
.The value is a double that ranges from
0
toMAX_DOUBLE
. The default is to not use L1 normalization. This parameter can't be used whenL2
is specified. Use this parameter sparingly. -
sgd.l2RegularizationAmount
- The coefficient regularization L2 norm. It controls overfitting the data by penalizing large coefficients. This tends to drive coefficients to small, nonzero values. If you use this parameter, start by specifying a small value, such as1.0E-08
.The value is a double that ranges from
0
toMAX_DOUBLE
. The default is to not use L2 normalization. This parameter can't be used whenL1
is specified. Use this parameter sparingly.
- Parameters:
trainingParameters
- A list of the training parameters in theMLModel
. The list is implemented as a map of key-value pairs.The following is the current set of training parameters:
-
sgd.maxMLModelSizeInBytes
- The maximum allowed size of the model. Depending on the input data, the size of the model might affect its performance.The value is an integer that ranges from
100000
to2147483648
. The default value is33554432
. -
sgd.maxPasses
- The number of times that the training process traverses the observations to build theMLModel
. The value is an integer that ranges from1
to10000
. The default value is10
. -
sgd.shuffleType
- Whether Amazon ML shuffles the training data. Shuffling data improves a model's ability to find the optimal solution for a variety of data types. The valid values areauto
andnone
. The default value isnone
. We strongly recommend that you shuffle your data. -
sgd.l1RegularizationAmount
- The coefficient regularization L1 norm. It controls overfitting the data by penalizing large coefficients. This tends to drive coefficients to zero, resulting in a sparse feature set. If you use this parameter, start by specifying a small value, such as1.0E-08
.The value is a double that ranges from
0
toMAX_DOUBLE
. The default is to not use L1 normalization. This parameter can't be used whenL2
is specified. Use this parameter sparingly. -
sgd.l2RegularizationAmount
- The coefficient regularization L2 norm. It controls overfitting the data by penalizing large coefficients. This tends to drive coefficients to small, nonzero values. If you use this parameter, start by specifying a small value, such as1.0E-08
.The value is a double that ranges from
0
toMAX_DOUBLE
. The default is to not use L2 normalization. This parameter can't be used whenL1
is specified. Use this parameter sparingly.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
inputDataLocationS3
The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).
- Parameters:
inputDataLocationS3
- The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
mlModelType
Identifies the
MLModel
category. The following are the available types:-
REGRESSION -- Produces a numeric result. For example, "What price should a house be listed at?"
-
BINARY -- Produces one of two possible results. For example, "Is this an e-commerce website?"
-
MULTICLASS -- Produces one of several possible results. For example, "Is this a HIGH, LOW or MEDIUM risk trade?"
- Parameters:
mlModelType
- Identifies theMLModel
category. The following are the available types:-
REGRESSION -- Produces a numeric result. For example, "What price should a house be listed at?"
-
BINARY -- Produces one of two possible results. For example, "Is this an e-commerce website?"
-
MULTICLASS -- Produces one of several possible results. For example, "Is this a HIGH, LOW or MEDIUM risk trade?"
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
mlModelType
Identifies the
MLModel
category. The following are the available types:-
REGRESSION -- Produces a numeric result. For example, "What price should a house be listed at?"
-
BINARY -- Produces one of two possible results. For example, "Is this an e-commerce website?"
-
MULTICLASS -- Produces one of several possible results. For example, "Is this a HIGH, LOW or MEDIUM risk trade?"
- Parameters:
mlModelType
- Identifies theMLModel
category. The following are the available types:-
REGRESSION -- Produces a numeric result. For example, "What price should a house be listed at?"
-
BINARY -- Produces one of two possible results. For example, "Is this an e-commerce website?"
-
MULTICLASS -- Produces one of several possible results. For example, "Is this a HIGH, LOW or MEDIUM risk trade?"
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
scoreThreshold
The scoring threshold is used in binary classification
MLModel
models. It marks the boundary between a positive prediction and a negative prediction.Output values greater than or equal to the threshold receive a positive result from the MLModel, such as
true
. Output values less than the threshold receive a negative response from the MLModel, such asfalse
.- Parameters:
scoreThreshold
- The scoring threshold is used in binary classificationMLModel
models. It marks the boundary between a positive prediction and a negative prediction.Output values greater than or equal to the threshold receive a positive result from the MLModel, such as
true
. Output values less than the threshold receive a negative response from the MLModel, such asfalse
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
scoreThresholdLastUpdatedAt
The time of the most recent edit to the
ScoreThreshold
. The time is expressed in epoch time.- Parameters:
scoreThresholdLastUpdatedAt
- The time of the most recent edit to theScoreThreshold
. The time is expressed in epoch time.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
logUri
A link to the file that contains logs of the
CreateMLModel
operation.- Parameters:
logUri
- A link to the file that contains logs of theCreateMLModel
operation.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
message
A description of the most recent details about accessing the
MLModel
.- Parameters:
message
- A description of the most recent details about accessing theMLModel
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
computeTime
The approximate CPU time in milliseconds that Amazon Machine Learning spent processing the
MLModel
, normalized and scaled on computation resources.ComputeTime
is only available if theMLModel
is in theCOMPLETED
state.- Parameters:
computeTime
- The approximate CPU time in milliseconds that Amazon Machine Learning spent processing theMLModel
, normalized and scaled on computation resources.ComputeTime
is only available if theMLModel
is in theCOMPLETED
state.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
finishedAt
The epoch time when Amazon Machine Learning marked the
MLModel
asCOMPLETED
orFAILED
.FinishedAt
is only available when theMLModel
is in theCOMPLETED
orFAILED
state.- Parameters:
finishedAt
- The epoch time when Amazon Machine Learning marked theMLModel
asCOMPLETED
orFAILED
.FinishedAt
is only available when theMLModel
is in theCOMPLETED
orFAILED
state.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
startedAt
The epoch time when Amazon Machine Learning marked the
MLModel
asINPROGRESS
.StartedAt
isn't available if theMLModel
is in thePENDING
state.- Parameters:
startedAt
- The epoch time when Amazon Machine Learning marked theMLModel
asINPROGRESS
.StartedAt
isn't available if theMLModel
is in thePENDING
state.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
recipe
The recipe to use when training the
MLModel
. TheRecipe
provides detailed information about the observation data to use during training, and manipulations to perform on the observation data during training.Note: This parameter is provided as part of the verbose format.
- Parameters:
recipe
- The recipe to use when training theMLModel
. TheRecipe
provides detailed information about the observation data to use during training, and manipulations to perform on the observation data during training.Note: This parameter is provided as part of the verbose format.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
schema
The schema used by all of the data files referenced by the
DataSource
.Note: This parameter is provided as part of the verbose format.
- Parameters:
schema
- The schema used by all of the data files referenced by theDataSource
.Note: This parameter is provided as part of the verbose format.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-