RegisterJobDefinitionRequest
¶
Source code in docs_src/capo_batch/types/register_job_definition_request.py
consumable_resource_properties
instance-attribute
¶
consumable_resource_properties: NotRequired[ConsumableResourceProperties]
Contains a list of consumable resources required by the job.
container_properties
instance-attribute
¶
container_properties: NotRequired[ContainerProperties]
An object with properties specific to Amazon ECS-based single-node container-based jobs. If the job definition's type parameter is container, then you must specify either containerProperties or nodeProperties. This must not be specified for Amazon EKS-based job definitions.
If the job runs on Fargate resources, then you must not specify nodeProperties; use only containerProperties.
ecs_properties
instance-attribute
¶
ecs_properties: NotRequired[EcsProperties]
An object with properties that are specific to Amazon ECS-based jobs. This must not be specified for Amazon EKS-based job definitions.
eks_properties
instance-attribute
¶
eks_properties: NotRequired[EksProperties]
An object with properties that are specific to Amazon EKS-based jobs. This must not be specified for Amazon ECS based job definitions.
job_definition_name
instance-attribute
¶
job_definition_name: NotRequired[String]
The name of the job definition to register. It can be up to 128 letters long. It can contain uppercase and lowercase letters, numbers, hyphens (-), and underscores (_).
node_properties
instance-attribute
¶
node_properties: NotRequired[NodeProperties]
An object with properties specific to multi-node parallel jobs. If you specify node properties for a job, it becomes a multi-node parallel job. For more information, see Multi-node Parallel Jobs in the Batch User Guide.
If the job runs on Fargate resources, then you must not specify nodeProperties; use containerProperties instead.
If the job runs on Amazon EKS resources, then you must not specify nodeProperties.
parameters
instance-attribute
¶
parameters: NotRequired[ParametersMap]
Default parameter substitution placeholders to set in the job definition. Parameters are specified as a key-value pair mapping. Parameters in a SubmitJob request override any corresponding parameter defaults from the job definition.
platform_capabilities
instance-attribute
¶
platform_capabilities: NotRequired[PlatformCapabilityList]
The platform capabilities required by the job definition. If no value is specified, it defaults to EC2. To run the job on Fargate resources, specify FARGATE. To run the job on Amazon ECS Managed Instances, specify MANAGED_INSTANCES.
Jobs with the MANAGED_INSTANCES platform capability must use ecsProperties (not containerProperties) and do not support multi-node parallel jobs.
If the job runs on Amazon EKS resources, then you must not specify platformCapabilities.
propagate_tags
instance-attribute
¶
propagate_tags: NotRequired[Boolean]
Specifies whether to propagate the tags from the job or job definition to the corresponding Amazon ECS task. If no value is specified, the tags are not propagated. Tags can only be propagated to the tasks during task creation. For tags with the same name, job tags are given priority over job definitions tags. If the total number of combined tags from the job and job definition is over 50, the job is moved to the FAILED state.
If the job runs on Amazon EKS resources, then you must not specify propagateTags.
retry_strategy
instance-attribute
¶
retry_strategy: NotRequired[RetryStrategy]
The retry strategy to use for failed jobs that are submitted with this job definition. Any retry strategy that's specified during a SubmitJob operation overrides the retry strategy defined here. If a job is terminated due to a timeout, it isn't retried.
scheduling_priority
instance-attribute
¶
scheduling_priority: NotRequired[Integer]
The scheduling priority for jobs that are submitted with this job definition. This only affects jobs in job queues with a fair-share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower scheduling priority.
The minimum supported value is 0 and the maximum supported value is 9999.
tags
instance-attribute
¶
tags: NotRequired[TagrisTagsMap]
The tags that you apply to the job definition to help you categorize and organize your resources. Each tag consists of a key and an optional value. For more information, see Tagging Amazon Web Services Resources in Batch User Guide.
timeout
instance-attribute
¶
timeout: NotRequired[JobTimeout]
The timeout configuration for jobs that are submitted with this job definition, after which Batch terminates your jobs if they have not finished. If a job is terminated due to a timeout, it isn't retried. The minimum value for the timeout is 60 seconds. Any timeout configuration that's specified during a SubmitJob operation overrides the timeout configuration defined here. For more information, see Job Timeouts in the Batch User Guide.
type
instance-attribute
¶
type: NotRequired[JobDefinitionType]
The type of job definition. For more information about multi-node parallel jobs, see Creating a multi-node parallel job definition in the Batch User Guide.
-
If the value is
container, then one of the following is required:containerProperties,ecsProperties, oreksProperties. -
If the value is
multinode, thennodePropertiesis required.
If the job is run on Fargate resources, then multinode isn't supported.