Batch Job Queue

An AWS Batch Job Queue is a resource that manages how submitted batch jobs are prioritized and assigned to compute environments. It acts as a buffer where jobs wait until compute resources are available. Job queues can be associated with one or more compute environments, and their priority settings determine the order in which jobs are dispatched. This allows flexible control over workload scheduling and resource allocation.

aws.batch_job_queue

Fields

TitleIDTypeData TypeDescription
_keycorestring
account_idcorestring
compute_environment_ordercorejsonThe 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.
job_queue_arncorestringThe Amazon Resource Name (ARN) of the job queue.
job_queue_namecorestringThe job queue name.
job_state_time_limit_actionscorejsonThe 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 maxTimeSeconds has passed.
prioritycoreint64The 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 priority indicates a higher priority. Queues are evaluated in cycles, in descending order by priority. For example, a job queue with a priority value of 10 is evaluated before a queue with a priority value of 1. All of the compute environments must be either Amazon EC2 (EC2 or SPOT) or Fargate (FARGATE or FARGATE_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.
scheduling_policy_arncorestringThe 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.
statecorestringDescribes 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 is DISABLED, new jobs can't be added to the queue, but jobs already in the queue can finish.
statuscorestringThe status of the job queue (for example, CREATING or VALID).
status_reasoncorestringA short, human-readable string to provide additional details for the current status of the job queue.
tagscorehstore