Class DescribePredictorResponse
- All Implemented Interfaces:
SdkPojo
,ToCopyableBuilder<DescribePredictorResponse.Builder,
DescribePredictorResponse>
-
Nested Class Summary
-
Method Summary
Modifier and TypeMethodDescriptionfinal String
The Amazon Resource Name (ARN) of the algorithm used for model training.WhenPerformAutoML
is specified, the ARN of the chosen algorithm.final AutoMLOverrideStrategy
final String
builder()
final Instant
When the model training task was created.An array of the ARNs of the dataset import jobs used to import training data for the predictor.final EncryptionConfig
An Key Management Service (KMS) key and the Identity and Access Management (IAM) role that Amazon Forecast can assume to access the key.final boolean
final boolean
equalsBySdkFields
(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final Long
The estimated time remaining in minutes for the predictor training job to complete.final EvaluationParameters
Used to override the default evaluation parameters of the specified algorithm.final FeaturizationConfig
The featurization configuration.final Integer
The number of time-steps of the forecast.The forecast types used during predictor training.final <T> Optional
<T> getValueForField
(String fieldName, Class<T> clazz) Used to retrieve the value of a field from any class that extendsSdkResponse
.final boolean
For responses, this returns true if the service returned a value for the AutoMLAlgorithmArns property.final boolean
For responses, this returns true if the service returned a value for the DatasetImportJobArns property.final boolean
For responses, this returns true if the service returned a value for the ForecastTypes property.final int
hashCode()
final boolean
For responses, this returns true if the service returned a value for the TrainingParameters property.The hyperparameter override values for the algorithm.final InputDataConfig
Describes the dataset group that contains the data to use to train the predictor.final Boolean
Whether the predictor was created with CreateAutoPredictor.final Instant
The last time the resource was modified.final String
message()
If an error occurred, an informational message about the error.final OptimizationMetric
The accuracy metric used to optimize the predictor.final String
The accuracy metric used to optimize the predictor.final Boolean
Whether the predictor is set to perform AutoML.final Boolean
Whether the predictor is set to perform hyperparameter optimization (HPO).final String
The ARN of the predictor.Details on the the status and results of the backtests performed to evaluate the accuracy of the predictor.final String
The name of the predictor.static Class
<? extends DescribePredictorResponse.Builder> final String
status()
The status of the predictor.Take this object and create a builder that contains all of the current property values of this object.final String
toString()
Returns a string representation of this object.The default training parameters or overrides selected during model training.Methods inherited from class software.amazon.awssdk.services.forecast.model.ForecastResponse
responseMetadata
Methods inherited from class software.amazon.awssdk.core.SdkResponse
sdkHttpResponse
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
predictorArn
The ARN of the predictor.
- Returns:
- The ARN of the predictor.
-
predictorName
The name of the predictor.
- Returns:
- The name of the predictor.
-
algorithmArn
The Amazon Resource Name (ARN) of the algorithm used for model training.
- Returns:
- The Amazon Resource Name (ARN) of the algorithm used for model training.
-
hasAutoMLAlgorithmArns
public final boolean hasAutoMLAlgorithmArns()For responses, this returns true if the service returned a value for the AutoMLAlgorithmArns 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. -
autoMLAlgorithmArns
When
PerformAutoML
is specified, the ARN of the chosen algorithm.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
hasAutoMLAlgorithmArns()
method.- Returns:
- When
PerformAutoML
is specified, the ARN of the chosen algorithm.
-
forecastHorizon
The number of time-steps of the forecast. The forecast horizon is also called the prediction length.
- Returns:
- The number of time-steps of the forecast. The forecast horizon is also called the prediction length.
-
hasForecastTypes
public final boolean hasForecastTypes()For responses, this returns true if the service returned a value for the ForecastTypes 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. -
forecastTypes
The forecast types used during predictor training. Default value is
["0.1","0.5","0.9"]
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
hasForecastTypes()
method.- Returns:
- The forecast types used during predictor training. Default value is
["0.1","0.5","0.9"]
-
performAutoML
Whether the predictor is set to perform AutoML.
- Returns:
- Whether the predictor is set to perform AutoML.
-
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.
If the service returns an enum value that is not available in the current SDK version,
autoMLOverrideStrategy
will returnAutoMLOverrideStrategy.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromautoMLOverrideStrategyAsString()
.- Returns:
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.
- See Also:
-
autoMLOverrideStrategyAsString
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.
If the service returns an enum value that is not available in the current SDK version,
autoMLOverrideStrategy
will returnAutoMLOverrideStrategy.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromautoMLOverrideStrategyAsString()
.- Returns:
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.
- See Also:
-
performHPO
Whether the predictor is set to perform hyperparameter optimization (HPO).
- Returns:
- Whether the predictor is set to perform hyperparameter optimization (HPO).
-
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
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.
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:
- 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.
-
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.
- Returns:
- 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.
-
hpoConfig
The hyperparameter override values for the algorithm.
- Returns:
- The hyperparameter override values for the algorithm.
-
inputDataConfig
Describes the dataset group that contains the data to use to train the predictor.
- Returns:
- Describes the dataset group that contains the data to use to train the predictor.
-
featurizationConfig
The featurization configuration.
- Returns:
- The featurization configuration.
-
encryptionConfig
An Key Management Service (KMS) key and the Identity and Access Management (IAM) role that Amazon Forecast can assume to access the key.
- Returns:
- An Key Management Service (KMS) key and the Identity and Access Management (IAM) role that Amazon Forecast can assume to access the key.
-
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.
- Returns:
- 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.
-
estimatedTimeRemainingInMinutes
The estimated time remaining in minutes for the predictor training job to complete.
- Returns:
- The estimated time remaining in minutes for the predictor training job to complete.
-
isAutoPredictor
Whether the predictor was created with CreateAutoPredictor.
- Returns:
- Whether the predictor was created with CreateAutoPredictor.
-
hasDatasetImportJobArns
public final boolean hasDatasetImportJobArns()For responses, this returns true if the service returned a value for the DatasetImportJobArns 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. -
datasetImportJobArns
An array of the ARNs of the dataset import jobs used to import training data for the predictor.
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
hasDatasetImportJobArns()
method.- Returns:
- An array of the ARNs of the dataset import jobs used to import training data for the predictor.
-
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 beACTIVE
before you can use the predictor to create a forecast.- Returns:
- 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 beACTIVE
before you can use the predictor to create a forecast. -
-
-
message
If an error occurred, an informational message about the error.
- Returns:
- If an error occurred, an informational message about the error.
-
creationTime
When the model training task was created.
- Returns:
- When the model training task was created.
-
lastModificationTime
The last time the resource was modified. The timestamp depends on the status of the job:
-
CREATE_PENDING
- TheCreationTime
. -
CREATE_IN_PROGRESS
- The current timestamp. -
CREATE_STOPPING
- The current timestamp. -
CREATE_STOPPED
- When the job stopped. -
ACTIVE
orCREATE_FAILED
- When the job finished or failed.
- Returns:
- The last time the resource was modified. The timestamp depends on the status of the job:
-
CREATE_PENDING
- TheCreationTime
. -
CREATE_IN_PROGRESS
- The current timestamp. -
CREATE_STOPPING
- The current timestamp. -
CREATE_STOPPED
- When the job stopped. -
ACTIVE
orCREATE_FAILED
- When the job finished or failed.
-
-
-
optimizationMetric
The accuracy metric used to optimize the predictor.
If the service returns an enum value that is not available in the current SDK version,
optimizationMetric
will returnOptimizationMetric.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromoptimizationMetricAsString()
.- Returns:
- The accuracy metric used to optimize the predictor.
- See Also:
-
optimizationMetricAsString
The accuracy metric used to optimize the predictor.
If the service returns an enum value that is not available in the current SDK version,
optimizationMetric
will returnOptimizationMetric.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromoptimizationMetricAsString()
.- Returns:
- The accuracy metric used to optimize the predictor.
- See Also:
-
toBuilder
Description copied from interface:ToCopyableBuilder
Take this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilder
in interfaceToCopyableBuilder<DescribePredictorResponse.Builder,
DescribePredictorResponse> - Specified by:
toBuilder
in classAwsResponse
- Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
public final int hashCode()- Overrides:
hashCode
in classAwsResponse
-
equals
- Overrides:
equals
in classAwsResponse
-
equalsBySdkFields
Description copied from interface:SdkPojo
Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojo
class, and is generated based on a service model.If an
SdkPojo
class does not have any inherited fields,equalsBySdkFields
andequals
are essentially the same.- Specified by:
equalsBySdkFields
in interfaceSdkPojo
- Parameters:
obj
- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
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
Description copied from class:SdkResponse
Used to retrieve the value of a field from any class that extendsSdkResponse
. The field name specified should match the member name from the corresponding service-2.json model specified in the codegen-resources folder for a given service. The class specifies what class to cast the returned value to. If the returned value is also a modeled class, theSdkResponse.getValueForField(String, Class)
method will again be available.- Overrides:
getValueForField
in classSdkResponse
- Parameters:
fieldName
- The name of the member to be retrieved.clazz
- The class to cast the returned object to.- Returns:
- Optional containing the casted return value
-
sdkFields
-