Class JobQueueDetail
- java.lang.Object
-
- software.amazon.awssdk.services.batch.model.JobQueueDetail
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<JobQueueDetail.Builder,JobQueueDetail>
@Generated("software.amazon.awssdk:codegen") public final class JobQueueDetail extends Object implements SdkPojo, Serializable, ToCopyableBuilder<JobQueueDetail.Builder,JobQueueDetail>
An object that represents the details for an Batch job queue.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceJobQueueDetail.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static JobQueueDetail.Builderbuilder()List<ComputeEnvironmentOrder>computeEnvironmentOrder()The compute environments that are attached to the job queue and the order that job placement is preferred.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasComputeEnvironmentOrder()For responses, this returns true if the service returned a value for the ComputeEnvironmentOrder property.inthashCode()booleanhasJobStateTimeLimitActions()For responses, this returns true if the service returned a value for the JobStateTimeLimitActions property.booleanhasTags()For responses, this returns true if the service returned a value for the Tags property.StringjobQueueArn()The Amazon Resource Name (ARN) of the job queue.StringjobQueueName()The job queue name.List<JobStateTimeLimitAction>jobStateTimeLimitActions()The set of actions that Batch perform on jobs that remain at the head of the job queue in the specified state longer than specified times.Integerpriority()The priority of the job queue.StringschedulingPolicyArn()The Amazon Resource Name (ARN) of the scheduling policy.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends JobQueueDetail.Builder>serializableBuilderClass()JQStatestate()Describes the ability of the queue to accept new jobs.StringstateAsString()Describes the ability of the queue to accept new jobs.JQStatusstatus()The status of the job queue (for example,CREATINGorVALID).StringstatusAsString()The status of the job queue (for example,CREATINGorVALID).StringstatusReason()A short, human-readable string to provide additional details for the current status of the job queue.Map<String,String>tags()The tags that are applied to the job queue.JobQueueDetail.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
jobQueueName
public final String jobQueueName()
The job queue name.
- Returns:
- The job queue name.
-
jobQueueArn
public final String jobQueueArn()
The Amazon Resource Name (ARN) of the job queue.
- Returns:
- The Amazon Resource Name (ARN) of the job queue.
-
state
public final JQState state()
Describes the ability of the queue to accept new jobs. If the job queue state is
ENABLED, it can accept jobs. If the job queue state isDISABLED, new jobs can't be added to the queue, but jobs already in the queue can finish.If the service returns an enum value that is not available in the current SDK version,
statewill returnJQState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstateAsString().- Returns:
- Describes the ability of the queue to accept new jobs. If the job queue state is
ENABLED, it can accept jobs. If the job queue state isDISABLED, new jobs can't be added to the queue, but jobs already in the queue can finish. - See Also:
JQState
-
stateAsString
public final String stateAsString()
Describes the ability of the queue to accept new jobs. If the job queue state is
ENABLED, it can accept jobs. If the job queue state isDISABLED, new jobs can't be added to the queue, but jobs already in the queue can finish.If the service returns an enum value that is not available in the current SDK version,
statewill returnJQState.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstateAsString().- Returns:
- Describes the ability of the queue to accept new jobs. If the job queue state is
ENABLED, it can accept jobs. If the job queue state isDISABLED, new jobs can't be added to the queue, but jobs already in the queue can finish. - See Also:
JQState
-
schedulingPolicyArn
public final String schedulingPolicyArn()
The Amazon Resource Name (ARN) of the scheduling policy. The format is
aws:Partition:batch:Region:Account:scheduling-policy/Name. For example,aws:aws:batch:us-west-2:123456789012:scheduling-policy/MySchedulingPolicy.- Returns:
- The Amazon Resource Name (ARN) of the scheduling policy. The format is
aws:Partition:batch:Region:Account:scheduling-policy/Name. For example,aws:aws:batch:us-west-2:123456789012:scheduling-policy/MySchedulingPolicy.
-
status
public final JQStatus status()
The status of the job queue (for example,
CREATINGorVALID).If the service returns an enum value that is not available in the current SDK version,
statuswill returnJQStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- The status of the job queue (for example,
CREATINGorVALID). - See Also:
JQStatus
-
statusAsString
public final String statusAsString()
The status of the job queue (for example,
CREATINGorVALID).If the service returns an enum value that is not available in the current SDK version,
statuswill returnJQStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- The status of the job queue (for example,
CREATINGorVALID). - See Also:
JQStatus
-
statusReason
public final String statusReason()
A short, human-readable string to provide additional details for the current status of the job queue.
- Returns:
- A short, human-readable string to provide additional details for the current status of the job queue.
-
priority
public final Integer priority()
The priority of the job queue. Job queue priority determines the order that job queues are evaluated when multiple queues dispatch jobs within a shared compute environment. A higher value for
priorityindicates a higher priority. Queues are evaluated in cycles, in descending order by priority. For example, a job queue with a priority value of10is evaluated before a queue with a priority value of1. All of the compute environments must be either Amazon EC2 (EC2orSPOT) or Fargate (FARGATEorFARGATE_SPOT). Amazon EC2 and Fargate compute environments can't be mixed.Job queue priority doesn't guarantee that a particular job executes before a job in a lower priority queue. Jobs added to higher priority queues during the queue evaluation cycle might not be evaluated until the next cycle. A job is dispatched from a queue only if resources are available when the queue is evaluated. If there are insufficient resources available at that time, the cycle proceeds to the next queue. This means that jobs added to higher priority queues might have to wait for jobs in multiple lower priority queues to complete before they are dispatched. You can use job dependencies to control the order for jobs from queues with different priorities. For more information, see Job Dependencies in the Batch User Guide.
- Returns:
- The priority of the job queue. Job queue priority determines the order that job queues are evaluated when
multiple queues dispatch jobs within a shared compute environment. A higher value for
priorityindicates a higher priority. Queues are evaluated in cycles, in descending order by priority. For example, a job queue with a priority value of10is evaluated before a queue with a priority value of1. All of the compute environments must be either Amazon EC2 (EC2orSPOT) or Fargate (FARGATEorFARGATE_SPOT). Amazon EC2 and Fargate compute environments can't be mixed.Job queue priority doesn't guarantee that a particular job executes before a job in a lower priority queue. Jobs added to higher priority queues during the queue evaluation cycle might not be evaluated until the next cycle. A job is dispatched from a queue only if resources are available when the queue is evaluated. If there are insufficient resources available at that time, the cycle proceeds to the next queue. This means that jobs added to higher priority queues might have to wait for jobs in multiple lower priority queues to complete before they are dispatched. You can use job dependencies to control the order for jobs from queues with different priorities. For more information, see Job Dependencies in the Batch User Guide.
-
hasComputeEnvironmentOrder
public final boolean hasComputeEnvironmentOrder()
For responses, this returns true if the service returned a value for the ComputeEnvironmentOrder property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()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.
-
computeEnvironmentOrder
public final List<ComputeEnvironmentOrder> computeEnvironmentOrder()
The compute environments that are attached to the job queue and the order that job placement is preferred. Compute environments are selected for job placement in ascending order.
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
hasComputeEnvironmentOrder()method.- Returns:
- The compute environments that are attached to the job queue and the order that job placement is preferred. Compute environments are selected for job placement in ascending order.
-
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 theisEmpty()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 that are applied to the job queue. For more information, see Tagging your Batch resources in Batch User Guide.
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 that are applied to the job queue. For more information, see Tagging your Batch resources in Batch User Guide.
-
hasJobStateTimeLimitActions
public final boolean hasJobStateTimeLimitActions()
For responses, this returns true if the service returned a value for the JobStateTimeLimitActions property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()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.
-
jobStateTimeLimitActions
public final List<JobStateTimeLimitAction> jobStateTimeLimitActions()
The set of actions that Batch perform on jobs that remain at the head of the job queue in the specified state longer than specified times. Batch will perform each action after
maxTimeSecondshas passed.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
hasJobStateTimeLimitActions()method.- Returns:
- The set of actions that Batch perform on jobs that remain at the head of the job queue in the specified
state longer than specified times. Batch will perform each action after
maxTimeSecondshas passed.
-
toBuilder
public JobQueueDetail.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<JobQueueDetail.Builder,JobQueueDetail>
-
builder
public static JobQueueDetail.Builder builder()
-
serializableBuilderClass
public static Class<? extends JobQueueDetail.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
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.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-