# JobQueue

JobQueues can receive Jobs, which are removed from the queue when sent to the linked ComputeEnvironment(s) to be executed.

Jobs exit the queue in FIFO order unless a `SchedulingPolicy` is linked.

Extends: Construct › Resource › JobQueue
Implements: IResource, IJobQueue, IEnvironmentAware, IJobQueueRef, IConstruct, IDependable

- CloudFormation: [`AWS::Batch::JobQueue`](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-batch-jobqueue.html)
- L1 type: [`CfnJobQueue`](/cdk/api/v2/docs/aws-cdk-lib.aws_batch.CfnJobQueue.html)
- Source: [`aws-batch/lib/job-queue.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-batch/lib/job-queue.ts#L246)
- Type last changed: v2.234.0 · 8 Jan 2026

## Example

```ts
declare const vpc: ec2.IVpc;

const ecsJob = new batch.EcsJobDefinition(this, 'JobDefn', {
  container: new batch.EcsEc2ContainerDefinition(this, 'containerDefn', {
    image: ecs.ContainerImage.fromRegistry('public.ecr.aws/amazonlinux/amazonlinux:latest'),
    memory: cdk.Size.mebibytes(2048),
    cpu: 256,
  }),
});

const queue = new batch.JobQueue(this, 'JobQueue', {
  computeEnvironments: [{
    computeEnvironment: new batch.ManagedEc2EcsComputeEnvironment(this, 'managedEc2CE', {
      vpc,
    }),
    order: 1,
  }],
  priority: 10,
});

const user = new iam.User(this, 'MyUser');
ecsJob.grantSubmitJob(user, queue);
```

## Initializer

```ts
new JobQueue(scope: Construct, id: string, props?: JobQueueProps)
```

## Construct Props

- `computeEnvironments`: [OrderedComputeEnvironment](/cdk/api/v2/docs/aws-cdk-lib.aws_batch.OrderedComputeEnvironment.html)[] = none — The set of compute environments mapped to a job queue and their order relative to each other.

  The job scheduler uses this parameter to determine which compute environment runs a specific job.
  Compute environments must be in the VALID state before you can associate them with a job queue.
  You can associate up to three compute environments with a job queue.
  All of the compute environments must be either EC2 (EC2 or SPOT) or Fargate (FARGATE or FARGATE_SPOT);
  EC2 and Fargate compute environments can't be mixed.

  *Note*: All compute environments that are associated with a job queue must share the same architecture.
  AWS Batch doesn't support mixing compute environment architecture types in a single job queue.

- `enabled`: boolean = true — If the job queue is enabled, it is able to accept jobs.

  Otherwise, new jobs can't be added to the queue, but jobs already in the queue can finish.

- `jobQueueName`: string — The name of the job queue.

  **Default:** no name

  It can be up to 128 letters long.
  It can contain uppercase and lowercase letters, numbers, hyphens (-), and underscores (_)

- `jobStateTimeLimitActions`: [JobStateTimeLimitAction](/cdk/api/v2/docs/aws-cdk-lib.aws_batch.JobStateTimeLimitAction.html)[] — The set of actions that AWS Batch perform on jobs that remain at the head of the job queue in the specified state longer than specified times.

  **Default:** no actions

- `priority`: number = 1 — The priority of the job queue.

  Job queues with a higher priority are evaluated first when associated with the same compute environment.
  Priority is determined in descending order.
  For example, a job queue with a priority of 10 is given scheduling preference over a job queue with a priority of 1.

- `schedulingPolicy`: [ISchedulingPolicyRef](/cdk/api/v2/docs/aws-cdk-lib.interfaces.aws_batch.ISchedulingPolicyRef.html) — The SchedulingPolicy for this JobQueue.

  **Default:** no scheduling policy

  Instructs the Scheduler how to schedule different jobs.

## Properties

- `computeEnvironments`: [OrderedComputeEnvironment](/cdk/api/v2/docs/aws-cdk-lib.aws_batch.OrderedComputeEnvironment.html)[] — The set of compute environments mapped to a job queue and their order relative to each other.

  The job scheduler uses this parameter to determine which compute environment runs a specific job.
  Compute environments must be in the VALID state before you can associate them with a job queue.
  You can associate up to three compute environments with a job queue.
  All of the compute environments must be either EC2 (EC2 or SPOT) or Fargate (FARGATE or FARGATE_SPOT);
  EC2 and Fargate compute environments can't be mixed.

  *Note*: All compute environments that are associated with a job queue must share the same architecture.
  AWS Batch doesn't support mixing compute environment architecture types in a single job queue.

- `enabled`: boolean — If the job queue is enabled, it is able to accept jobs.

  Otherwise, new jobs can't be added to the queue, but jobs already in the queue can finish.

- `env`: [ResourceEnvironment](/cdk/api/v2/docs/aws-cdk-lib.interfaces.ResourceEnvironment.html) — The environment this resource belongs to.

  For resources that are created and managed in a Stack (those created by
  creating new class instances like `new Role()`, `new Bucket()`, etc.), this
  is always the same as the environment of the stack they belong to.

  For referenced resources (those obtained from referencing methods like
  `Role.fromRoleArn()`, `Bucket.fromBucketName()`, etc.), they might be
  different than the stack they were imported into.

- `jobQueueArn`: string — The ARN of this job queue.

- `jobQueueName`: string — The name of the job queue.

  It can be up to 128 letters long.
  It can contain uppercase and lowercase letters, numbers, hyphens (-), and underscores (_)

- `jobQueueRef`: [JobQueueReference](/cdk/api/v2/docs/aws-cdk-lib.interfaces.aws_batch.JobQueueReference.html) — A reference to a JobQueue resource.

- `node`: [Node](/cdk/api/v2/docs/constructs.Node.html) — The tree node.

- `priority`: number — The priority of the job queue.

  Job queues with a higher priority are evaluated first when associated with the same compute environment.
  Priority is determined in descending order.
  For example, a job queue with a priority value of 10 is given scheduling preference over a job queue with a priority value of 1.

- `PROPERTY_INJECTION_ID`: string (static) — Uniquely identifies this class.

- `schedulingPolicy`: [ISchedulingPolicy](/cdk/api/v2/docs/aws-cdk-lib.aws_batch.ISchedulingPolicy.html) — The SchedulingPolicy for this JobQueue.

  Instructs the Scheduler how to schedule different jobs.

- `stack`: [Stack](/cdk/api/v2/docs/aws-cdk-lib.Stack.html) — The stack in which this resource is defined.

## Methods

- `addComputeEnvironment(computeEnvironment: IComputeEnvironmentRef, order: number): void` — Add a `ComputeEnvironment` to this Queue.

  The Queue will prefer lower-order `ComputeEnvironment`s.

- `applyCrossStackReferenceStrength(strength: ReferenceStrength): void` — Override the cross-stack reference strength for this resource.

  When set, any cross-stack reference to this resource will use the specified
  mechanism instead of the global default determined by the
  `@aws-cdk/core:defaultCrossStackReferences` context key. This is useful for
  selectively weakening specific references to avoid the "deadly embrace" problem
  without changing the app-wide default.

  **Parameters**

  - `strength` — - The reference strength to use for this resource.

- `applyRemovalPolicy(policy: RemovalPolicy): void` — Apply the given removal policy to this resource.

  The Removal Policy controls what happens to this resource when it stops
  being managed by CloudFormation, either because you've removed it from the
  CDK application or because you've made a change that requires the resource
  to be replaced.

  The resource can be deleted (`RemovalPolicy.DESTROY`), or left in your AWS
  account for data recovery and cleanup later (`RemovalPolicy.RETAIN`).

- `fromJobQueueArn(scope: Construct, id: string, jobQueueArn: string): IJobQueue` (static) — refer to an existing JobQueue by its arn.

- `isConstruct(x: any): boolean` (static) — Checks if `x` is a construct.

  Use this method instead of `instanceof` to properly detect `Construct`
  instances, even when the construct library is symlinked.

  Explanation: in JavaScript, multiple copies of the `constructs` library on
  disk are seen as independent, completely different libraries. As a
  consequence, the class `Construct` in each copy of the `constructs` library
  is seen as a different class, and an instance of one class will not test as
  `instanceof` the other class. `npm install` will not create installations
  like this, but users may manually symlink construct libraries together or
  use a monorepo tool: in those cases, multiple copies of the `constructs`
  library can be accidentally installed, and `instanceof` will behave
  unpredictably. It is safest to avoid using `instanceof`, and using
  this type-testing method instead.

  **Parameters**

  - `x` — Any object.

  **Returns:** true if `x` is an object created from a class which extends `Construct`.

- `isOwnedResource(construct: IConstruct): boolean` (static) — Returns true if the construct was created by CDK, and false otherwise.

- `isResource(construct: IConstruct): boolean` (static) — Check whether the given construct is a Resource.

- `toString(): string` — Returns a string representation of this construct.

- `with(...mixins: IMixin[]): IConstruct` — Applies one or more mixins to this construct.

  Mixins are applied in order. The list of constructs is captured at the
  start of the call, so constructs added by a mixin will not be visited.
  Use multiple `with()` calls if subsequent mixins should apply to added
  constructs.