Interface TrainingJob.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<TrainingJob.Builder,
,TrainingJob> SdkBuilder<TrainingJob.Builder,
,TrainingJob> SdkPojo
- Enclosing class:
TrainingJob
-
Method Summary
Modifier and TypeMethodDescriptiondefault TrainingJob.Builder
algorithmSpecification
(Consumer<AlgorithmSpecification.Builder> algorithmSpecification) Information about the algorithm used for training, and algorithm metadata.algorithmSpecification
(AlgorithmSpecification algorithmSpecification) Information about the algorithm used for training, and algorithm metadata.autoMLJobArn
(String autoMLJobArn) The Amazon Resource Name (ARN) of the job.billableTimeInSeconds
(Integer billableTimeInSeconds) The billable time in seconds.default TrainingJob.Builder
checkpointConfig
(Consumer<CheckpointConfig.Builder> checkpointConfig) Sets the value of the CheckpointConfig property for this object.checkpointConfig
(CheckpointConfig checkpointConfig) Sets the value of the CheckpointConfig property for this object.creationTime
(Instant creationTime) A timestamp that indicates when the training job was created.default TrainingJob.Builder
debugHookConfig
(Consumer<DebugHookConfig.Builder> debugHookConfig) Sets the value of the DebugHookConfig property for this object.debugHookConfig
(DebugHookConfig debugHookConfig) Sets the value of the DebugHookConfig property for this object.debugRuleConfigurations
(Collection<DebugRuleConfiguration> debugRuleConfigurations) Information about the debug rule configuration.debugRuleConfigurations
(Consumer<DebugRuleConfiguration.Builder>... debugRuleConfigurations) Information about the debug rule configuration.debugRuleConfigurations
(DebugRuleConfiguration... debugRuleConfigurations) Information about the debug rule configuration.debugRuleEvaluationStatuses
(Collection<DebugRuleEvaluationStatus> debugRuleEvaluationStatuses) Information about the evaluation status of the rules for the training job.debugRuleEvaluationStatuses
(Consumer<DebugRuleEvaluationStatus.Builder>... debugRuleEvaluationStatuses) Information about the evaluation status of the rules for the training job.debugRuleEvaluationStatuses
(DebugRuleEvaluationStatus... debugRuleEvaluationStatuses) Information about the evaluation status of the rules for the training job.enableInterContainerTrafficEncryption
(Boolean enableInterContainerTrafficEncryption) To encrypt all communications between ML compute instances in distributed training, chooseTrue
.enableManagedSpotTraining
(Boolean enableManagedSpotTraining) When true, enables managed spot training using Amazon EC2 Spot instances to run training jobs instead of on-demand instances.enableNetworkIsolation
(Boolean enableNetworkIsolation) If theTrainingJob
was created with network isolation, the value is set totrue
.environment
(Map<String, String> environment) The environment variables to set in the Docker container.default TrainingJob.Builder
experimentConfig
(Consumer<ExperimentConfig.Builder> experimentConfig) Sets the value of the ExperimentConfig property for this object.experimentConfig
(ExperimentConfig experimentConfig) Sets the value of the ExperimentConfig property for this object.failureReason
(String failureReason) If the training job failed, the reason it failed.finalMetricDataList
(Collection<MetricData> finalMetricDataList) A list of final metric values that are set when the training job completes.finalMetricDataList
(Consumer<MetricData.Builder>... finalMetricDataList) A list of final metric values that are set when the training job completes.finalMetricDataList
(MetricData... finalMetricDataList) A list of final metric values that are set when the training job completes.hyperParameters
(Map<String, String> hyperParameters) Algorithm-specific parameters.inputDataConfig
(Collection<Channel> inputDataConfig) An array ofChannel
objects that describes each data input channel.inputDataConfig
(Consumer<Channel.Builder>... inputDataConfig) An array ofChannel
objects that describes each data input channel.inputDataConfig
(Channel... inputDataConfig) An array ofChannel
objects that describes each data input channel.labelingJobArn
(String labelingJobArn) The Amazon Resource Name (ARN) of the labeling job.lastModifiedTime
(Instant lastModifiedTime) A timestamp that indicates when the status of the training job was last modified.default TrainingJob.Builder
modelArtifacts
(Consumer<ModelArtifacts.Builder> modelArtifacts) Information about the Amazon S3 location that is configured for storing model artifacts.modelArtifacts
(ModelArtifacts modelArtifacts) Information about the Amazon S3 location that is configured for storing model artifacts.default TrainingJob.Builder
outputDataConfig
(Consumer<OutputDataConfig.Builder> outputDataConfig) The S3 path where model artifacts that you configured when creating the job are stored.outputDataConfig
(OutputDataConfig outputDataConfig) The S3 path where model artifacts that you configured when creating the job are stored.default TrainingJob.Builder
profilerConfig
(Consumer<ProfilerConfig.Builder> profilerConfig) Sets the value of the ProfilerConfig property for this object.profilerConfig
(ProfilerConfig profilerConfig) Sets the value of the ProfilerConfig property for this object.default TrainingJob.Builder
resourceConfig
(Consumer<ResourceConfig.Builder> resourceConfig) Resources, including ML compute instances and ML storage volumes, that are configured for model training.resourceConfig
(ResourceConfig resourceConfig) Resources, including ML compute instances and ML storage volumes, that are configured for model training.default TrainingJob.Builder
retryStrategy
(Consumer<RetryStrategy.Builder> retryStrategy) The number of times to retry the job when the job fails due to anInternalServerError
.retryStrategy
(RetryStrategy retryStrategy) The number of times to retry the job when the job fails due to anInternalServerError
.The Amazon Web Services Identity and Access Management (IAM) role configured for the training job.secondaryStatus
(String secondaryStatus) Provides detailed information about the state of the training job.secondaryStatus
(SecondaryStatus secondaryStatus) Provides detailed information about the state of the training job.secondaryStatusTransitions
(Collection<SecondaryStatusTransition> secondaryStatusTransitions) A history of all of the secondary statuses that the training job has transitioned through.secondaryStatusTransitions
(Consumer<SecondaryStatusTransition.Builder>... secondaryStatusTransitions) A history of all of the secondary statuses that the training job has transitioned through.secondaryStatusTransitions
(SecondaryStatusTransition... secondaryStatusTransitions) A history of all of the secondary statuses that the training job has transitioned through.default TrainingJob.Builder
stoppingCondition
(Consumer<StoppingCondition.Builder> stoppingCondition) Specifies a limit to how long a model training job can run.stoppingCondition
(StoppingCondition stoppingCondition) Specifies a limit to how long a model training job can run.tags
(Collection<Tag> tags) An array of key-value pairs.tags
(Consumer<Tag.Builder>... tags) An array of key-value pairs.An array of key-value pairs.default TrainingJob.Builder
tensorBoardOutputConfig
(Consumer<TensorBoardOutputConfig.Builder> tensorBoardOutputConfig) Sets the value of the TensorBoardOutputConfig property for this object.tensorBoardOutputConfig
(TensorBoardOutputConfig tensorBoardOutputConfig) Sets the value of the TensorBoardOutputConfig property for this object.trainingEndTime
(Instant trainingEndTime) Indicates the time when the training job ends on training instances.trainingJobArn
(String trainingJobArn) The Amazon Resource Name (ARN) of the training job.trainingJobName
(String trainingJobName) The name of the training job.trainingJobStatus
(String trainingJobStatus) The status of the training job.trainingJobStatus
(TrainingJobStatus trainingJobStatus) The status of the training job.trainingStartTime
(Instant trainingStartTime) Indicates the time when the training job starts on training instances.trainingTimeInSeconds
(Integer trainingTimeInSeconds) The training time in seconds.tuningJobArn
(String tuningJobArn) The Amazon Resource Name (ARN) of the associated hyperparameter tuning job if the training job was launched by a hyperparameter tuning job.default TrainingJob.Builder
vpcConfig
(Consumer<VpcConfig.Builder> vpcConfig) A VpcConfig object that specifies the VPC that this training job has access to.A VpcConfig object that specifies the VPC that this training job has access to.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
trainingJobName
The name of the training job.
- Parameters:
trainingJobName
- The name of the training job.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
trainingJobArn
The Amazon Resource Name (ARN) of the training job.
- Parameters:
trainingJobArn
- The Amazon Resource Name (ARN) of the training job.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tuningJobArn
The Amazon Resource Name (ARN) of the associated hyperparameter tuning job if the training job was launched by a hyperparameter tuning job.
- Parameters:
tuningJobArn
- The Amazon Resource Name (ARN) of the associated hyperparameter tuning job if the training job was launched by a hyperparameter tuning job.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
labelingJobArn
The Amazon Resource Name (ARN) of the labeling job.
- Parameters:
labelingJobArn
- The Amazon Resource Name (ARN) of the labeling job.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
autoMLJobArn
The Amazon Resource Name (ARN) of the job.
- Parameters:
autoMLJobArn
- The Amazon Resource Name (ARN) of the job.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
modelArtifacts
Information about the Amazon S3 location that is configured for storing model artifacts.
- Parameters:
modelArtifacts
- Information about the Amazon S3 location that is configured for storing model artifacts.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
modelArtifacts
Information about the Amazon S3 location that is configured for storing model artifacts.
This is a convenience method that creates an instance of theModelArtifacts.Builder
avoiding the need to create one manually viaModelArtifacts.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tomodelArtifacts(ModelArtifacts)
.- Parameters:
modelArtifacts
- a consumer that will call methods onModelArtifacts.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
trainingJobStatus
The status of the training job.
Training job statuses are:
-
InProgress
- The training is in progress. -
Completed
- The training job has completed. -
Failed
- The training job has failed. To see the reason for the failure, see theFailureReason
field in the response to aDescribeTrainingJobResponse
call. -
Stopping
- The training job is stopping. -
Stopped
- The training job has stopped.
For more detailed information, see
SecondaryStatus
.- Parameters:
trainingJobStatus
- The status of the training job.Training job statuses are:
-
InProgress
- The training is in progress. -
Completed
- The training job has completed. -
Failed
- The training job has failed. To see the reason for the failure, see theFailureReason
field in the response to aDescribeTrainingJobResponse
call. -
Stopping
- The training job is stopping. -
Stopped
- The training job has stopped.
For more detailed information, see
SecondaryStatus
.-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
trainingJobStatus
The status of the training job.
Training job statuses are:
-
InProgress
- The training is in progress. -
Completed
- The training job has completed. -
Failed
- The training job has failed. To see the reason for the failure, see theFailureReason
field in the response to aDescribeTrainingJobResponse
call. -
Stopping
- The training job is stopping. -
Stopped
- The training job has stopped.
For more detailed information, see
SecondaryStatus
.- Parameters:
trainingJobStatus
- The status of the training job.Training job statuses are:
-
InProgress
- The training is in progress. -
Completed
- The training job has completed. -
Failed
- The training job has failed. To see the reason for the failure, see theFailureReason
field in the response to aDescribeTrainingJobResponse
call. -
Stopping
- The training job is stopping. -
Stopped
- The training job has stopped.
For more detailed information, see
SecondaryStatus
.-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
secondaryStatus
Provides detailed information about the state of the training job. For detailed information about the secondary status of the training job, see
StatusMessage
under SecondaryStatusTransition.SageMaker provides primary statuses and secondary statuses that apply to each of them:
- InProgress
-
-
Starting
- Starting the training job. -
Downloading
- An optional stage for algorithms that supportFile
training input mode. It indicates that data is being downloaded to the ML storage volumes. -
Training
- Training is in progress. -
Uploading
- Training is complete and the model artifacts are being uploaded to the S3 location.
-
- Completed
-
-
Completed
- The training job has completed.
-
- Failed
-
-
Failed
- The training job has failed. The reason for the failure is returned in theFailureReason
field ofDescribeTrainingJobResponse
.
-
- Stopped
-
-
MaxRuntimeExceeded
- The job stopped because it exceeded the maximum allowed runtime. -
Stopped
- The training job has stopped.
-
- Stopping
-
-
Stopping
- Stopping the training job.
-
Valid values for
SecondaryStatus
are subject to change.We no longer support the following secondary statuses:
-
LaunchingMLInstances
-
PreparingTrainingStack
-
DownloadingTrainingImage
- Parameters:
secondaryStatus
- Provides detailed information about the state of the training job. For detailed information about the secondary status of the training job, seeStatusMessage
under SecondaryStatusTransition.SageMaker provides primary statuses and secondary statuses that apply to each of them:
- InProgress
-
-
Starting
- Starting the training job. -
Downloading
- An optional stage for algorithms that supportFile
training input mode. It indicates that data is being downloaded to the ML storage volumes. -
Training
- Training is in progress. -
Uploading
- Training is complete and the model artifacts are being uploaded to the S3 location.
-
- Completed
-
-
Completed
- The training job has completed.
-
- Failed
-
-
Failed
- The training job has failed. The reason for the failure is returned in theFailureReason
field ofDescribeTrainingJobResponse
.
-
- Stopped
-
-
MaxRuntimeExceeded
- The job stopped because it exceeded the maximum allowed runtime. -
Stopped
- The training job has stopped.
-
- Stopping
-
-
Stopping
- Stopping the training job.
-
Valid values for
SecondaryStatus
are subject to change.We no longer support the following secondary statuses:
-
LaunchingMLInstances
-
PreparingTrainingStack
-
DownloadingTrainingImage
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
secondaryStatus
Provides detailed information about the state of the training job. For detailed information about the secondary status of the training job, see
StatusMessage
under SecondaryStatusTransition.SageMaker provides primary statuses and secondary statuses that apply to each of them:
- InProgress
-
-
Starting
- Starting the training job. -
Downloading
- An optional stage for algorithms that supportFile
training input mode. It indicates that data is being downloaded to the ML storage volumes. -
Training
- Training is in progress. -
Uploading
- Training is complete and the model artifacts are being uploaded to the S3 location.
-
- Completed
-
-
Completed
- The training job has completed.
-
- Failed
-
-
Failed
- The training job has failed. The reason for the failure is returned in theFailureReason
field ofDescribeTrainingJobResponse
.
-
- Stopped
-
-
MaxRuntimeExceeded
- The job stopped because it exceeded the maximum allowed runtime. -
Stopped
- The training job has stopped.
-
- Stopping
-
-
Stopping
- Stopping the training job.
-
Valid values for
SecondaryStatus
are subject to change.We no longer support the following secondary statuses:
-
LaunchingMLInstances
-
PreparingTrainingStack
-
DownloadingTrainingImage
- Parameters:
secondaryStatus
- Provides detailed information about the state of the training job. For detailed information about the secondary status of the training job, seeStatusMessage
under SecondaryStatusTransition.SageMaker provides primary statuses and secondary statuses that apply to each of them:
- InProgress
-
-
Starting
- Starting the training job. -
Downloading
- An optional stage for algorithms that supportFile
training input mode. It indicates that data is being downloaded to the ML storage volumes. -
Training
- Training is in progress. -
Uploading
- Training is complete and the model artifacts are being uploaded to the S3 location.
-
- Completed
-
-
Completed
- The training job has completed.
-
- Failed
-
-
Failed
- The training job has failed. The reason for the failure is returned in theFailureReason
field ofDescribeTrainingJobResponse
.
-
- Stopped
-
-
MaxRuntimeExceeded
- The job stopped because it exceeded the maximum allowed runtime. -
Stopped
- The training job has stopped.
-
- Stopping
-
-
Stopping
- Stopping the training job.
-
Valid values for
SecondaryStatus
are subject to change.We no longer support the following secondary statuses:
-
LaunchingMLInstances
-
PreparingTrainingStack
-
DownloadingTrainingImage
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
failureReason
If the training job failed, the reason it failed.
- Parameters:
failureReason
- If the training job failed, the reason it failed.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
hyperParameters
Algorithm-specific parameters.
- Parameters:
hyperParameters
- Algorithm-specific parameters.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
algorithmSpecification
Information about the algorithm used for training, and algorithm metadata.
- Parameters:
algorithmSpecification
- Information about the algorithm used for training, and algorithm metadata.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
algorithmSpecification
default TrainingJob.Builder algorithmSpecification(Consumer<AlgorithmSpecification.Builder> algorithmSpecification) Information about the algorithm used for training, and algorithm metadata.
This is a convenience method that creates an instance of theAlgorithmSpecification.Builder
avoiding the need to create one manually viaAlgorithmSpecification.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toalgorithmSpecification(AlgorithmSpecification)
.- Parameters:
algorithmSpecification
- a consumer that will call methods onAlgorithmSpecification.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
roleArn
The Amazon Web Services Identity and Access Management (IAM) role configured for the training job.
- Parameters:
roleArn
- The Amazon Web Services Identity and Access Management (IAM) role configured for the training job.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
inputDataConfig
An array of
Channel
objects that describes each data input channel.Your input must be in the same Amazon Web Services region as your training job.
- Parameters:
inputDataConfig
- An array ofChannel
objects that describes each data input channel.Your input must be in the same Amazon Web Services region as your training job.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
inputDataConfig
An array of
Channel
objects that describes each data input channel.Your input must be in the same Amazon Web Services region as your training job.
- Parameters:
inputDataConfig
- An array ofChannel
objects that describes each data input channel.Your input must be in the same Amazon Web Services region as your training job.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
inputDataConfig
An array of
Channel
objects that describes each data input channel.Your input must be in the same Amazon Web Services region as your training job.
This is a convenience method that creates an instance of theChannel.Builder
avoiding the need to create one manually viaChannel.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toinputDataConfig(List<Channel>)
.- Parameters:
inputDataConfig
- a consumer that will call methods onChannel.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
outputDataConfig
The S3 path where model artifacts that you configured when creating the job are stored. SageMaker creates subfolders for model artifacts.
- Parameters:
outputDataConfig
- The S3 path where model artifacts that you configured when creating the job are stored. SageMaker creates subfolders for model artifacts.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
outputDataConfig
The S3 path where model artifacts that you configured when creating the job are stored. SageMaker creates subfolders for model artifacts.
This is a convenience method that creates an instance of theOutputDataConfig.Builder
avoiding the need to create one manually viaOutputDataConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tooutputDataConfig(OutputDataConfig)
.- Parameters:
outputDataConfig
- a consumer that will call methods onOutputDataConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
resourceConfig
Resources, including ML compute instances and ML storage volumes, that are configured for model training.
- Parameters:
resourceConfig
- Resources, including ML compute instances and ML storage volumes, that are configured for model training.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
resourceConfig
Resources, including ML compute instances and ML storage volumes, that are configured for model training.
This is a convenience method that creates an instance of theResourceConfig.Builder
avoiding the need to create one manually viaResourceConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toresourceConfig(ResourceConfig)
.- Parameters:
resourceConfig
- a consumer that will call methods onResourceConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
vpcConfig
A VpcConfig object that specifies the VPC that this training job has access to. For more information, see Protect Training Jobs by Using an Amazon Virtual Private Cloud.
- Parameters:
vpcConfig
- A VpcConfig object that specifies the VPC that this training job has access to. For more information, see Protect Training Jobs by Using an Amazon Virtual Private Cloud.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
vpcConfig
A VpcConfig object that specifies the VPC that this training job has access to. For more information, see Protect Training Jobs by Using an Amazon Virtual Private Cloud.
This is a convenience method that creates an instance of theVpcConfig.Builder
avoiding the need to create one manually viaVpcConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tovpcConfig(VpcConfig)
.- Parameters:
vpcConfig
- a consumer that will call methods onVpcConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
stoppingCondition
Specifies a limit to how long a model training job can run. It also specifies how long a managed Spot training job has to complete. When the job reaches the time limit, SageMaker ends the training job. Use this API to cap model training costs.
To stop a job, SageMaker sends the algorithm the
SIGTERM
signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.- Parameters:
stoppingCondition
- Specifies a limit to how long a model training job can run. It also specifies how long a managed Spot training job has to complete. When the job reaches the time limit, SageMaker ends the training job. Use this API to cap model training costs.To stop a job, SageMaker sends the algorithm the
SIGTERM
signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
stoppingCondition
default TrainingJob.Builder stoppingCondition(Consumer<StoppingCondition.Builder> stoppingCondition) Specifies a limit to how long a model training job can run. It also specifies how long a managed Spot training job has to complete. When the job reaches the time limit, SageMaker ends the training job. Use this API to cap model training costs.
To stop a job, SageMaker sends the algorithm the
This is a convenience method that creates an instance of theSIGTERM
signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.StoppingCondition.Builder
avoiding the need to create one manually viaStoppingCondition.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tostoppingCondition(StoppingCondition)
.- Parameters:
stoppingCondition
- a consumer that will call methods onStoppingCondition.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
creationTime
A timestamp that indicates when the training job was created.
- Parameters:
creationTime
- A timestamp that indicates when the training job was created.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
trainingStartTime
Indicates the time when the training job starts on training instances. You are billed for the time interval between this time and the value of
TrainingEndTime
. The start time in CloudWatch Logs might be later than this time. The difference is due to the time it takes to download the training data and to the size of the training container.- Parameters:
trainingStartTime
- Indicates the time when the training job starts on training instances. You are billed for the time interval between this time and the value ofTrainingEndTime
. The start time in CloudWatch Logs might be later than this time. The difference is due to the time it takes to download the training data and to the size of the training container.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
trainingEndTime
Indicates the time when the training job ends on training instances. You are billed for the time interval between the value of
TrainingStartTime
and this time. For successful jobs and stopped jobs, this is the time after model artifacts are uploaded. For failed jobs, this is the time when SageMaker detects a job failure.- Parameters:
trainingEndTime
- Indicates the time when the training job ends on training instances. You are billed for the time interval between the value ofTrainingStartTime
and this time. For successful jobs and stopped jobs, this is the time after model artifacts are uploaded. For failed jobs, this is the time when SageMaker detects a job failure.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
lastModifiedTime
A timestamp that indicates when the status of the training job was last modified.
- Parameters:
lastModifiedTime
- A timestamp that indicates when the status of the training job was last modified.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
secondaryStatusTransitions
TrainingJob.Builder secondaryStatusTransitions(Collection<SecondaryStatusTransition> secondaryStatusTransitions) A history of all of the secondary statuses that the training job has transitioned through.
- Parameters:
secondaryStatusTransitions
- A history of all of the secondary statuses that the training job has transitioned through.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
secondaryStatusTransitions
TrainingJob.Builder secondaryStatusTransitions(SecondaryStatusTransition... secondaryStatusTransitions) A history of all of the secondary statuses that the training job has transitioned through.
- Parameters:
secondaryStatusTransitions
- A history of all of the secondary statuses that the training job has transitioned through.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
secondaryStatusTransitions
TrainingJob.Builder secondaryStatusTransitions(Consumer<SecondaryStatusTransition.Builder>... secondaryStatusTransitions) A history of all of the secondary statuses that the training job has transitioned through.
This is a convenience method that creates an instance of theSecondaryStatusTransition.Builder
avoiding the need to create one manually viaSecondaryStatusTransition.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tosecondaryStatusTransitions(List<SecondaryStatusTransition>)
.- Parameters:
secondaryStatusTransitions
- a consumer that will call methods onSecondaryStatusTransition.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
finalMetricDataList
A list of final metric values that are set when the training job completes. Used only if the training job was configured to use metrics.
- Parameters:
finalMetricDataList
- A list of final metric values that are set when the training job completes. Used only if the training job was configured to use metrics.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
finalMetricDataList
A list of final metric values that are set when the training job completes. Used only if the training job was configured to use metrics.
- Parameters:
finalMetricDataList
- A list of final metric values that are set when the training job completes. Used only if the training job was configured to use metrics.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
finalMetricDataList
A list of final metric values that are set when the training job completes. Used only if the training job was configured to use metrics.
This is a convenience method that creates an instance of theMetricData.Builder
avoiding the need to create one manually viaMetricData.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tofinalMetricDataList(List<MetricData>)
.- Parameters:
finalMetricDataList
- a consumer that will call methods onMetricData.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
enableNetworkIsolation
If the
TrainingJob
was created with network isolation, the value is set totrue
. If network isolation is enabled, nodes can't communicate beyond the VPC they run in.- Parameters:
enableNetworkIsolation
- If theTrainingJob
was created with network isolation, the value is set totrue
. If network isolation is enabled, nodes can't communicate beyond the VPC they run in.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
enableInterContainerTrafficEncryption
TrainingJob.Builder enableInterContainerTrafficEncryption(Boolean enableInterContainerTrafficEncryption) To encrypt all communications between ML compute instances in distributed training, choose
True
. Encryption provides greater security for distributed training, but training might take longer. How long it takes depends on the amount of communication between compute instances, especially if you use a deep learning algorithm in distributed training.- Parameters:
enableInterContainerTrafficEncryption
- To encrypt all communications between ML compute instances in distributed training, chooseTrue
. Encryption provides greater security for distributed training, but training might take longer. How long it takes depends on the amount of communication between compute instances, especially if you use a deep learning algorithm in distributed training.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
enableManagedSpotTraining
When true, enables managed spot training using Amazon EC2 Spot instances to run training jobs instead of on-demand instances. For more information, see Managed Spot Training.
- Parameters:
enableManagedSpotTraining
- When true, enables managed spot training using Amazon EC2 Spot instances to run training jobs instead of on-demand instances. For more information, see Managed Spot Training.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
checkpointConfig
Sets the value of the CheckpointConfig property for this object.- Parameters:
checkpointConfig
- The new value for the CheckpointConfig property for this object.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
checkpointConfig
Sets the value of the CheckpointConfig property for this object. This is a convenience method that creates an instance of theCheckpointConfig.Builder
avoiding the need to create one manually viaCheckpointConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tocheckpointConfig(CheckpointConfig)
.- Parameters:
checkpointConfig
- a consumer that will call methods onCheckpointConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
trainingTimeInSeconds
The training time in seconds.
- Parameters:
trainingTimeInSeconds
- The training time in seconds.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
billableTimeInSeconds
The billable time in seconds.
- Parameters:
billableTimeInSeconds
- The billable time in seconds.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
debugHookConfig
Sets the value of the DebugHookConfig property for this object.- Parameters:
debugHookConfig
- The new value for the DebugHookConfig property for this object.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
debugHookConfig
Sets the value of the DebugHookConfig property for this object. This is a convenience method that creates an instance of theDebugHookConfig.Builder
avoiding the need to create one manually viaDebugHookConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed todebugHookConfig(DebugHookConfig)
.- Parameters:
debugHookConfig
- a consumer that will call methods onDebugHookConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
experimentConfig
Sets the value of the ExperimentConfig property for this object.- Parameters:
experimentConfig
- The new value for the ExperimentConfig property for this object.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
experimentConfig
Sets the value of the ExperimentConfig property for this object. This is a convenience method that creates an instance of theExperimentConfig.Builder
avoiding the need to create one manually viaExperimentConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toexperimentConfig(ExperimentConfig)
.- Parameters:
experimentConfig
- a consumer that will call methods onExperimentConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
debugRuleConfigurations
TrainingJob.Builder debugRuleConfigurations(Collection<DebugRuleConfiguration> debugRuleConfigurations) Information about the debug rule configuration.
- Parameters:
debugRuleConfigurations
- Information about the debug rule configuration.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
debugRuleConfigurations
Information about the debug rule configuration.
- Parameters:
debugRuleConfigurations
- Information about the debug rule configuration.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
debugRuleConfigurations
TrainingJob.Builder debugRuleConfigurations(Consumer<DebugRuleConfiguration.Builder>... debugRuleConfigurations) Information about the debug rule configuration.
This is a convenience method that creates an instance of theDebugRuleConfiguration.Builder
avoiding the need to create one manually viaDebugRuleConfiguration.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed todebugRuleConfigurations(List<DebugRuleConfiguration>)
.- Parameters:
debugRuleConfigurations
- a consumer that will call methods onDebugRuleConfiguration.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
tensorBoardOutputConfig
Sets the value of the TensorBoardOutputConfig property for this object.- Parameters:
tensorBoardOutputConfig
- The new value for the TensorBoardOutputConfig property for this object.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tensorBoardOutputConfig
default TrainingJob.Builder tensorBoardOutputConfig(Consumer<TensorBoardOutputConfig.Builder> tensorBoardOutputConfig) Sets the value of the TensorBoardOutputConfig property for this object. This is a convenience method that creates an instance of theTensorBoardOutputConfig.Builder
avoiding the need to create one manually viaTensorBoardOutputConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed totensorBoardOutputConfig(TensorBoardOutputConfig)
.- Parameters:
tensorBoardOutputConfig
- a consumer that will call methods onTensorBoardOutputConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
debugRuleEvaluationStatuses
TrainingJob.Builder debugRuleEvaluationStatuses(Collection<DebugRuleEvaluationStatus> debugRuleEvaluationStatuses) Information about the evaluation status of the rules for the training job.
- Parameters:
debugRuleEvaluationStatuses
- Information about the evaluation status of the rules for the training job.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
debugRuleEvaluationStatuses
TrainingJob.Builder debugRuleEvaluationStatuses(DebugRuleEvaluationStatus... debugRuleEvaluationStatuses) Information about the evaluation status of the rules for the training job.
- Parameters:
debugRuleEvaluationStatuses
- Information about the evaluation status of the rules for the training job.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
debugRuleEvaluationStatuses
TrainingJob.Builder debugRuleEvaluationStatuses(Consumer<DebugRuleEvaluationStatus.Builder>... debugRuleEvaluationStatuses) Information about the evaluation status of the rules for the training job.
This is a convenience method that creates an instance of theDebugRuleEvaluationStatus.Builder
avoiding the need to create one manually viaDebugRuleEvaluationStatus.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed todebugRuleEvaluationStatuses(List<DebugRuleEvaluationStatus>)
.- Parameters:
debugRuleEvaluationStatuses
- a consumer that will call methods onDebugRuleEvaluationStatus.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
profilerConfig
Sets the value of the ProfilerConfig property for this object.- Parameters:
profilerConfig
- The new value for the ProfilerConfig property for this object.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
profilerConfig
Sets the value of the ProfilerConfig property for this object. This is a convenience method that creates an instance of theProfilerConfig.Builder
avoiding the need to create one manually viaProfilerConfig.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toprofilerConfig(ProfilerConfig)
.- Parameters:
profilerConfig
- a consumer that will call methods onProfilerConfig.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
environment
The environment variables to set in the Docker container.
- Parameters:
environment
- The environment variables to set in the Docker container.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
retryStrategy
The number of times to retry the job when the job fails due to an
InternalServerError
.- Parameters:
retryStrategy
- The number of times to retry the job when the job fails due to anInternalServerError
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
retryStrategy
The number of times to retry the job when the job fails due to an
This is a convenience method that creates an instance of theInternalServerError
.RetryStrategy.Builder
avoiding the need to create one manually viaRetryStrategy.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toretryStrategy(RetryStrategy)
.- Parameters:
retryStrategy
- a consumer that will call methods onRetryStrategy.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
tags
An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging Amazon Web Services Resources.
- Parameters:
tags
- An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging Amazon Web Services Resources.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging Amazon Web Services Resources.
- Parameters:
tags
- An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging Amazon Web Services Resources.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging Amazon Web Services Resources.
This is a convenience method that creates an instance of theTag.Builder
avoiding the need to create one manually viaTag.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed totags(List<Tag>)
.- Parameters:
tags
- a consumer that will call methods onTag.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-