Class GetMlModelResponse
- java.lang.Object
-
- software.amazon.awssdk.core.SdkResponse
-
- software.amazon.awssdk.awscore.AwsResponse
-
- software.amazon.awssdk.services.machinelearning.model.MachineLearningResponse
-
- software.amazon.awssdk.services.machinelearning.model.GetMlModelResponse
-
- All Implemented Interfaces:
SdkPojo,ToCopyableBuilder<GetMlModelResponse.Builder,GetMlModelResponse>
@Generated("software.amazon.awssdk:codegen") public final class GetMlModelResponse extends MachineLearningResponse implements ToCopyableBuilder<GetMlModelResponse.Builder,GetMlModelResponse>
Represents the output of a
GetMLModeloperation, and provides detailed information about aMLModel.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceGetMlModelResponse.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static GetMlModelResponse.Builderbuilder()LongcomputeTime()The approximate CPU time in milliseconds that Amazon Machine Learning spent processing theMLModel, normalized and scaled on computation resources.InstantcreatedAt()The time that theMLModelwas created.StringcreatedByIamUser()The AWS user account from which theMLModelwas created.RealtimeEndpointInfoendpointInfo()The current endpoint of theMLModelbooleanequals(Object obj)booleanequalsBySdkFields(Object obj)InstantfinishedAt()The epoch time when Amazon Machine Learning marked theMLModelasCOMPLETEDorFAILED.<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()booleanhasTrainingParameters()For responses, this returns true if the service returned a value for the TrainingParameters property.StringinputDataLocationS3()The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).InstantlastUpdatedAt()The time of the most recent edit to theMLModel.StringlogUri()A link to the file that contains logs of theCreateMLModeloperation.Stringmessage()A description of the most recent details about accessing theMLModel.StringmlModelId()The MLModel ID, which is same as theMLModelIdin the request.MLModelTypemlModelType()Identifies theMLModelcategory.StringmlModelTypeAsString()Identifies theMLModelcategory.Stringname()A user-supplied name or description of theMLModel.Stringrecipe()The recipe to use when training theMLModel.Stringschema()The schema used by all of the data files referenced by theDataSource.FloatscoreThreshold()The scoring threshold is used in binary classificationMLModelmodels.InstantscoreThresholdLastUpdatedAt()The time of the most recent edit to theScoreThreshold.List<SdkField<?>>sdkFields()static Class<? extends GetMlModelResponse.Builder>serializableBuilderClass()LongsizeInBytes()Returns the value of the SizeInBytes property for this object.InstantstartedAt()The epoch time when Amazon Machine Learning marked theMLModelasINPROGRESS.EntityStatusstatus()The current status of theMLModel.StringstatusAsString()The current status of theMLModel.GetMlModelResponse.BuildertoBuilder()StringtoString()Returns a string representation of this object.StringtrainingDataSourceId()The ID of the trainingDataSource.Map<String,String>trainingParameters()A list of the training parameters in theMLModel.-
Methods inherited from class software.amazon.awssdk.services.machinelearning.model.MachineLearningResponse
responseMetadata
-
Methods inherited from class software.amazon.awssdk.core.SdkResponse
sdkHttpResponse
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
mlModelId
public final String mlModelId()
The MLModel ID, which is same as the
MLModelIdin the request.- Returns:
- The MLModel ID, which is same as the
MLModelIdin the request.
-
trainingDataSourceId
public final String trainingDataSourceId()
The ID of the training
DataSource.- Returns:
- The ID of the training
DataSource.
-
createdByIamUser
public final String createdByIamUser()
The AWS user account from which the
MLModelwas created. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.- Returns:
- The AWS user account from which the
MLModelwas created. The account type can be either an AWS root account or an AWS Identity and Access Management (IAM) user account.
-
createdAt
public final Instant createdAt()
The time that the
MLModelwas created. The time is expressed in epoch time.- Returns:
- The time that the
MLModelwas created. The time is expressed in epoch time.
-
lastUpdatedAt
public final Instant lastUpdatedAt()
The time of the most recent edit to the
MLModel. The time is expressed in epoch time.- Returns:
- The time of the most recent edit to the
MLModel. The time is expressed in epoch time.
-
name
public final String name()
A user-supplied name or description of the
MLModel.- Returns:
- A user-supplied name or description of the
MLModel.
-
status
public final EntityStatus 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- TheMLModelis marked as deleted. It isn't usable.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnEntityStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- 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- TheMLModelis marked as deleted. It isn't usable.
-
- See Also:
EntityStatus
-
-
statusAsString
public final String statusAsString()
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- TheMLModelis marked as deleted. It isn't usable.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnEntityStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- 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- TheMLModelis marked as deleted. It isn't usable.
-
- See Also:
EntityStatus
-
-
sizeInBytes
public final Long sizeInBytes()
Returns the value of the SizeInBytes property for this object.- Returns:
- The value of the SizeInBytes property for this object.
-
endpointInfo
public final RealtimeEndpointInfo endpointInfo()
The current endpoint of the
MLModel- Returns:
- The current endpoint of the
MLModel
-
hasTrainingParameters
public final boolean hasTrainingParameters()
For responses, this returns true if the service returned a value for the TrainingParameters property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
trainingParameters
public final Map<String,String> 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
100000to2147483648. 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 from1to10000. 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 areautoandnone. 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
0toMAX_DOUBLE. The default is to not use L1 normalization. This parameter can't be used whenL2is 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
0toMAX_DOUBLE. The default is to not use L2 normalization. This parameter can't be used whenL1is specified. Use this parameter sparingly.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasTrainingParameters()method.- Returns:
- 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
100000to2147483648. 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 from1to10000. 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 areautoandnone. 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
0toMAX_DOUBLE. The default is to not use L1 normalization. This parameter can't be used whenL2is 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
0toMAX_DOUBLE. The default is to not use L2 normalization. This parameter can't be used whenL1is specified. Use this parameter sparingly.
-
-
-
inputDataLocationS3
public final String inputDataLocationS3()
The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).
- Returns:
- The location of the data file or directory in Amazon Simple Storage Service (Amazon S3).
-
mlModelType
public final MLModelType mlModelType()
Identifies the
MLModelcategory. 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?"
If the service returns an enum value that is not available in the current SDK version,
mlModelTypewill returnMLModelType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frommlModelTypeAsString().- Returns:
- Identifies the
MLModelcategory. 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?"
-
- See Also:
MLModelType
-
-
mlModelTypeAsString
public final String mlModelTypeAsString()
Identifies the
MLModelcategory. 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?"
If the service returns an enum value that is not available in the current SDK version,
mlModelTypewill returnMLModelType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frommlModelTypeAsString().- Returns:
- Identifies the
MLModelcategory. 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?"
-
- See Also:
MLModelType
-
-
scoreThreshold
public final Float scoreThreshold()
The scoring threshold is used in binary classification
MLModelmodels. 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:
- The scoring threshold is used in binary classification
MLModelmodels. 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.
-
scoreThresholdLastUpdatedAt
public final Instant scoreThresholdLastUpdatedAt()
The time of the most recent edit to the
ScoreThreshold. The time is expressed in epoch time.- Returns:
- The time of the most recent edit to the
ScoreThreshold. The time is expressed in epoch time.
-
logUri
public final String logUri()
A link to the file that contains logs of the
CreateMLModeloperation.- Returns:
- A link to the file that contains logs of the
CreateMLModeloperation.
-
message
public final String message()
A description of the most recent details about accessing the
MLModel.- Returns:
- A description of the most recent details about accessing the
MLModel.
-
computeTime
public final Long computeTime()
The approximate CPU time in milliseconds that Amazon Machine Learning spent processing the
MLModel, normalized and scaled on computation resources.ComputeTimeis only available if theMLModelis in theCOMPLETEDstate.- Returns:
- The approximate CPU time in milliseconds that Amazon Machine Learning spent processing the
MLModel, normalized and scaled on computation resources.ComputeTimeis only available if theMLModelis in theCOMPLETEDstate.
-
finishedAt
public final Instant finishedAt()
The epoch time when Amazon Machine Learning marked the
MLModelasCOMPLETEDorFAILED.FinishedAtis only available when theMLModelis in theCOMPLETEDorFAILEDstate.- Returns:
- The epoch time when Amazon Machine Learning marked the
MLModelasCOMPLETEDorFAILED.FinishedAtis only available when theMLModelis in theCOMPLETEDorFAILEDstate.
-
startedAt
public final Instant startedAt()
The epoch time when Amazon Machine Learning marked the
MLModelasINPROGRESS.StartedAtisn't available if theMLModelis in thePENDINGstate.- Returns:
- The epoch time when Amazon Machine Learning marked the
MLModelasINPROGRESS.StartedAtisn't available if theMLModelis in thePENDINGstate.
-
recipe
public final String recipe()
The recipe to use when training the
MLModel. TheRecipeprovides 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:
- The recipe to use when training the
MLModel. TheRecipeprovides 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.
-
schema
public final String 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.
- Returns:
- The schema used by all of the data files referenced by the
DataSource.Note: This parameter is provided as part of the verbose format.
-
toBuilder
public GetMlModelResponse.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<GetMlModelResponse.Builder,GetMlModelResponse>- Specified by:
toBuilderin classAwsResponse
-
builder
public static GetMlModelResponse.Builder builder()
-
serializableBuilderClass
public static Class<? extends GetMlModelResponse.Builder> serializableBuilderClass()
-
hashCode
public final int hashCode()
- Overrides:
hashCodein classAwsResponse
-
equals
public final boolean equals(Object obj)
- Overrides:
equalsin classAwsResponse
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
getValueForField
public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
- Overrides:
getValueForFieldin classSdkResponse
-
-