Skip to content

JobQueueDetail

Source code in docs_src/capo_batch/types/job_queue_detail.py
class JobQueueDetail(TypedDict, closed=True):
    job_queue_name: NotRequired["capo_batch.types.string.String"]
    """<p>The job queue name.</p>"""
    job_queue_arn: NotRequired["capo_batch.types.string.String"]
    """<p>The Amazon Resource Name (ARN) of the job queue.</p>"""
    state: NotRequired["capo_batch.types.jq_state.JQState"]
    """<p>Describes the ability of the queue to accept new jobs. If the job queue state is <code>ENABLED</code>, it can accept jobs. If the job queue state is <code>DISABLED</code>, new jobs can't be added to the queue, but jobs already in the queue can finish.</p>"""
    scheduling_policy_arn: NotRequired["capo_batch.types.string.String"]
    """<p>The Amazon Resource Name (ARN) of the scheduling policy. The format is <code>aws:<i>Partition</i>:batch:<i>Region</i>:<i>Account</i>:scheduling-policy/<i>Name</i> </code>. For example, <code>aws:aws:batch:us-west-2:123456789012:scheduling-policy/MySchedulingPolicy</code>.</p>"""
    status: NotRequired["capo_batch.types.jq_status.JQStatus"]
    """<p>The status of the job queue (for example, <code>CREATING</code> or <code>VALID</code>).</p>"""
    status_reason: NotRequired["capo_batch.types.string.String"]
    """<p>A short, human-readable string to provide additional details for the current status of the job queue.</p>"""
    priority: NotRequired["capo_batch.types.integer.Integer"]
    """<p>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 <code>priority</code> indicates a higher priority. Queues are evaluated in cycles, in descending order by priority. For example, a job queue with a priority value of <code>10</code> is evaluated before a queue with a priority value of <code>1</code>. All of the compute environments must be either Amazon EC2 (<code>EC2</code> or <code>SPOT</code>) or Fargate (<code>FARGATE</code> or <code>FARGATE_SPOT</code>). Amazon EC2 and Fargate compute environments can't be mixed.</p> <note> <p>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 <a href="https://docs.aws.amazon.com/batch/latest/userguide/job_dependencies.html">Job Dependencies</a> in the <i>Batch User Guide</i>.</p> </note>"""
    compute_environment_order: NotRequired[
        "capo_batch.types.compute_environment_orders.ComputeEnvironmentOrders"
    ]
    """<p>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.</p>"""
    service_environment_order: NotRequired[
        "capo_batch.types.service_environment_orders.ServiceEnvironmentOrders"
    ]
    """<p>The order of the service environment associated with the job queue. Job queues with a higher priority are evaluated first when associated with the same service environment.</p>"""
    job_queue_type: NotRequired["capo_batch.types.job_queue_type.JobQueueType"]
    """<p>The type of job queue. For service jobs that run on SageMaker Training, this value is <code>SAGEMAKER_TRAINING</code>. For regular container jobs, this value is <code>EKS</code>, <code>ECS</code>, or <code>ECS_FARGATE</code> depending on the compute environment.</p>"""
    tags: NotRequired["capo_batch.types.tagris_tags_map.TagrisTagsMap"]
    """<p>The tags that are applied to the job queue. For more information, see <a href="https://docs.aws.amazon.com/batch/latest/userguide/using-tags.html">Tagging your Batch resources</a> in <i>Batch User Guide</i>.</p>"""
    job_state_time_limit_actions: NotRequired[
        "capo_batch.types.job_state_time_limit_actions.JobStateTimeLimitActions"
    ]
    """<p>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 <code>maxTimeSeconds</code> has passed.</p>"""

compute_environment_order instance-attribute

compute_environment_order: NotRequired[ComputeEnvironmentOrders]

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.

job_queue_arn instance-attribute

job_queue_arn: NotRequired[String]

The Amazon Resource Name (ARN) of the job queue.

job_queue_name instance-attribute

job_queue_name: NotRequired[String]

The job queue name.

job_queue_type instance-attribute

job_queue_type: NotRequired[JobQueueType]

The type of job queue. For service jobs that run on SageMaker Training, this value is SAGEMAKER_TRAINING. For regular container jobs, this value is EKS, ECS, or ECS_FARGATE depending on the compute environment.

job_state_time_limit_actions instance-attribute

job_state_time_limit_actions: NotRequired[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 maxTimeSeconds has passed.

priority instance-attribute

priority: NotRequired[Integer]

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 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_arn instance-attribute

scheduling_policy_arn: NotRequired[String]

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.

service_environment_order instance-attribute

service_environment_order: NotRequired[ServiceEnvironmentOrders]

The order of the service environment associated with the job queue. Job queues with a higher priority are evaluated first when associated with the same service environment.

state instance-attribute

state: NotRequired[JQState]

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 is DISABLED, new jobs can't be added to the queue, but jobs already in the queue can finish.

status instance-attribute

status: NotRequired[JQStatus]

The status of the job queue (for example, CREATING or VALID).

status_reason instance-attribute

status_reason: NotRequired[String]

A short, human-readable string to provide additional details for the current status of the job queue.

tags instance-attribute

tags: NotRequired[TagrisTagsMap]

The tags that are applied to the job queue. For more information, see Tagging your Batch resources in Batch User Guide.