1. Packages
  2. AWS
  3. API Docs
  4. batch
  5. getJobQueue
Viewing docs for AWS v6.83.1 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-aws

aws.batch.getJobQueue

aws logo
Viewing docs for AWS v6.83.1 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-aws

    The Batch Job Queue data source allows access to details of a specific job queue within AWS Batch.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const test_queue = aws.batch.getJobQueue({
    name: "tf-test-batch-job-queue",
});

    import pulumi
import pulumi_aws as aws

test_queue = aws.batch.get_job_queue(name="tf-test-batch-job-queue")

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/batch"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := batch.LookupJobQueue(ctx, &batch.LookupJobQueueArgs{
			Name: "tf-test-batch-job-queue",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var test_queue = Aws.Batch.GetJobQueue.Invoke(new()
    {
        Name = "tf-test-batch-job-queue",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.batch.BatchFunctions;
import com.pulumi.aws.batch.inputs.GetJobQueueArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var test-queue = BatchFunctions.getJobQueue(GetJobQueueArgs.builder()
            .name("tf-test-batch-job-queue")
            .build());

    }
}

    variables:
  test-queue:
    fn::invoke:
      function: aws:batch:getJobQueue
      arguments:
        name: tf-test-batch-job-queue

    Using getJobQueue

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getJobQueue(args: GetJobQueueArgs, opts?: InvokeOptions): Promise<GetJobQueueResult>
function getJobQueueOutput(args: GetJobQueueOutputArgs, opts?: InvokeOptions): Output<GetJobQueueResult>
    def get_job_queue(name: Optional[str] = None,
                  tags: Optional[Mapping[str, str]] = None,
                  opts: Optional[InvokeOptions] = None) -> GetJobQueueResult
def get_job_queue_output(name: Optional[pulumi.Input[str]] = None,
                  tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                  opts: Optional[InvokeOptions] = None) -> Output[GetJobQueueResult]
    func LookupJobQueue(ctx *Context, args *LookupJobQueueArgs, opts ...InvokeOption) (*LookupJobQueueResult, error)
