Skip to content

UpdateJobRequest

Source code in docs_src/capo_deadline/types/update_job_request.py
class UpdateJobRequest(TypedDict, closed=True):
    farm_id: "capo_deadline.types.farm_id.FarmId"
    """<p>The farm ID of the job to update.</p>"""
    queue_id: "capo_deadline.types.queue_id.QueueId"
    """<p>The queue ID of the job to update.</p>"""
    job_id: "capo_deadline.types.job_id.JobId"
    """<p>The job ID to update.</p>"""
    client_token: NotRequired["capo_deadline.types.client_token.ClientToken"]
    """<p>The unique token which the server uses to recognize retries of the same request.</p>"""
    target_task_run_status: NotRequired[
        "capo_deadline.types.job_target_task_run_status.JobTargetTaskRunStatus"
    ]
    """<p>The task status to update the job's tasks to.</p>"""
    priority: NotRequired["capo_deadline.types.job_priority.JobPriority"]
    """<p>The updated job priority.</p>"""
    max_failed_tasks_count: NotRequired[
        "capo_deadline.types.max_failed_tasks_count.MaxFailedTasksCount"
    ]
    """<p>The number of task failures before the job stops running and is marked as <code>FAILED</code>.</p>"""
    max_retries_per_task: NotRequired[
        "capo_deadline.types.max_retries_per_task.MaxRetriesPerTask"
    ]
    """<p>The maximum number of retries for a job.</p>"""
    lifecycle_status: NotRequired[
        "capo_deadline.types.update_job_lifecycle_status.UpdateJobLifecycleStatus"
    ]
    """<p>The status of a job in its lifecycle. When you change the status of the job to <code>ARCHIVED</code>, the job can't be scheduled or archived.</p> <important> <p>An archived jobs and its steps and tasks are deleted after 120 days. The job can't be recovered.</p> </important>"""
    max_worker_count: NotRequired["capo_deadline.types.max_worker_count.MaxWorkerCount"]
    """<p>The maximum number of worker hosts that can concurrently process a job. When the <code>maxWorkerCount</code> is reached, no more workers will be assigned to process the job, even if the fleets assigned to the job's queue has available workers.</p> <p>You can't set the <code>maxWorkerCount</code> to 0. If you set it to -1, there is no maximum number of workers.</p> <p>If you don't specify the <code>maxWorkerCount</code>, the default is -1.</p> <p>The maximum number of workers that can process tasks in the job.</p>"""
    name: NotRequired["capo_deadline.types.job_name.JobName"]
    """<p>The updated job name.</p>"""
    description: NotRequired[
        "capo_deadline.types.job_description_override.JobDescriptionOverride"
    ]
    """<p>The updated job description.</p>"""

client_token instance-attribute

client_token: NotRequired[ClientToken]

The unique token which the server uses to recognize retries of the same request.

description instance-attribute

description: NotRequired[JobDescriptionOverride]

The updated job description.

farm_id instance-attribute

farm_id: FarmId

The farm ID of the job to update.

job_id instance-attribute

job_id: JobId

The job ID to update.

lifecycle_status instance-attribute

lifecycle_status: NotRequired[UpdateJobLifecycleStatus]

The status of a job in its lifecycle. When you change the status of the job to ARCHIVED, the job can't be scheduled or archived.

An archived jobs and its steps and tasks are deleted after 120 days. The job can't be recovered.

max_failed_tasks_count instance-attribute

max_failed_tasks_count: NotRequired[MaxFailedTasksCount]

The number of task failures before the job stops running and is marked as FAILED.

max_retries_per_task instance-attribute

max_retries_per_task: NotRequired[MaxRetriesPerTask]

The maximum number of retries for a job.

max_worker_count instance-attribute

max_worker_count: NotRequired[MaxWorkerCount]

The maximum number of worker hosts that can concurrently process a job. When the maxWorkerCount is reached, no more workers will be assigned to process the job, even if the fleets assigned to the job's queue has available workers.

You can't set the maxWorkerCount to 0. If you set it to -1, there is no maximum number of workers.

If you don't specify the maxWorkerCount, the default is -1.

The maximum number of workers that can process tasks in the job.

name instance-attribute

name: NotRequired[JobName]

The updated job name.

priority instance-attribute

priority: NotRequired[JobPriority]

The updated job priority.

queue_id instance-attribute

queue_id: QueueId

The queue ID of the job to update.

target_task_run_status instance-attribute

target_task_run_status: NotRequired[JobTargetTaskRunStatus]

The task status to update the job's tasks to.