Package software.amazon.awscdk.services.batch

Class Reason

java.lang.Object
software.amazon.jsii.JsiiObject
software.amazon.awscdk.services.batch.Reason
All Implemented Interfaces:
software.amazon.jsii.JsiiSerializable
@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)", date="2025-10-24T13:34:32.196Z") @Stability(Stable) public class Reason extends software.amazon.jsii.JsiiObject
Common job exit reasons.

Example: 

 EcsJobDefinition jobDefn = EcsJobDefinition.Builder.create(this, "JobDefn")
         .container(EcsEc2ContainerDefinition.Builder.create(this, "containerDefn")
                 .image(ContainerImage.fromRegistry("public.ecr.aws/amazonlinux/amazonlinux:latest"))
                 .memory(Size.mebibytes(2048))
                 .cpu(256)
                 .build())
         .retryAttempts(5)
         .retryStrategies(List.of(RetryStrategy.of(Action.EXIT, Reason.CANNOT_PULL_CONTAINER)))
         .build();
 jobDefn.addRetryStrategy(RetryStrategy.of(Action.EXIT, Reason.SPOT_INSTANCE_RECLAIMED));
 jobDefn.addRetryStrategy(RetryStrategy.of(Action.EXIT, Reason.CANNOT_PULL_CONTAINER));
 jobDefn.addRetryStrategy(RetryStrategy.of(Action.EXIT, Reason.custom(CustomReason.builder()
         .onExitCode("40*")
         .onReason("some reason")
         .build())));

  • Nested Class Summary

    Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

    software.amazon.jsii.JsiiObject.InitializationMode

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final Reason
    CANNOT_PULL_CONTAINER
    Will only match if the Docker container could not be pulled.
    static final Reason
    NON_ZERO_EXIT_CODE
    Will match any non-zero exit code.
    static final Reason
    SPOT_INSTANCE_RECLAIMED
    Will only match if the Spot instance executing the job was reclaimed.

  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
     
    Reason()
     
    protected
    Reason(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
     
    protected
    Reason(software.amazon.jsii.JsiiObjectRef objRef)
     

  • Method Summary

    Modifier and Type
    Method
    Description
    static Reason
    custom(CustomReason customReasonProps)
    A custom Reason that can match on multiple conditions.

    Methods inherited from class software.amazon.jsii.JsiiObject

    jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface software.amazon.jsii.JsiiSerializable

    $jsii$toJson

  • Field Details

    • CANNOT_PULL_CONTAINER

      @Stability(Stable) public static final Reason CANNOT_PULL_CONTAINER
      Will only match if the Docker container could not be pulled.

    • NON_ZERO_EXIT_CODE

      @Stability(Stable) public static final Reason NON_ZERO_EXIT_CODE
      Will match any non-zero exit code.

    • SPOT_INSTANCE_RECLAIMED

      @Stability(Stable) public static final Reason SPOT_INSTANCE_RECLAIMED
      Will only match if the Spot instance executing the job was reclaimed.

  • Constructor Details

    • Reason

      protected Reason(software.amazon.jsii.JsiiObjectRef objRef)

    • Reason

      protected Reason(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • Reason

      @Stability(Stable) public Reason()

  • Method Details

    • custom

      @Stability(Stable) @NotNull public static Reason custom(@NotNull CustomReason customReasonProps)
      A custom Reason that can match on multiple conditions.

      Note that all specified conditions must be met for this reason to match.

      Parameters:
      customReasonProps - This parameter is required.