Class JobRun

java.lang.Object
software.amazon.awssdk.services.emrserverless.model.JobRun
All Implemented Interfaces:
Serializable, SdkPojo, ToCopyableBuilder<JobRun.Builder,JobRun>
@Generated("software.amazon.awssdk:codegen") public final class JobRun extends Object implements SdkPojo, Serializable, ToCopyableBuilder<JobRun.Builder,JobRun>

Information about a job run. A job run is a unit of work, such as a Spark JAR, Hive query, or SparkSQL query, that you submit to an Amazon EMR Serverless application.

See Also:

  • Method Details

    • applicationId

      public final String applicationId()

      The ID of the application the job is running on.

      Returns:
      The ID of the application the job is running on.

    • jobRunId

      public final String jobRunId()

      The ID of the job run.

      Returns:
      The ID of the job run.

    • name

      public final String name()

      The optional job run name. This doesn't have to be unique.

      Returns:
      The optional job run name. This doesn't have to be unique.

    • arn

      public final String arn()

      The execution role ARN of the job run.

      Returns:
      The execution role ARN of the job run.

    • createdBy

      public final String createdBy()

      The user who created the job run.

      Returns:
      The user who created the job run.

    • createdAt

      public final Instant createdAt()

      The date and time when the job run was created.

      Returns:
      The date and time when the job run was created.

    • updatedAt

      public final Instant updatedAt()

      The date and time when the job run was updated.

      Returns:
      The date and time when the job run was updated.

    • executionRole

      public final String executionRole()

      The execution role ARN of the job run.

      Returns:
      The execution role ARN of the job run.

    • executionIamPolicy

      public final JobRunExecutionIamPolicy executionIamPolicy()
      Returns the value of the ExecutionIamPolicy property for this object.
      Returns:
      The value of the ExecutionIamPolicy property for this object.

    • state

      public final JobRunState state()

      The state of the job run.

      If the service returns an enum value that is not available in the current SDK version, state will return JobRunState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from stateAsString().

      Returns:
      The state of the job run.
      See Also:

    • stateAsString

      public final String stateAsString()

      The state of the job run.

      If the service returns an enum value that is not available in the current SDK version, state will return JobRunState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from stateAsString().

      Returns:
      The state of the job run.
      See Also:

    • stateDetails

      public final String stateDetails()

      The state details of the job run.

      Returns:
      The state details of the job run.

    • releaseLabel

      public final String releaseLabel()

      The Amazon EMR release associated with the application your job is running on.

      Returns:
      The Amazon EMR release associated with the application your job is running on.

    • configurationOverrides

      public final ConfigurationOverrides configurationOverrides()

      The configuration settings that are used to override default configuration.

      Returns:
      The configuration settings that are used to override default configuration.

    • jobDriver

      public final JobDriver jobDriver()

      The job driver for the job run.

      Returns:
      The job driver for the job run.

    • hasTags

      public final boolean hasTags()
      For responses, this returns true if the service returned a value for the Tags property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

    • tags

      public final Map<String,String> tags()

      The tags assigned to the job run.

      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 hasTags() method.

      Returns:
      The tags assigned to the job run.

    • totalResourceUtilization

      public final TotalResourceUtilization totalResourceUtilization()

      The aggregate vCPU, memory, and storage resources used from the time the job starts to execute, until the time the job terminates, rounded up to the nearest second.

      Returns:
      The aggregate vCPU, memory, and storage resources used from the time the job starts to execute, until the time the job terminates, rounded up to the nearest second.

    • networkConfiguration

      public final NetworkConfiguration networkConfiguration()
      Returns the value of the NetworkConfiguration property for this object.
      Returns:
      The value of the NetworkConfiguration property for this object.

    • totalExecutionDurationSeconds

      public final Integer totalExecutionDurationSeconds()

      The job run total execution duration in seconds. This field is only available for job runs in a COMPLETED, FAILED, or CANCELLED state.

      Returns:
      The job run total execution duration in seconds. This field is only available for job runs in a COMPLETED, FAILED, or CANCELLED state.

    • executionTimeoutMinutes

      public final Long executionTimeoutMinutes()

      Returns the job run timeout value from the StartJobRun call. If no timeout was specified, then it returns the default timeout of 720 minutes.

      Returns:
      Returns the job run timeout value from the StartJobRun call. If no timeout was specified, then it returns the default timeout of 720 minutes.

    • billedResourceUtilization

      public final ResourceUtilization billedResourceUtilization()

      The aggregate vCPU, memory, and storage that Amazon Web Services has billed for the job run. The billed resources include a 1-minute minimum usage for workers, plus additional storage over 20 GB per worker. Note that billed resources do not include usage for idle pre-initialized workers.

      Returns:
      The aggregate vCPU, memory, and storage that Amazon Web Services has billed for the job run. The billed resources include a 1-minute minimum usage for workers, plus additional storage over 20 GB per worker. Note that billed resources do not include usage for idle pre-initialized workers.

    • mode

      public final JobRunMode mode()

      The mode of the job run.

      If the service returns an enum value that is not available in the current SDK version, mode will return JobRunMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from modeAsString().

      Returns:
      The mode of the job run.
      See Also:

    • modeAsString

      public final String modeAsString()

      The mode of the job run.

      If the service returns an enum value that is not available in the current SDK version, mode will return JobRunMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from modeAsString().

      Returns:
      The mode of the job run.
      See Also:

    • retryPolicy

      public final RetryPolicy retryPolicy()

      The retry policy of the job run.

      Returns:
      The retry policy of the job run.

    • attempt

      public final Integer attempt()

      The attempt of the job run.

      Returns:
      The attempt of the job run.

    • attemptCreatedAt

      public final Instant attemptCreatedAt()

      The date and time of when the job run attempt was created.

      Returns:
      The date and time of when the job run attempt was created.

    • attemptUpdatedAt

      public final Instant attemptUpdatedAt()

      The date and time of when the job run attempt was last updated.

      Returns:
      The date and time of when the job run attempt was last updated.

    • startedAt

      public final Instant startedAt()

      The date and time when the job moved to the RUNNING state.

      Returns:
      The date and time when the job moved to the RUNNING state.

    • endedAt

      public final Instant endedAt()

      The date and time when the job was terminated.

      Returns:
      The date and time when the job was terminated.

    • queuedDurationMilliseconds

      public final Long queuedDurationMilliseconds()

      The total time for a job in the QUEUED state in milliseconds.

      Returns:
      The total time for a job in the QUEUED state in milliseconds.

    • toBuilder

      public JobRun.Builder 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 interface ToCopyableBuilder<JobRun.Builder,JobRun>
      Returns:
      a builder for type T

    • builder

      public static JobRun.Builder builder()

    • serializableBuilderClass

      public static Class<? extends JobRun.Builder> serializableBuilderClass()

    • hashCode

      public final int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public final boolean equals(Object obj)
      Overrides:
      equals in class Object

    • equalsBySdkFields

      public final boolean equalsBySdkFields(Object obj)
      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 an SdkPojo class, and is generated based on a service model.

      If an SdkPojo class does not have any inherited fields, equalsBySdkFields and equals are essentially the same.

      Specified by:
      equalsBySdkFields in interface SdkPojo
      Parameters:
      obj - the object to be compared with
      Returns:
      true if the other object equals to this object by sdk fields, false otherwise.

    • toString

      public final String 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.
      Overrides:
      toString in class Object

    • getValueForField

      public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)

    • sdkFields

      public final List<SdkField<?>> sdkFields()
      Specified by:
      sdkFields in interface SdkPojo
      Returns:
      List of SdkField in this POJO. May be empty list but should never be null.

    • sdkFieldNameToField

      public final Map<String,SdkField<?>> sdkFieldNameToField()
      Specified by:
      sdkFieldNameToField in interface SdkPojo
      Returns:
      The mapping between the field name and its corresponding field.