StoppingCondition
Specifies a limit to how long a model training job or model compilation 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 or compilation job. Use this API to cap model training costs.
To stop a training 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.
The training algorithms provided by SageMaker automatically save the intermediate results
of a model training job when possible. This attempt to save artifacts is only a best
effort case as model might not be in a state from which it can be saved. For example, if
training has just started, the model might not be ready to save. When saved, this
intermediate data is a valid model artifact. You can use it to create a model with
CreateModel.
Note
The Neural Topic Model (NTM) currently does not support saving intermediate model artifacts. When training NTMs, make sure that the maximum runtime is sufficient for the training job to complete.
Contents
- MaxPendingTimeInSeconds
-
The maximum length of time, in seconds, that a training or compilation job can be pending before it is stopped.
Type: Integer
Valid Range: Minimum value of 7200. Maximum value of 2419200.
Required: No
- MaxRuntimeInSeconds
-
The maximum length of time, in seconds, that a training or compilation job can run before it is stopped.
For compilation jobs, if the job does not complete during this time, a
TimeOuterror is generated. We recommend starting with 900 seconds and increasing as necessary based on your model.For all other jobs, if the job does not complete during this time, SageMaker ends the job. When
RetryStrategyis specified in the job request,MaxRuntimeInSecondsspecifies the maximum time for all of the attempts in total, not each individual attempt. The default value is 1 day. The maximum value is 28 days.The maximum time that a
TrainingJobcan run in total, including any time spent publishing metrics or archiving and uploading models after it has been stopped, is 30 days.Type: Integer
Valid Range: Minimum value of 1.
Required: No
- MaxWaitTimeInSeconds
-
The maximum length of time, in seconds, that a managed Spot training job has to complete. It is the amount of time spent waiting for Spot capacity plus the amount of time the job can run. It must be equal to or greater than
MaxRuntimeInSeconds. If the job does not complete during this time, SageMaker ends the job.When
RetryStrategyis specified in the job request,MaxWaitTimeInSecondsspecifies the maximum time for all of the attempts in total, not each individual attempt.Type: Integer
Valid Range: Minimum value of 1.
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