func LookupJobQueueOutput(ctx *Context, args *LookupJobQueueOutputArgs, opts ...InvokeOption) LookupJobQueueResultOutput

    > Note: This function is named LookupJobQueue in the Go SDK.

    public static class GetJobQueue 
{
    public static Task<GetJobQueueResult> InvokeAsync(GetJobQueueArgs args, InvokeOptions? opts = null)
    public static Output<GetJobQueueResult> Invoke(GetJobQueueInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetJobQueueResult> getJobQueue(GetJobQueueArgs args, InvokeOptions options)
public static Output<GetJobQueueResult> getJobQueue(GetJobQueueArgs args, InvokeOptions options)

    fn::invoke:
  function: aws:batch/getJobQueue:getJobQueue
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Name string
    Name of the job queue.
    Tags Dictionary<string, string>
    Key-value map of resource tags
    Name string
    Name of the job queue.
    Tags map[string]string
    Key-value map of resource tags
    name String
    Name of the job queue.
    tags Map<String,String>
    Key-value map of resource tags
    name string
    Name of the job queue.
    tags {[key: string]: string}
    Key-value map of resource tags
    name str
    Name of the job queue.
    tags Mapping[str, str]
    Key-value map of resource tags
    name String
    Name of the job queue.
    tags Map<String>
    Key-value map of resource tags

    getJobQueue Result

    The following output properties are available:

    Arn string
    ARN of the job queue.
    ComputeEnvironmentOrders List<GetJobQueueComputeEnvironmentOrder>
    The compute environments that are attached to the job queue and the order in which job placement is preferred. Compute environments are selected for job placement in ascending order.

    • compute_environment_order.#.order - The order of the compute environment.
    • compute_environment_order.#.compute_environment - The ARN of the compute environment.
    Id string
    The provider-assigned unique ID for this managed resource.
    JobStateTimeLimitActions List<GetJobQueueJobStateTimeLimitAction>
    Specifies an action that AWS Batch will take after the job has remained at the head of the queue in the specified state for longer than the specified time.

    • job_state_time_limit_action.#.action - The action to take when a job is at the head of the job queue in the specified state for the specified period of time.
    • job_state_time_limit_action.#.max_time_seconds - The approximate amount of time, in seconds, that must pass with the job in the specified state before the action is taken.
    • job_state_time_limit_action.#.reason - The reason to log for the action being taken.
    • job_state_time_limit_action.#.state - The state of the job needed to trigger the action.
    Name string
    Priority int
    Priority of the job queue. Job queues with a higher priority are evaluated first when associated with the same compute environment.
    SchedulingPolicyArn string
    The ARN of the fair share scheduling policy. If this attribute has a value, the job queue uses a fair share scheduling policy. If this attribute does not have a value, the job queue uses a first in, first out (FIFO) scheduling policy.
    State string
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    Status string
    Current status of the job queue (for example, CREATING or VALID).
    StatusReason string
    Short, human-readable string to provide additional details about the current status of the job queue.
    Tags Dictionary<string, string>
    Key-value map of resource tags
    Arn string
    ARN of the job queue.
    ComputeEnvironmentOrders []GetJobQueueComputeEnvironmentOrder
    The compute environments that are attached to the job queue and the order in which job placement is preferred. Compute environments are selected for job placement in ascending order.

    • compute_environment_order.#.order - The order of the compute environment.
    • compute_environment_order.#.compute_environment - The ARN of the compute environment.
    Id string
    The provider-assigned unique ID for this managed resource.
    JobStateTimeLimitActions []GetJobQueueJobStateTimeLimitAction
    Specifies an action that AWS Batch will take after the job has remained at the head of the queue in the specified state for longer than the specified time.

    • job_state_time_limit_action.#.action - The action to take when a job is at the head of the job queue in the specified state for the specified period of time.
    • job_state_time_limit_action.#.max_time_seconds - The approximate amount of time, in seconds, that must pass with the job in the specified state before the action is taken.
    • job_state_time_limit_action.#.reason - The reason to log for the action being taken.
    • job_state_time_limit_action.#.state - The state of the job needed to trigger the action.
    Name string
    Priority int
    Priority of the job queue. Job queues with a higher priority are evaluated first when associated with the same compute environment.
    SchedulingPolicyArn string
    The ARN of the fair share scheduling policy. If this attribute has a value, the job queue uses a fair share scheduling policy. If this attribute does not have a value, the job queue uses a first in, first out (FIFO) scheduling policy.
    State string
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    Status string
    Current status of the job queue (for example, CREATING or VALID).
    StatusReason string
    Short, human-readable string to provide additional details about the current status of the job queue.
    Tags map[string]string
    Key-value map of resource tags
    arn String
    ARN of the job queue.
    computeEnvironmentOrders List<GetJobQueueComputeEnvironmentOrder>
    The compute environments that are attached to the job queue and the order in which job placement is preferred. Compute environments are selected for job placement in ascending order.

    • compute_environment_order.#.order - The order of the compute environment.
    • compute_environment_order.#.compute_environment - The ARN of the compute environment.
    id String
    The provider-assigned unique ID for this managed resource.
    jobStateTimeLimitActions List<GetJobQueueJobStateTimeLimitAction>
    Specifies an action that AWS Batch will take after the job has remained at the head of the queue in the specified state for longer than the specified time.

    • job_state_time_limit_action.#.action - The action to take when a job is at the head of the job queue in the specified state for the specified period of time.
    • job_state_time_limit_action.#.max_time_seconds - The approximate amount of time, in seconds, that must pass with the job in the specified state before the action is taken.
    • job_state_time_limit_action.#.reason - The reason to log for the action being taken.
    • job_state_time_limit_action.#.state - The state of the job needed to trigger the action.
    name String
    priority Integer
    Priority of the job queue. Job queues with a higher priority are evaluated first when associated with the same compute environment.
    schedulingPolicyArn String
    The ARN of the fair share scheduling policy. If this attribute has a value, the job queue uses a fair share scheduling policy. If this attribute does not have a value, the job queue uses a first in, first out (FIFO) scheduling policy.
    state String
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    status String
    Current status of the job queue (for example, CREATING or VALID).
    statusReason String
    Short, human-readable string to provide additional details about the current status of the job queue.
    tags Map<String,String>
    Key-value map of resource tags
    arn string
    ARN of the job queue.
    computeEnvironmentOrders GetJobQueueComputeEnvironmentOrder[]
    The compute environments that are attached to the job queue and the order in which job placement is preferred. Compute environments are selected for job placement in ascending order.

    • compute_environment_order.#.order - The order of the compute environment.
    • compute_environment_order.#.compute_environment - The ARN of the compute environment.
    id string
    The provider-assigned unique ID for this managed resource.
    jobStateTimeLimitActions GetJobQueueJobStateTimeLimitAction[]
    Specifies an action that AWS Batch will take after the job has remained at the head of the queue in the specified state for longer than the specified time.

    • job_state_time_limit_action.#.action - The action to take when a job is at the head of the job queue in the specified state for the specified period of time.
    • job_state_time_limit_action.#.max_time_seconds - The approximate amount of time, in seconds, that must pass with the job in the specified state before the action is taken.
    • job_state_time_limit_action.#.reason - The reason to log for the action being taken.
    • job_state_time_limit_action.#.state - The state of the job needed to trigger the action.
    name string
    priority number
    Priority of the job queue. Job queues with a higher priority are evaluated first when associated with the same compute environment.
    schedulingPolicyArn string
    The ARN of the fair share scheduling policy. If this attribute has a value, the job queue uses a fair share scheduling policy. If this attribute does not have a value, the job queue uses a first in, first out (FIFO) scheduling policy.
    state string
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    status string
    Current status of the job queue (for example, CREATING or VALID).
    statusReason string
    Short, human-readable string to provide additional details about the current status of the job queue.
    tags {[key: string]: string}
    Key-value map of resource tags
    arn str
    ARN of the job queue.
    compute_environment_orders Sequence[GetJobQueueComputeEnvironmentOrder]
    The compute environments that are attached to the job queue and the order in which job placement is preferred. Compute environments are selected for job placement in ascending order.

    • compute_environment_order.#.order - The order of the compute environment.
    • compute_environment_order.#.compute_environment - The ARN of the compute environment.
    id str
    The provider-assigned unique ID for this managed resource.
    job_state_time_limit_actions Sequence[GetJobQueueJobStateTimeLimitAction]
    Specifies an action that AWS Batch will take after the job has remained at the head of the queue in the specified state for longer than the specified time.

    • job_state_time_limit_action.#.action - The action to take when a job is at the head of the job queue in the specified state for the specified period of time.
    • job_state_time_limit_action.#.max_time_seconds - The approximate amount of time, in seconds, that must pass with the job in the specified state before the action is taken.
    • job_state_time_limit_action.#.reason - The reason to log for the action being taken.
    • job_state_time_limit_action.#.state - The state of the job needed to trigger the action.
    name str
    priority int
    Priority of the job queue. Job queues with a higher priority are evaluated first when associated with the same compute environment.
    scheduling_policy_arn str
    The ARN of the fair share scheduling policy. If this attribute has a value, the job queue uses a fair share scheduling policy. If this attribute does not have a value, the job queue uses a first in, first out (FIFO) scheduling policy.
    state str
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    status str
    Current status of the job queue (for example, CREATING or VALID).
    status_reason str
    Short, human-readable string to provide additional details about the current status of the job queue.
    tags Mapping[str, str]
    Key-value map of resource tags
    arn String
    ARN of the job queue.
    computeEnvironmentOrders List<Property Map>
    The compute environments that are attached to the job queue and the order in which job placement is preferred. Compute environments are selected for job placement in ascending order.

    • compute_environment_order.#.order - The order of the compute environment.
    • compute_environment_order.#.compute_environment - The ARN of the compute environment.
    id String
    The provider-assigned unique ID for this managed resource.
    jobStateTimeLimitActions List<Property Map>
    Specifies an action that AWS Batch will take after the job has remained at the head of the queue in the specified state for longer than the specified time.

    • job_state_time_limit_action.#.action - The action to take when a job is at the head of the job queue in the specified state for the specified period of time.
    • job_state_time_limit_action.#.max_time_seconds - The approximate amount of time, in seconds, that must pass with the job in the specified state before the action is taken.
    • job_state_time_limit_action.#.reason - The reason to log for the action being taken.
    • job_state_time_limit_action.#.state - The state of the job needed to trigger the action.
    name String
    priority Number
    Priority of the job queue. Job queues with a higher priority are evaluated first when associated with the same compute environment.
    schedulingPolicyArn String
    The ARN of the fair share scheduling policy. If this attribute has a value, the job queue uses a fair share scheduling policy. If this attribute does not have a value, the job queue uses a first in, first out (FIFO) scheduling policy.
    state String
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    status String
    Current status of the job queue (for example, CREATING or VALID).
    statusReason String
    Short, human-readable string to provide additional details about the current status of the job queue.
    tags Map<String>
    Key-value map of resource tags

    Supporting Types

    GetJobQueueComputeEnvironmentOrder

    GetJobQueueJobStateTimeLimitAction

    Action string
    MaxTimeSeconds int
    Reason string
    State string
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    Action string
    MaxTimeSeconds int
    Reason string
    State string
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    action String
    maxTimeSeconds Integer
    reason String
    state String
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    action string
    maxTimeSeconds number
    reason string
    state string
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    action str
    max_time_seconds int
    reason str
    state str
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).
    action String
    maxTimeSeconds Number
    reason String
    state String
    Describes the ability of the queue to accept new jobs (for example, ENABLED or DISABLED).

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    Viewing docs for AWS v6.83.1 (Older version)
    published on Monday, Mar 9, 2026 by Pulumi
    Go to latest version
    Schema (JSON)
    pulumi/pulumi-aws
      Try Pulumi Cloud free. Your team will thank you.