Interface StoppingCondition.Builder

All Superinterfaces:
Buildable, CopyableBuilder<StoppingCondition.Builder,StoppingCondition>, SdkBuilder<StoppingCondition.Builder,StoppingCondition>, SdkPojo
Enclosing class:
StoppingCondition
@Mutable @NotThreadSafe public static interface StoppingCondition.Builder extends SdkPojo, CopyableBuilder<StoppingCondition.Builder,StoppingCondition>

  • Method Details

    • maxRuntimeInSeconds

      StoppingCondition.Builder maxRuntimeInSeconds(Integer 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 TimeOut error 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 RetryStrategy is specified in the job request, MaxRuntimeInSeconds specifies 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 TrainingJob can run in total, including any time spent publishing metrics or archiving and uploading models after it has been stopped, is 30 days.

      Parameters:
      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 TimeOut error 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 RetryStrategy is specified in the job request, MaxRuntimeInSeconds specifies 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 TrainingJob can run in total, including any time spent publishing metrics or archiving and uploading models after it has been stopped, is 30 days.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • maxWaitTimeInSeconds

      StoppingCondition.Builder maxWaitTimeInSeconds(Integer 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 RetryStrategy is specified in the job request, MaxWaitTimeInSeconds specifies the maximum time for all of the attempts in total, not each individual attempt.

      Parameters:
      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 RetryStrategy is specified in the job request, MaxWaitTimeInSeconds specifies the maximum time for all of the attempts in total, not each individual attempt.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • maxPendingTimeInSeconds

      StoppingCondition.Builder maxPendingTimeInSeconds(Integer maxPendingTimeInSeconds)

      The maximum length of time, in seconds, that a training or compilation job can be pending before it is stopped.

      When working with training jobs that use capacity from training plans, not all Pending job states count against the MaxPendingTimeInSeconds limit. The following scenarios do not increment the MaxPendingTimeInSeconds counter:

      • The plan is in a Scheduled state: Jobs queued (in Pending status) before a plan's start date (waiting for scheduled start time)

      • Between capacity reservations: Jobs temporarily back to Pending status between two capacity reservation periods

      MaxPendingTimeInSeconds only increments when jobs are actively waiting for capacity in an Active plan.

      Parameters:
      maxPendingTimeInSeconds - The maximum length of time, in seconds, that a training or compilation job can be pending before it is stopped.

      When working with training jobs that use capacity from training plans, not all Pending job states count against the MaxPendingTimeInSeconds limit. The following scenarios do not increment the MaxPendingTimeInSeconds counter:

      • The plan is in a Scheduled state: Jobs queued (in Pending status) before a plan's start date (waiting for scheduled start time)

      • Between capacity reservations: Jobs temporarily back to Pending status between two capacity reservation periods

      MaxPendingTimeInSeconds only increments when jobs are actively waiting for capacity in an Active plan.

      Returns:
      Returns a reference to this object so that method calls can be chained together.