AWS Batch

2024/02/28 - AWS Batch - 4 updated api methods

Changes  This release adds Batch support for configuration of multicontainer jobs in ECS, Fargate, and EKS. This support is available for all types of jobs, including both array jobs and multi-node parallel jobs.

DescribeJobDefinitions (updated) Link ¶
Changes (response)
{'jobDefinitions': {'ecsProperties': {'taskProperties': [{'containers': [{'command': ['string'],
                                                                          'dependsOn': [{'condition': 'string',
                                                                                         'containerName': 'string'}],
                                                                          'environment': [{'name': 'string',
                                                                                           'value': 'string'}],
                                                                          'essential': 'boolean',
                                                                          'image': 'string',
                                                                          'linuxParameters': {'devices': [{'containerPath': 'string',
                                                                                                           'hostPath': 'string',
                                                                                                           'permissions': ['READ '
                                                                                                                           '| '
                                                                                                                           'WRITE '
                                                                                                                           '| '
                                                                                                                           'MKNOD']}],
                                                                                              'initProcessEnabled': 'boolean',
                                                                                              'maxSwap': 'integer',
                                                                                              'sharedMemorySize': 'integer',
                                                                                              'swappiness': 'integer',
                                                                                              'tmpfs': [{'containerPath': 'string',
                                                                                                         'mountOptions': ['string'],
                                                                                                         'size': 'integer'}]},
                                                                          'logConfiguration': {'logDriver': 'json-file '
                                                                                                            '| '
                                                                                                            'syslog '
                                                                                                            '| '
                                                                                                            'journald '
                                                                                                            '| '
                                                                                                            'gelf '
                                                                                                            '| '
                                                                                                            'fluentd '
                                                                                                            '| '
                                                                                                            'awslogs '
                                                                                                            '| '
                                                                                                            'splunk',
                                                                                               'options': {'string': 'string'},
                                                                                               'secretOptions': [{'name': 'string',
                                                                                                                  'valueFrom': 'string'}]},
                                                                          'mountPoints': [{'containerPath': 'string',
                                                                                           'readOnly': 'boolean',
                                                                                           'sourceVolume': 'string'}],
                                                                          'name': 'string',
                                                                          'privileged': 'boolean',
                                                                          'readonlyRootFilesystem': 'boolean',
                                                                          'repositoryCredentials': {'credentialsParameter': 'string'},
                                                                          'resourceRequirements': [{'type': 'GPU '
                                                                                                            '| '
                                                                                                            'VCPU '
                                                                                                            '| '
                                                                                                            'MEMORY',
                                                                                                    'value': 'string'}],
                                                                          'secrets': [{'name': 'string',
                                                                                       'valueFrom': 'string'}],
                                                                          'ulimits': [{'hardLimit': 'integer',
                                                                                       'name': 'string',
                                                                                       'softLimit': 'integer'}],
                                                                          'user': 'string'}],
                                                          'ephemeralStorage': {'sizeInGiB': 'integer'},
                                                          'executionRoleArn': 'string',
                                                          'ipcMode': 'string',
                                                          'networkConfiguration': {'assignPublicIp': 'ENABLED '
                                                                                                     '| '
                                                                                                     'DISABLED'},
                                                          'pidMode': 'string',
                                                          'platformVersion': 'string',
                                                          'runtimePlatform': {'cpuArchitecture': 'string',
                                                                              'operatingSystemFamily': 'string'},
                                                          'taskRoleArn': 'string',
                                                          'volumes': [{'efsVolumeConfiguration': {'authorizationConfig': {'accessPointId': 'string',
                                                                                                                          'iam': 'ENABLED '
                                                                                                                                 '| '
                                                                                                                                 'DISABLED'},
                                                                                                  'fileSystemId': 'string',
                                                                                                  'rootDirectory': 'string',
                                                                                                  'transitEncryption': 'ENABLED '
                                                                                                                       '| '
                                                                                                                       'DISABLED',
                                                                                                  'transitEncryptionPort': 'integer'},
                                                                       'host': {'sourcePath': 'string'},
                                                                       'name': 'string'}]}]},
                    'eksProperties': {'podProperties': {'initContainers': [{'args': ['string'],
                                                                            'command': ['string'],
                                                                            'env': [{'name': 'string',
                                                                                     'value': 'string'}],
                                                                            'image': 'string',
                                                                            'imagePullPolicy': 'string',
                                                                            'name': 'string',
                                                                            'resources': {'limits': {'string': 'string'},
                                                                                          'requests': {'string': 'string'}},
                                                                            'securityContext': {'privileged': 'boolean',
                                                                                                'readOnlyRootFilesystem': 'boolean',
                                                                                                'runAsGroup': 'long',
                                                                                                'runAsNonRoot': 'boolean',
                                                                                                'runAsUser': 'long'},
                                                                            'volumeMounts': [{'mountPath': 'string',
                                                                                              'name': 'string',
                                                                                              'readOnly': 'boolean'}]}],
                                                        'shareProcessNamespace': 'boolean'}},
                    'nodeProperties': {'nodeRangeProperties': {'ecsProperties': {'taskProperties': [{'containers': [{'command': ['string'],
                                                                                                                     'dependsOn': [{'condition': 'string',
                                                                                                                                    'containerName': 'string'}],
                                                                                                                     'environment': [{'name': 'string',
                                                                                                                                      'value': 'string'}],
                                                                                                                     'essential': 'boolean',
                                                                                                                     'image': 'string',
                                                                                                                     'linuxParameters': {'devices': [{'containerPath': 'string',
                                                                                                                                                      'hostPath': 'string',
                                                                                                                                                      'permissions': ['READ '
                                                                                                                                                                      '| '
                                                                                                                                                                      'WRITE '
                                                                                                                                                                      '| '
                                                                                                                                                                      'MKNOD']}],
                                                                                                                                         'initProcessEnabled': 'boolean',
                                                                                                                                         'maxSwap': 'integer',
                                                                                                                                         'sharedMemorySize': 'integer',
                                                                                                                                         'swappiness': 'integer',
                                                                                                                                         'tmpfs': [{'containerPath': 'string',
                                                                                                                                                    'mountOptions': ['string'],
                                                                                                                                                    'size': 'integer'}]},
                                                                                                                     'logConfiguration': {'logDriver': 'json-file '
                                                                                                                                                       '| '
                                                                                                                                                       'syslog '
                                                                                                                                                       '| '
                                                                                                                                                       'journald '
                                                                                                                                                       '| '
                                                                                                                                                       'gelf '
                                                                                                                                                       '| '
                                                                                                                                                       'fluentd '
                                                                                                                                                       '| '
                                                                                                                                                       'awslogs '
                                                                                                                                                       '| '
                                                                                                                                                       'splunk',
                                                                                                                                          'options': {'string': 'string'},
                                                                                                                                          'secretOptions': [{'name': 'string',
                                                                                                                                                             'valueFrom': 'string'}]},
                                                                                                                     'mountPoints': [{'containerPath': 'string',
                                                                                                                                      'readOnly': 'boolean',
                                                                                                                                      'sourceVolume': 'string'}],
                                                                                                                     'name': 'string',
                                                                                                                     'privileged': 'boolean',
                                                                                                                     'readonlyRootFilesystem': 'boolean',
                                                                                                                     'repositoryCredentials': {'credentialsParameter': 'string'},
                                                                                                                     'resourceRequirements': [{'type': 'GPU '
                                                                                                                                                       '| '
                                                                                                                                                       'VCPU '
                                                                                                                                                       '| '
                                                                                                                                                       'MEMORY',
                                                                                                                                               'value': 'string'}],
                                                                                                                     'secrets': [{'name': 'string',
                                                                                                                                  'valueFrom': 'string'}],
                                                                                                                     'ulimits': [{'hardLimit': 'integer',
                                                                                                                                  'name': 'string',
                                                                                                                                  'softLimit': 'integer'}],
                                                                                                                     'user': 'string'}],
                                                                                                     'ephemeralStorage': {'sizeInGiB': 'integer'},
                                                                                                     'executionRoleArn': 'string',
                                                                                                     'ipcMode': 'string',
                                                                                                     'networkConfiguration': {'assignPublicIp': 'ENABLED '
                                                                                                                                                '| '
                                                                                                                                                'DISABLED'},
                                                                                                     'pidMode': 'string',
                                                                                                     'platformVersion': 'string',
                                                                                                     'runtimePlatform': {'cpuArchitecture': 'string',
                                                                                                                         'operatingSystemFamily': 'string'},
                                                                                                     'taskRoleArn': 'string',
                                                                                                     'volumes': [{'efsVolumeConfiguration': {'authorizationConfig': {'accessPointId': 'string',
                                                                                                                                                                     'iam': 'ENABLED '
                                                                                                                                                                            '| '
                                                                                                                                                                            'DISABLED'},
                                                                                                                                             'fileSystemId': 'string',
                                                                                                                                             'rootDirectory': 'string',
                                                                                                                                             'transitEncryption': 'ENABLED '
                                                                                                                                                                  '| '
                                                                                                                                                                  'DISABLED',
                                                                                                                                             'transitEncryptionPort': 'integer'},
                                                                                                                  'host': {'sourcePath': 'string'},
                                                                                                                  'name': 'string'}]}]},
                                                               'instanceTypes': ['string']}}}}

Describes a list of job definitions. You can specify a status (such as ACTIVE ) to only return job definitions that match that status.

See also: AWS API Documentation

Request Syntax

client.describe_job_definitions(
    jobDefinitions=[
        'string',
    ],
    maxResults=123,
    jobDefinitionName='string',
    status='string',
    nextToken='string'
)
type jobDefinitions

list

param jobDefinitions

A list of up to 100 job definitions. Each entry in the list can either be an ARN in the format arn:aws:batch:${Region}:${Account}:job-definition/${JobDefinitionName}:${Revision} or a short version using the form ${JobDefinitionName}:${Revision} . This parameter can't be used with other parameters.

  • (string) --

type maxResults

integer

param maxResults

The maximum number of results returned by DescribeJobDefinitions in paginated output. When this parameter is used, DescribeJobDefinitions only returns maxResults results in a single page and a nextToken response element. The remaining results of the initial request can be seen by sending another DescribeJobDefinitions request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn't used, then DescribeJobDefinitions returns up to 100 results and a nextToken value if applicable.

type jobDefinitionName

string

param jobDefinitionName

The name of the job definition to describe.

type status

string

param status

The status used to filter job definitions.

type nextToken

string

param nextToken

The nextToken value returned from a previous paginated DescribeJobDefinitions request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.

Note

Treat this token as an opaque identifier that's only used to retrieve the next items in a list and not for other programmatic purposes.

rtype

dict

returns

Response Syntax

{
    'jobDefinitions': [
        {
            'jobDefinitionName': 'string',
            'jobDefinitionArn': 'string',
            'revision': 123,
            'status': 'string',
            'type': 'string',
            'schedulingPriority': 123,
            'parameters': {
                'string': 'string'
            },
            'retryStrategy': {
                'attempts': 123,
                'evaluateOnExit': [
                    {
                        'onStatusReason': 'string',
                        'onReason': 'string',
                        'onExitCode': 'string',
                        'action': 'RETRY'|'EXIT'
                    },
                ]
            },
            'containerProperties': {
                'image': 'string',
                'vcpus': 123,
                'memory': 123,
                'command': [
                    'string',
                ],
                'jobRoleArn': 'string',
                'executionRoleArn': 'string',
                'volumes': [
                    {
                        'host': {
                            'sourcePath': 'string'
                        },
                        'name': 'string',
                        'efsVolumeConfiguration': {
                            'fileSystemId': 'string',
                            'rootDirectory': 'string',
                            'transitEncryption': 'ENABLED'|'DISABLED',
                            'transitEncryptionPort': 123,
                            'authorizationConfig': {
                                'accessPointId': 'string',
                                'iam': 'ENABLED'|'DISABLED'
                            }
                        }
                    },
                ],
                'environment': [
                    {
                        'name': 'string',
                        'value': 'string'
                    },
                ],
                'mountPoints': [
                    {
                        'containerPath': 'string',
                        'readOnly': True|False,
                        'sourceVolume': 'string'
                    },
                ],
                'readonlyRootFilesystem': True|False,
                'privileged': True|False,
                'ulimits': [
                    {
                        'hardLimit': 123,
                        'name': 'string',
                        'softLimit': 123
                    },
                ],
                'user': 'string',
                'instanceType': 'string',
                'resourceRequirements': [
                    {
                        'value': 'string',
                        'type': 'GPU'|'VCPU'|'MEMORY'
                    },
                ],
                'linuxParameters': {
                    'devices': [
                        {
                            'hostPath': 'string',
                            'containerPath': 'string',
                            'permissions': [
                                'READ'|'WRITE'|'MKNOD',
                            ]
                        },
                    ],
                    'initProcessEnabled': True|False,
                    'sharedMemorySize': 123,
                    'tmpfs': [
                        {
                            'containerPath': 'string',
                            'size': 123,
                            'mountOptions': [
                                'string',
                            ]
                        },
                    ],
                    'maxSwap': 123,
                    'swappiness': 123
                },
                'logConfiguration': {
                    'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                    'options': {
                        'string': 'string'
                    },
                    'secretOptions': [
                        {
                            'name': 'string',
                            'valueFrom': 'string'
                        },
                    ]
                },
                'secrets': [
                    {
                        'name': 'string',
                        'valueFrom': 'string'
                    },
                ],
                'networkConfiguration': {
                    'assignPublicIp': 'ENABLED'|'DISABLED'
                },
                'fargatePlatformConfiguration': {
                    'platformVersion': 'string'
                },
                'ephemeralStorage': {
                    'sizeInGiB': 123
                },
                'runtimePlatform': {
                    'operatingSystemFamily': 'string',
                    'cpuArchitecture': 'string'
                },
                'repositoryCredentials': {
                    'credentialsParameter': 'string'
                }
            },
            'timeout': {
                'attemptDurationSeconds': 123
            },
            'nodeProperties': {
                'numNodes': 123,
                'mainNode': 123,
                'nodeRangeProperties': [
                    {
                        'targetNodes': 'string',
                        'container': {
                            'image': 'string',
                            'vcpus': 123,
                            'memory': 123,
                            'command': [
                                'string',
                            ],
                            'jobRoleArn': 'string',
                            'executionRoleArn': 'string',
                            'volumes': [
                                {
                                    'host': {
                                        'sourcePath': 'string'
                                    },
                                    'name': 'string',
                                    'efsVolumeConfiguration': {
                                        'fileSystemId': 'string',
                                        'rootDirectory': 'string',
                                        'transitEncryption': 'ENABLED'|'DISABLED',
                                        'transitEncryptionPort': 123,
                                        'authorizationConfig': {
                                            'accessPointId': 'string',
                                            'iam': 'ENABLED'|'DISABLED'
                                        }
                                    }
                                },
                            ],
                            'environment': [
                                {
                                    'name': 'string',
                                    'value': 'string'
                                },
                            ],
                            'mountPoints': [
                                {
                                    'containerPath': 'string',
                                    'readOnly': True|False,
                                    'sourceVolume': 'string'
                                },
                            ],
                            'readonlyRootFilesystem': True|False,
                            'privileged': True|False,
                            'ulimits': [
                                {
                                    'hardLimit': 123,
                                    'name': 'string',
                                    'softLimit': 123
                                },
                            ],
                            'user': 'string',
                            'instanceType': 'string',
                            'resourceRequirements': [
                                {
                                    'value': 'string',
                                    'type': 'GPU'|'VCPU'|'MEMORY'
                                },
                            ],
                            'linuxParameters': {
                                'devices': [
                                    {
                                        'hostPath': 'string',
                                        'containerPath': 'string',
                                        'permissions': [
                                            'READ'|'WRITE'|'MKNOD',
                                        ]
                                    },
                                ],
                                'initProcessEnabled': True|False,
                                'sharedMemorySize': 123,
                                'tmpfs': [
                                    {
                                        'containerPath': 'string',
                                        'size': 123,
                                        'mountOptions': [
                                            'string',
                                        ]
                                    },
                                ],
                                'maxSwap': 123,
                                'swappiness': 123
                            },
                            'logConfiguration': {
                                'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                                'options': {
                                    'string': 'string'
                                },
                                'secretOptions': [
                                    {
                                        'name': 'string',
                                        'valueFrom': 'string'
                                    },
                                ]
                            },
                            'secrets': [
                                {
                                    'name': 'string',
                                    'valueFrom': 'string'
                                },
                            ],
                            'networkConfiguration': {
                                'assignPublicIp': 'ENABLED'|'DISABLED'
                            },
                            'fargatePlatformConfiguration': {
                                'platformVersion': 'string'
                            },
                            'ephemeralStorage': {
                                'sizeInGiB': 123
                            },
                            'runtimePlatform': {
                                'operatingSystemFamily': 'string',
                                'cpuArchitecture': 'string'
                            },
                            'repositoryCredentials': {
                                'credentialsParameter': 'string'
                            }
                        },
                        'instanceTypes': [
                            'string',
                        ],
                        'ecsProperties': {
                            'taskProperties': [
                                {
                                    'containers': [
                                        {
                                            'command': [
                                                'string',
                                            ],
                                            'dependsOn': [
                                                {
                                                    'containerName': 'string',
                                                    'condition': 'string'
                                                },
                                            ],
                                            'environment': [
                                                {
                                                    'name': 'string',
                                                    'value': 'string'
                                                },
                                            ],
                                            'essential': True|False,
                                            'image': 'string',
                                            'linuxParameters': {
                                                'devices': [
                                                    {
                                                        'hostPath': 'string',
                                                        'containerPath': 'string',
                                                        'permissions': [
                                                            'READ'|'WRITE'|'MKNOD',
                                                        ]
                                                    },
                                                ],
                                                'initProcessEnabled': True|False,
                                                'sharedMemorySize': 123,
                                                'tmpfs': [
                                                    {
                                                        'containerPath': 'string',
                                                        'size': 123,
                                                        'mountOptions': [
                                                            'string',
                                                        ]
                                                    },
                                                ],
                                                'maxSwap': 123,
                                                'swappiness': 123
                                            },
                                            'logConfiguration': {
                                                'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                                                'options': {
                                                    'string': 'string'
                                                },
                                                'secretOptions': [
                                                    {
                                                        'name': 'string',
                                                        'valueFrom': 'string'
                                                    },
                                                ]
                                            },
                                            'mountPoints': [
                                                {
                                                    'containerPath': 'string',
                                                    'readOnly': True|False,
                                                    'sourceVolume': 'string'
                                                },
                                            ],
                                            'name': 'string',
                                            'privileged': True|False,
                                            'readonlyRootFilesystem': True|False,
                                            'repositoryCredentials': {
                                                'credentialsParameter': 'string'
                                            },
                                            'resourceRequirements': [
                                                {
                                                    'value': 'string',
                                                    'type': 'GPU'|'VCPU'|'MEMORY'
                                                },
                                            ],
                                            'secrets': [
                                                {
                                                    'name': 'string',
                                                    'valueFrom': 'string'
                                                },
                                            ],
                                            'ulimits': [
                                                {
                                                    'hardLimit': 123,
                                                    'name': 'string',
                                                    'softLimit': 123
                                                },
                                            ],
                                            'user': 'string'
                                        },
                                    ],
                                    'ephemeralStorage': {
                                        'sizeInGiB': 123
                                    },
                                    'executionRoleArn': 'string',
                                    'platformVersion': 'string',
                                    'ipcMode': 'string',
                                    'taskRoleArn': 'string',
                                    'pidMode': 'string',
                                    'networkConfiguration': {
                                        'assignPublicIp': 'ENABLED'|'DISABLED'
                                    },
                                    'runtimePlatform': {
                                        'operatingSystemFamily': 'string',
                                        'cpuArchitecture': 'string'
                                    },
                                    'volumes': [
                                        {
                                            'host': {
                                                'sourcePath': 'string'
                                            },
                                            'name': 'string',
                                            'efsVolumeConfiguration': {
                                                'fileSystemId': 'string',
                                                'rootDirectory': 'string',
                                                'transitEncryption': 'ENABLED'|'DISABLED',
                                                'transitEncryptionPort': 123,
                                                'authorizationConfig': {
                                                    'accessPointId': 'string',
                                                    'iam': 'ENABLED'|'DISABLED'
                                                }
                                            }
                                        },
                                    ]
                                },
                            ]
                        }
                    },
                ]
            },
            'tags': {
                'string': 'string'
            },
            'propagateTags': True|False,
            'platformCapabilities': [
                'EC2'|'FARGATE',
            ],
            'ecsProperties': {
                'taskProperties': [
                    {
                        'containers': [
                            {
                                'command': [
                                    'string',
                                ],
                                'dependsOn': [
                                    {
                                        'containerName': 'string',
                                        'condition': 'string'
                                    },
                                ],
                                'environment': [
                                    {
                                        'name': 'string',
                                        'value': 'string'
                                    },
                                ],
                                'essential': True|False,
                                'image': 'string',
                                'linuxParameters': {
                                    'devices': [
                                        {
                                            'hostPath': 'string',
                                            'containerPath': 'string',
                                            'permissions': [
                                                'READ'|'WRITE'|'MKNOD',
                                            ]
                                        },
                                    ],
                                    'initProcessEnabled': True|False,
                                    'sharedMemorySize': 123,
                                    'tmpfs': [
                                        {
                                            'containerPath': 'string',
                                            'size': 123,
                                            'mountOptions': [
                                                'string',
                                            ]
                                        },
                                    ],
                                    'maxSwap': 123,
                                    'swappiness': 123
                                },
                                'logConfiguration': {
                                    'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                                    'options': {
                                        'string': 'string'
                                    },
                                    'secretOptions': [
                                        {
                                            'name': 'string',
                                            'valueFrom': 'string'
                                        },
                                    ]
                                },
                                'mountPoints': [
                                    {
                                        'containerPath': 'string',
                                        'readOnly': True|False,
                                        'sourceVolume': 'string'
                                    },
                                ],
                                'name': 'string',
                                'privileged': True|False,
                                'readonlyRootFilesystem': True|False,
                                'repositoryCredentials': {
                                    'credentialsParameter': 'string'
                                },
                                'resourceRequirements': [
                                    {
                                        'value': 'string',
                                        'type': 'GPU'|'VCPU'|'MEMORY'
                                    },
                                ],
                                'secrets': [
                                    {
                                        'name': 'string',
                                        'valueFrom': 'string'
                                    },
                                ],
                                'ulimits': [
                                    {
                                        'hardLimit': 123,
                                        'name': 'string',
                                        'softLimit': 123
                                    },
                                ],
                                'user': 'string'
                            },
                        ],
                        'ephemeralStorage': {
                            'sizeInGiB': 123
                        },
                        'executionRoleArn': 'string',
                        'platformVersion': 'string',
                        'ipcMode': 'string',
                        'taskRoleArn': 'string',
                        'pidMode': 'string',
                        'networkConfiguration': {
                            'assignPublicIp': 'ENABLED'|'DISABLED'
                        },
                        'runtimePlatform': {
                            'operatingSystemFamily': 'string',
                            'cpuArchitecture': 'string'
                        },
                        'volumes': [
                            {
                                'host': {
                                    'sourcePath': 'string'
                                },
                                'name': 'string',
                                'efsVolumeConfiguration': {
                                    'fileSystemId': 'string',
                                    'rootDirectory': 'string',
                                    'transitEncryption': 'ENABLED'|'DISABLED',
                                    'transitEncryptionPort': 123,
                                    'authorizationConfig': {
                                        'accessPointId': 'string',
                                        'iam': 'ENABLED'|'DISABLED'
                                    }
                                }
                            },
                        ]
                    },
                ]
            },
            'eksProperties': {
                'podProperties': {
                    'serviceAccountName': 'string',
                    'hostNetwork': True|False,
                    'dnsPolicy': 'string',
                    'containers': [
                        {
                            'name': 'string',
                            'image': 'string',
                            'imagePullPolicy': 'string',
                            'command': [
                                'string',
                            ],
                            'args': [
                                'string',
                            ],
                            'env': [
                                {
                                    'name': 'string',
                                    'value': 'string'
                                },
                            ],
                            'resources': {
                                'limits': {
                                    'string': 'string'
                                },
                                'requests': {
                                    'string': 'string'
                                }
                            },
                            'volumeMounts': [
                                {
                                    'name': 'string',
                                    'mountPath': 'string',
                                    'readOnly': True|False
                                },
                            ],
                            'securityContext': {
                                'runAsUser': 123,
                                'runAsGroup': 123,
                                'privileged': True|False,
                                'readOnlyRootFilesystem': True|False,
                                'runAsNonRoot': True|False
                            }
                        },
                    ],
                    'initContainers': [
                        {
                            'name': 'string',
                            'image': 'string',
                            'imagePullPolicy': 'string',
                            'command': [
                                'string',
                            ],
                            'args': [
                                'string',
                            ],
                            'env': [
                                {
                                    'name': 'string',
                                    'value': 'string'
                                },
                            ],
                            'resources': {
                                'limits': {
                                    'string': 'string'
                                },
                                'requests': {
                                    'string': 'string'
                                }
                            },
                            'volumeMounts': [
                                {
                                    'name': 'string',
                                    'mountPath': 'string',
                                    'readOnly': True|False
                                },
                            ],
                            'securityContext': {
                                'runAsUser': 123,
                                'runAsGroup': 123,
                                'privileged': True|False,
                                'readOnlyRootFilesystem': True|False,
                                'runAsNonRoot': True|False
                            }
                        },
                    ],
                    'volumes': [
                        {
                            'name': 'string',
                            'hostPath': {
                                'path': 'string'
                            },
                            'emptyDir': {
                                'medium': 'string',
                                'sizeLimit': 'string'
                            },
                            'secret': {
                                'secretName': 'string',
                                'optional': True|False
                            }
                        },
                    ],
                    'metadata': {
                        'labels': {
                            'string': 'string'
                        }
                    },
                    'shareProcessNamespace': True|False
                }
            },
            'containerOrchestrationType': 'ECS'|'EKS'
        },
    ],
    'nextToken': 'string'
}

**Response Structure**
::

    # This section is too large to render.
    # Please see the AWS API Documentation linked below.

`AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/DescribeJobDefinitions>`_
DescribeJobs (updated) Link ¶
Changes (response)
{'jobs': {'ecsProperties': {'taskProperties': [{'containerInstanceArn': 'string',
                                                'containers': [{'command': ['string'],
                                                                'dependsOn': [{'condition': 'string',
                                                                               'containerName': 'string'}],
                                                                'environment': [{'name': 'string',
                                                                                 'value': 'string'}],
                                                                'essential': 'boolean',
                                                                'exitCode': 'integer',
                                                                'image': 'string',
                                                                'linuxParameters': {'devices': [{'containerPath': 'string',
                                                                                                 'hostPath': 'string',
                                                                                                 'permissions': ['READ '
                                                                                                                 '| '
                                                                                                                 'WRITE '
                                                                                                                 '| '
                                                                                                                 'MKNOD']}],
                                                                                    'initProcessEnabled': 'boolean',
                                                                                    'maxSwap': 'integer',
                                                                                    'sharedMemorySize': 'integer',
                                                                                    'swappiness': 'integer',
                                                                                    'tmpfs': [{'containerPath': 'string',
                                                                                               'mountOptions': ['string'],
                                                                                               'size': 'integer'}]},
                                                                'logConfiguration': {'logDriver': 'json-file '
                                                                                                  '| '
                                                                                                  'syslog '
                                                                                                  '| '
                                                                                                  'journald '
                                                                                                  '| '
                                                                                                  'gelf '
                                                                                                  '| '
                                                                                                  'fluentd '
                                                                                                  '| '
                                                                                                  'awslogs '
                                                                                                  '| '
                                                                                                  'splunk',
                                                                                     'options': {'string': 'string'},
                                                                                     'secretOptions': [{'name': 'string',
                                                                                                        'valueFrom': 'string'}]},
                                                                'logStreamName': 'string',
                                                                'mountPoints': [{'containerPath': 'string',
                                                                                 'readOnly': 'boolean',
                                                                                 'sourceVolume': 'string'}],
                                                                'name': 'string',
                                                                'networkInterfaces': [{'attachmentId': 'string',
                                                                                       'ipv6Address': 'string',
                                                                                       'privateIpv4Address': 'string'}],
                                                                'privileged': 'boolean',
                                                                'readonlyRootFilesystem': 'boolean',
                                                                'reason': 'string',
                                                                'repositoryCredentials': {'credentialsParameter': 'string'},
                                                                'resourceRequirements': [{'type': 'GPU '
                                                                                                  '| '
                                                                                                  'VCPU '
                                                                                                  '| '
                                                                                                  'MEMORY',
                                                                                          'value': 'string'}],
                                                                'secrets': [{'name': 'string',
                                                                             'valueFrom': 'string'}],
                                                                'ulimits': [{'hardLimit': 'integer',
                                                                             'name': 'string',
                                                                             'softLimit': 'integer'}],
                                                                'user': 'string'}],
                                                'ephemeralStorage': {'sizeInGiB': 'integer'},
                                                'executionRoleArn': 'string',
                                                'ipcMode': 'string',
                                                'networkConfiguration': {'assignPublicIp': 'ENABLED '
                                                                                           '| '
                                                                                           'DISABLED'},
                                                'pidMode': 'string',
                                                'platformVersion': 'string',
                                                'runtimePlatform': {'cpuArchitecture': 'string',
                                                                    'operatingSystemFamily': 'string'},
                                                'taskArn': 'string',
                                                'taskRoleArn': 'string',
                                                'volumes': [{'efsVolumeConfiguration': {'authorizationConfig': {'accessPointId': 'string',
                                                                                                                'iam': 'ENABLED '
                                                                                                                       '| '
                                                                                                                       'DISABLED'},
                                                                                        'fileSystemId': 'string',
                                                                                        'rootDirectory': 'string',
                                                                                        'transitEncryption': 'ENABLED '
                                                                                                             '| '
                                                                                                             'DISABLED',
                                                                                        'transitEncryptionPort': 'integer'},
                                                             'host': {'sourcePath': 'string'},
                                                             'name': 'string'}]}]},
          'eksAttempts': {'initContainers': [{'exitCode': 'integer',
                                              'reason': 'string'}]},
          'eksProperties': {'podProperties': {'initContainers': [{'args': ['string'],
                                                                  'command': ['string'],
                                                                  'env': [{'name': 'string',
                                                                           'value': 'string'}],
                                                                  'exitCode': 'integer',
                                                                  'image': 'string',
                                                                  'imagePullPolicy': 'string',
                                                                  'name': 'string',
                                                                  'reason': 'string',
                                                                  'resources': {'limits': {'string': 'string'},
                                                                                'requests': {'string': 'string'}},
                                                                  'securityContext': {'privileged': 'boolean',
                                                                                      'readOnlyRootFilesystem': 'boolean',
                                                                                      'runAsGroup': 'long',
                                                                                      'runAsNonRoot': 'boolean',
                                                                                      'runAsUser': 'long'},
                                                                  'volumeMounts': [{'mountPath': 'string',
                                                                                    'name': 'string',
                                                                                    'readOnly': 'boolean'}]}],
                                              'shareProcessNamespace': 'boolean'}},
          'nodeProperties': {'nodeRangeProperties': {'ecsProperties': {'taskProperties': [{'containers': [{'command': ['string'],
                                                                                                           'dependsOn': [{'condition': 'string',
                                                                                                                          'containerName': 'string'}],
                                                                                                           'environment': [{'name': 'string',
                                                                                                                            'value': 'string'}],
                                                                                                           'essential': 'boolean',
                                                                                                           'image': 'string',
                                                                                                           'linuxParameters': {'devices': [{'containerPath': 'string',
                                                                                                                                            'hostPath': 'string',
                                                                                                                                            'permissions': ['READ '
                                                                                                                                                            '| '
                                                                                                                                                            'WRITE '
                                                                                                                                                            '| '
                                                                                                                                                            'MKNOD']}],
                                                                                                                               'initProcessEnabled': 'boolean',
                                                                                                                               'maxSwap': 'integer',
                                                                                                                               'sharedMemorySize': 'integer',
                                                                                                                               'swappiness': 'integer',
                                                                                                                               'tmpfs': [{'containerPath': 'string',
                                                                                                                                          'mountOptions': ['string'],
                                                                                                                                          'size': 'integer'}]},
                                                                                                           'logConfiguration': {'logDriver': 'json-file '
                                                                                                                                             '| '
                                                                                                                                             'syslog '
                                                                                                                                             '| '
                                                                                                                                             'journald '
                                                                                                                                             '| '
                                                                                                                                             'gelf '
                                                                                                                                             '| '
                                                                                                                                             'fluentd '
                                                                                                                                             '| '
                                                                                                                                             'awslogs '
                                                                                                                                             '| '
                                                                                                                                             'splunk',
                                                                                                                                'options': {'string': 'string'},
                                                                                                                                'secretOptions': [{'name': 'string',
                                                                                                                                                   'valueFrom': 'string'}]},
                                                                                                           'mountPoints': [{'containerPath': 'string',
                                                                                                                            'readOnly': 'boolean',
                                                                                                                            'sourceVolume': 'string'}],
                                                                                                           'name': 'string',
                                                                                                           'privileged': 'boolean',
                                                                                                           'readonlyRootFilesystem': 'boolean',
                                                                                                           'repositoryCredentials': {'credentialsParameter': 'string'},
                                                                                                           'resourceRequirements': [{'type': 'GPU '
                                                                                                                                             '| '
                                                                                                                                             'VCPU '
                                                                                                                                             '| '
                                                                                                                                             'MEMORY',
                                                                                                                                     'value': 'string'}],
                                                                                                           'secrets': [{'name': 'string',
                                                                                                                        'valueFrom': 'string'}],
                                                                                                           'ulimits': [{'hardLimit': 'integer',
                                                                                                                        'name': 'string',
                                                                                                                        'softLimit': 'integer'}],
                                                                                                           'user': 'string'}],
                                                                                           'ephemeralStorage': {'sizeInGiB': 'integer'},
                                                                                           'executionRoleArn': 'string',
                                                                                           'ipcMode': 'string',
                                                                                           'networkConfiguration': {'assignPublicIp': 'ENABLED '
                                                                                                                                      '| '
                                                                                                                                      'DISABLED'},
                                                                                           'pidMode': 'string',
                                                                                           'platformVersion': 'string',
                                                                                           'runtimePlatform': {'cpuArchitecture': 'string',
                                                                                                               'operatingSystemFamily': 'string'},
                                                                                           'taskRoleArn': 'string',
                                                                                           'volumes': [{'efsVolumeConfiguration': {'authorizationConfig': {'accessPointId': 'string',
                                                                                                                                                           'iam': 'ENABLED '
                                                                                                                                                                  '| '
                                                                                                                                                                  'DISABLED'},
                                                                                                                                   'fileSystemId': 'string',
                                                                                                                                   'rootDirectory': 'string',
                                                                                                                                   'transitEncryption': 'ENABLED '
                                                                                                                                                        '| '
                                                                                                                                                        'DISABLED',
                                                                                                                                   'transitEncryptionPort': 'integer'},
                                                                                                        'host': {'sourcePath': 'string'},
                                                                                                        'name': 'string'}]}]},
                                                     'instanceTypes': ['string']}}}}

Describes a list of Batch jobs.

See also: AWS API Documentation

Request Syntax

client.describe_jobs(
    jobs=[
        'string',
    ]
)
type jobs

list

param jobs

[REQUIRED]

A list of up to 100 job IDs.

  • (string) --

rtype

dict

returns

Response Syntax

{
    'jobs': [
        {
            'jobArn': 'string',
            'jobName': 'string',
            'jobId': 'string',
            'jobQueue': 'string',
            'status': 'SUBMITTED'|'PENDING'|'RUNNABLE'|'STARTING'|'RUNNING'|'SUCCEEDED'|'FAILED',
            'shareIdentifier': 'string',
            'schedulingPriority': 123,
            'attempts': [
                {
                    'container': {
                        'containerInstanceArn': 'string',
                        'taskArn': 'string',
                        'exitCode': 123,
                        'reason': 'string',
                        'logStreamName': 'string',
                        'networkInterfaces': [
                            {
                                'attachmentId': 'string',
                                'ipv6Address': 'string',
                                'privateIpv4Address': 'string'
                            },
                        ]
                    },
                    'startedAt': 123,
                    'stoppedAt': 123,
                    'statusReason': 'string'
                },
            ],
            'statusReason': 'string',
            'createdAt': 123,
            'retryStrategy': {
                'attempts': 123,
                'evaluateOnExit': [
                    {
                        'onStatusReason': 'string',
                        'onReason': 'string',
                        'onExitCode': 'string',
                        'action': 'RETRY'|'EXIT'
                    },
                ]
            },
            'startedAt': 123,
            'stoppedAt': 123,
            'dependsOn': [
                {
                    'jobId': 'string',
                    'type': 'N_TO_N'|'SEQUENTIAL'
                },
            ],
            'jobDefinition': 'string',
            'parameters': {
                'string': 'string'
            },
            'container': {
                'image': 'string',
                'vcpus': 123,
                'memory': 123,
                'command': [
                    'string',
                ],
                'jobRoleArn': 'string',
                'executionRoleArn': 'string',
                'volumes': [
                    {
                        'host': {
                            'sourcePath': 'string'
                        },
                        'name': 'string',
                        'efsVolumeConfiguration': {
                            'fileSystemId': 'string',
                            'rootDirectory': 'string',
                            'transitEncryption': 'ENABLED'|'DISABLED',
                            'transitEncryptionPort': 123,
                            'authorizationConfig': {
                                'accessPointId': 'string',
                                'iam': 'ENABLED'|'DISABLED'
                            }
                        }
                    },
                ],
                'environment': [
                    {
                        'name': 'string',
                        'value': 'string'
                    },
                ],
                'mountPoints': [
                    {
                        'containerPath': 'string',
                        'readOnly': True|False,
                        'sourceVolume': 'string'
                    },
                ],
                'readonlyRootFilesystem': True|False,
                'ulimits': [
                    {
                        'hardLimit': 123,
                        'name': 'string',
                        'softLimit': 123
                    },
                ],
                'privileged': True|False,
                'user': 'string',
                'exitCode': 123,
                'reason': 'string',
                'containerInstanceArn': 'string',
                'taskArn': 'string',
                'logStreamName': 'string',
                'instanceType': 'string',
                'networkInterfaces': [
                    {
                        'attachmentId': 'string',
                        'ipv6Address': 'string',
                        'privateIpv4Address': 'string'
                    },
                ],
                'resourceRequirements': [
                    {
                        'value': 'string',
                        'type': 'GPU'|'VCPU'|'MEMORY'
                    },
                ],
                'linuxParameters': {
                    'devices': [
                        {
                            'hostPath': 'string',
                            'containerPath': 'string',
                            'permissions': [
                                'READ'|'WRITE'|'MKNOD',
                            ]
                        },
                    ],
                    'initProcessEnabled': True|False,
                    'sharedMemorySize': 123,
                    'tmpfs': [
                        {
                            'containerPath': 'string',
                            'size': 123,
                            'mountOptions': [
                                'string',
                            ]
                        },
                    ],
                    'maxSwap': 123,
                    'swappiness': 123
                },
                'logConfiguration': {
                    'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                    'options': {
                        'string': 'string'
                    },
                    'secretOptions': [
                        {
                            'name': 'string',
                            'valueFrom': 'string'
                        },
                    ]
                },
                'secrets': [
                    {
                        'name': 'string',
                        'valueFrom': 'string'
                    },
                ],
                'networkConfiguration': {
                    'assignPublicIp': 'ENABLED'|'DISABLED'
                },
                'fargatePlatformConfiguration': {
                    'platformVersion': 'string'
                },
                'ephemeralStorage': {
                    'sizeInGiB': 123
                },
                'runtimePlatform': {
                    'operatingSystemFamily': 'string',
                    'cpuArchitecture': 'string'
                },
                'repositoryCredentials': {
                    'credentialsParameter': 'string'
                }
            },
            'nodeDetails': {
                'nodeIndex': 123,
                'isMainNode': True|False
            },
            'nodeProperties': {
                'numNodes': 123,
                'mainNode': 123,
                'nodeRangeProperties': [
                    {
                        'targetNodes': 'string',
                        'container': {
                            'image': 'string',
                            'vcpus': 123,
                            'memory': 123,
                            'command': [
                                'string',
                            ],
                            'jobRoleArn': 'string',
                            'executionRoleArn': 'string',
                            'volumes': [
                                {
                                    'host': {
                                        'sourcePath': 'string'
                                    },
                                    'name': 'string',
                                    'efsVolumeConfiguration': {
                                        'fileSystemId': 'string',
                                        'rootDirectory': 'string',
                                        'transitEncryption': 'ENABLED'|'DISABLED',
                                        'transitEncryptionPort': 123,
                                        'authorizationConfig': {
                                            'accessPointId': 'string',
                                            'iam': 'ENABLED'|'DISABLED'
                                        }
                                    }
                                },
                            ],
                            'environment': [
                                {
                                    'name': 'string',
                                    'value': 'string'
                                },
                            ],
                            'mountPoints': [
                                {
                                    'containerPath': 'string',
                                    'readOnly': True|False,
                                    'sourceVolume': 'string'
                                },
                            ],
                            'readonlyRootFilesystem': True|False,
                            'privileged': True|False,
                            'ulimits': [
                                {
                                    'hardLimit': 123,
                                    'name': 'string',
                                    'softLimit': 123
                                },
                            ],
                            'user': 'string',
                            'instanceType': 'string',
                            'resourceRequirements': [
                                {
                                    'value': 'string',
                                    'type': 'GPU'|'VCPU'|'MEMORY'
                                },
                            ],
                            'linuxParameters': {
                                'devices': [
                                    {
                                        'hostPath': 'string',
                                        'containerPath': 'string',
                                        'permissions': [
                                            'READ'|'WRITE'|'MKNOD',
                                        ]
                                    },
                                ],
                                'initProcessEnabled': True|False,
                                'sharedMemorySize': 123,
                                'tmpfs': [
                                    {
                                        'containerPath': 'string',
                                        'size': 123,
                                        'mountOptions': [
                                            'string',
                                        ]
                                    },
                                ],
                                'maxSwap': 123,
                                'swappiness': 123
                            },
                            'logConfiguration': {
                                'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                                'options': {
                                    'string': 'string'
                                },
                                'secretOptions': [
                                    {
                                        'name': 'string',
                                        'valueFrom': 'string'
                                    },
                                ]
                            },
                            'secrets': [
                                {
                                    'name': 'string',
                                    'valueFrom': 'string'
                                },
                            ],
                            'networkConfiguration': {
                                'assignPublicIp': 'ENABLED'|'DISABLED'
                            },
                            'fargatePlatformConfiguration': {
                                'platformVersion': 'string'
                            },
                            'ephemeralStorage': {
                                'sizeInGiB': 123
                            },
                            'runtimePlatform': {
                                'operatingSystemFamily': 'string',
                                'cpuArchitecture': 'string'
                            },
                            'repositoryCredentials': {
                                'credentialsParameter': 'string'
                            }
                        },
                        'instanceTypes': [
                            'string',
                        ],
                        'ecsProperties': {
                            'taskProperties': [
                                {
                                    'containers': [
                                        {
                                            'command': [
                                                'string',
                                            ],
                                            'dependsOn': [
                                                {
                                                    'containerName': 'string',
                                                    'condition': 'string'
                                                },
                                            ],
                                            'environment': [
                                                {
                                                    'name': 'string',
                                                    'value': 'string'
                                                },
                                            ],
                                            'essential': True|False,
                                            'image': 'string',
                                            'linuxParameters': {
                                                'devices': [
                                                    {
                                                        'hostPath': 'string',
                                                        'containerPath': 'string',
                                                        'permissions': [
                                                            'READ'|'WRITE'|'MKNOD',
                                                        ]
                                                    },
                                                ],
                                                'initProcessEnabled': True|False,
                                                'sharedMemorySize': 123,
                                                'tmpfs': [
                                                    {
                                                        'containerPath': 'string',
                                                        'size': 123,
                                                        'mountOptions': [
                                                            'string',
                                                        ]
                                                    },
                                                ],
                                                'maxSwap': 123,
                                                'swappiness': 123
                                            },
                                            'logConfiguration': {
                                                'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                                                'options': {
                                                    'string': 'string'
                                                },
                                                'secretOptions': [
                                                    {
                                                        'name': 'string',
                                                        'valueFrom': 'string'
                                                    },
                                                ]
                                            },
                                            'mountPoints': [
                                                {
                                                    'containerPath': 'string',
                                                    'readOnly': True|False,
                                                    'sourceVolume': 'string'
                                                },
                                            ],
                                            'name': 'string',
                                            'privileged': True|False,
                                            'readonlyRootFilesystem': True|False,
                                            'repositoryCredentials': {
                                                'credentialsParameter': 'string'
                                            },
                                            'resourceRequirements': [
                                                {
                                                    'value': 'string',
                                                    'type': 'GPU'|'VCPU'|'MEMORY'
                                                },
                                            ],
                                            'secrets': [
                                                {
                                                    'name': 'string',
                                                    'valueFrom': 'string'
                                                },
                                            ],
                                            'ulimits': [
                                                {
                                                    'hardLimit': 123,
                                                    'name': 'string',
                                                    'softLimit': 123
                                                },
                                            ],
                                            'user': 'string'
                                        },
                                    ],
                                    'ephemeralStorage': {
                                        'sizeInGiB': 123
                                    },
                                    'executionRoleArn': 'string',
                                    'platformVersion': 'string',
                                    'ipcMode': 'string',
                                    'taskRoleArn': 'string',
                                    'pidMode': 'string',
                                    'networkConfiguration': {
                                        'assignPublicIp': 'ENABLED'|'DISABLED'
                                    },
                                    'runtimePlatform': {
                                        'operatingSystemFamily': 'string',
                                        'cpuArchitecture': 'string'
                                    },
                                    'volumes': [
                                        {
                                            'host': {
                                                'sourcePath': 'string'
                                            },
                                            'name': 'string',
                                            'efsVolumeConfiguration': {
                                                'fileSystemId': 'string',
                                                'rootDirectory': 'string',
                                                'transitEncryption': 'ENABLED'|'DISABLED',
                                                'transitEncryptionPort': 123,
                                                'authorizationConfig': {
                                                    'accessPointId': 'string',
                                                    'iam': 'ENABLED'|'DISABLED'
                                                }
                                            }
                                        },
                                    ]
                                },
                            ]
                        }
                    },
                ]
            },
            'arrayProperties': {
                'statusSummary': {
                    'string': 123
                },
                'size': 123,
                'index': 123
            },
            'timeout': {
                'attemptDurationSeconds': 123
            },
            'tags': {
                'string': 'string'
            },
            'propagateTags': True|False,
            'platformCapabilities': [
                'EC2'|'FARGATE',
            ],
            'eksProperties': {
                'podProperties': {
                    'serviceAccountName': 'string',
                    'hostNetwork': True|False,
                    'dnsPolicy': 'string',
                    'containers': [
                        {
                            'name': 'string',
                            'image': 'string',
                            'imagePullPolicy': 'string',
                            'command': [
                                'string',
                            ],
                            'args': [
                                'string',
                            ],
                            'env': [
                                {
                                    'name': 'string',
                                    'value': 'string'
                                },
                            ],
                            'resources': {
                                'limits': {
                                    'string': 'string'
                                },
                                'requests': {
                                    'string': 'string'
                                }
                            },
                            'exitCode': 123,
                            'reason': 'string',
                            'volumeMounts': [
                                {
                                    'name': 'string',
                                    'mountPath': 'string',
                                    'readOnly': True|False
                                },
                            ],
                            'securityContext': {
                                'runAsUser': 123,
                                'runAsGroup': 123,
                                'privileged': True|False,
                                'readOnlyRootFilesystem': True|False,
                                'runAsNonRoot': True|False
                            }
                        },
                    ],
                    'initContainers': [
                        {
                            'name': 'string',
                            'image': 'string',
                            'imagePullPolicy': 'string',
                            'command': [
                                'string',
                            ],
                            'args': [
                                'string',
                            ],
                            'env': [
                                {
                                    'name': 'string',
                                    'value': 'string'
                                },
                            ],
                            'resources': {
                                'limits': {
                                    'string': 'string'
                                },
                                'requests': {
                                    'string': 'string'
                                }
                            },
                            'exitCode': 123,
                            'reason': 'string',
                            'volumeMounts': [
                                {
                                    'name': 'string',
                                    'mountPath': 'string',
                                    'readOnly': True|False
                                },
                            ],
                            'securityContext': {
                                'runAsUser': 123,
                                'runAsGroup': 123,
                                'privileged': True|False,
                                'readOnlyRootFilesystem': True|False,
                                'runAsNonRoot': True|False
                            }
                        },
                    ],
                    'volumes': [
                        {
                            'name': 'string',
                            'hostPath': {
                                'path': 'string'
                            },
                            'emptyDir': {
                                'medium': 'string',
                                'sizeLimit': 'string'
                            },
                            'secret': {
                                'secretName': 'string',
                                'optional': True|False
                            }
                        },
                    ],
                    'podName': 'string',
                    'nodeName': 'string',
                    'metadata': {
                        'labels': {
                            'string': 'string'
                        }
                    },
                    'shareProcessNamespace': True|False
                }
            },
            'eksAttempts': [
                {
                    'containers': [
                        {
                            'exitCode': 123,
                            'reason': 'string'
                        },
                    ],
                    'initContainers': [
                        {
                            'exitCode': 123,
                            'reason': 'string'
                        },
                    ],
                    'podName': 'string',
                    'nodeName': 'string',
                    'startedAt': 123,
                    'stoppedAt': 123,
                    'statusReason': 'string'
                },
            ],
            'ecsProperties': {
                'taskProperties': [
                    {
                        'containers': [
                            {
                                'command': [
                                    'string',
                                ],
                                'dependsOn': [
                                    {
                                        'containerName': 'string',
                                        'condition': 'string'
                                    },
                                ],
                                'environment': [
                                    {
                                        'name': 'string',
                                        'value': 'string'
                                    },
                                ],
                                'essential': True|False,
                                'image': 'string',
                                'linuxParameters': {
                                    'devices': [
                                        {
                                            'hostPath': 'string',
                                            'containerPath': 'string',
                                            'permissions': [
                                                'READ'|'WRITE'|'MKNOD',
                                            ]
                                        },
                                    ],
                                    'initProcessEnabled': True|False,
                                    'sharedMemorySize': 123,
                                    'tmpfs': [
                                        {
                                            'containerPath': 'string',
                                            'size': 123,
                                            'mountOptions': [
                                                'string',
                                            ]
                                        },
                                    ],
                                    'maxSwap': 123,
                                    'swappiness': 123
                                },
                                'logConfiguration': {
                                    'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                                    'options': {
                                        'string': 'string'
                                    },
                                    'secretOptions': [
                                        {
                                            'name': 'string',
                                            'valueFrom': 'string'
                                        },
                                    ]
                                },
                                'mountPoints': [
                                    {
                                        'containerPath': 'string',
                                        'readOnly': True|False,
                                        'sourceVolume': 'string'
                                    },
                                ],
                                'name': 'string',
                                'privileged': True|False,
                                'readonlyRootFilesystem': True|False,
                                'repositoryCredentials': {
                                    'credentialsParameter': 'string'
                                },
                                'resourceRequirements': [
                                    {
                                        'value': 'string',
                                        'type': 'GPU'|'VCPU'|'MEMORY'
                                    },
                                ],
                                'secrets': [
                                    {
                                        'name': 'string',
                                        'valueFrom': 'string'
                                    },
                                ],
                                'ulimits': [
                                    {
                                        'hardLimit': 123,
                                        'name': 'string',
                                        'softLimit': 123
                                    },
                                ],
                                'user': 'string',
                                'exitCode': 123,
                                'reason': 'string',
                                'logStreamName': 'string',
                                'networkInterfaces': [
                                    {
                                        'attachmentId': 'string',
                                        'ipv6Address': 'string',
                                        'privateIpv4Address': 'string'
                                    },
                                ]
                            },
                        ],
                        'containerInstanceArn': 'string',
                        'taskArn': 'string',
                        'ephemeralStorage': {
                            'sizeInGiB': 123
                        },
                        'executionRoleArn': 'string',
                        'platformVersion': 'string',
                        'ipcMode': 'string',
                        'taskRoleArn': 'string',
                        'pidMode': 'string',
                        'networkConfiguration': {
                            'assignPublicIp': 'ENABLED'|'DISABLED'
                        },
                        'runtimePlatform': {
                            'operatingSystemFamily': 'string',
                            'cpuArchitecture': 'string'
                        },
                        'volumes': [
                            {
                                'host': {
                                    'sourcePath': 'string'
                                },
                                'name': 'string',
                                'efsVolumeConfiguration': {
                                    'fileSystemId': 'string',
                                    'rootDirectory': 'string',
                                    'transitEncryption': 'ENABLED'|'DISABLED',
                                    'transitEncryptionPort': 123,
                                    'authorizationConfig': {
                                        'accessPointId': 'string',
                                        'iam': 'ENABLED'|'DISABLED'
                                    }
                                }
                            },
                        ]
                    },
                ]
            },
            'isCancelled': True|False,
            'isTerminated': True|False
        },
    ]
}

**Response Structure**
::

    # This section is too large to render.
    # Please see the AWS API Documentation linked below.

`AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/DescribeJobs>`_
RegisterJobDefinition (updated) Link ¶
Changes (request)
{'ecsProperties': {'taskProperties': [{'containers': [{'command': ['string'],
                                                       'dependsOn': [{'condition': 'string',
                                                                      'containerName': 'string'}],
                                                       'environment': [{'name': 'string',
                                                                        'value': 'string'}],
                                                       'essential': 'boolean',
                                                       'image': 'string',
                                                       'linuxParameters': {'devices': [{'containerPath': 'string',
                                                                                        'hostPath': 'string',
                                                                                        'permissions': ['READ '
                                                                                                        '| '
                                                                                                        'WRITE '
                                                                                                        '| '
                                                                                                        'MKNOD']}],
                                                                           'initProcessEnabled': 'boolean',
                                                                           'maxSwap': 'integer',
                                                                           'sharedMemorySize': 'integer',
                                                                           'swappiness': 'integer',
                                                                           'tmpfs': [{'containerPath': 'string',
                                                                                      'mountOptions': ['string'],
                                                                                      'size': 'integer'}]},
                                                       'logConfiguration': {'logDriver': 'json-file '
                                                                                         '| '
                                                                                         'syslog '
                                                                                         '| '
                                                                                         'journald '
                                                                                         '| '
                                                                                         'gelf '
                                                                                         '| '
                                                                                         'fluentd '
                                                                                         '| '
                                                                                         'awslogs '
                                                                                         '| '
                                                                                         'splunk',
                                                                            'options': {'string': 'string'},
                                                                            'secretOptions': [{'name': 'string',
                                                                                               'valueFrom': 'string'}]},
                                                       'mountPoints': [{'containerPath': 'string',
                                                                        'readOnly': 'boolean',
                                                                        'sourceVolume': 'string'}],
                                                       'name': 'string',
                                                       'privileged': 'boolean',
                                                       'readonlyRootFilesystem': 'boolean',
                                                       'repositoryCredentials': {'credentialsParameter': 'string'},
                                                       'resourceRequirements': [{'type': 'GPU '
                                                                                         '| '
                                                                                         'VCPU '
                                                                                         '| '
                                                                                         'MEMORY',
                                                                                 'value': 'string'}],
                                                       'secrets': [{'name': 'string',
                                                                    'valueFrom': 'string'}],
                                                       'ulimits': [{'hardLimit': 'integer',
                                                                    'name': 'string',
                                                                    'softLimit': 'integer'}],
                                                       'user': 'string'}],
                                       'ephemeralStorage': {'sizeInGiB': 'integer'},
                                       'executionRoleArn': 'string',
                                       'ipcMode': 'string',
                                       'networkConfiguration': {'assignPublicIp': 'ENABLED '
                                                                                  '| '
                                                                                  'DISABLED'},
                                       'pidMode': 'string',
                                       'platformVersion': 'string',
                                       'runtimePlatform': {'cpuArchitecture': 'string',
                                                           'operatingSystemFamily': 'string'},
                                       'taskRoleArn': 'string',
                                       'volumes': [{'efsVolumeConfiguration': {'authorizationConfig': {'accessPointId': 'string',
                                                                                                       'iam': 'ENABLED '
                                                                                                              '| '
                                                                                                              'DISABLED'},
                                                                               'fileSystemId': 'string',
                                                                               'rootDirectory': 'string',
                                                                               'transitEncryption': 'ENABLED '
                                                                                                    '| '
                                                                                                    'DISABLED',
                                                                               'transitEncryptionPort': 'integer'},
                                                    'host': {'sourcePath': 'string'},
                                                    'name': 'string'}]}]},
 'eksProperties': {'podProperties': {'initContainers': [{'args': ['string'],
                                                         'command': ['string'],
                                                         'env': [{'name': 'string',
                                                                  'value': 'string'}],
                                                         'image': 'string',
                                                         'imagePullPolicy': 'string',
                                                         'name': 'string',
                                                         'resources': {'limits': {'string': 'string'},
                                                                       'requests': {'string': 'string'}},
                                                         'securityContext': {'privileged': 'boolean',
                                                                             'readOnlyRootFilesystem': 'boolean',
                                                                             'runAsGroup': 'long',
                                                                             'runAsNonRoot': 'boolean',
                                                                             'runAsUser': 'long'},
                                                         'volumeMounts': [{'mountPath': 'string',
                                                                           'name': 'string',
                                                                           'readOnly': 'boolean'}]}],
                                     'shareProcessNamespace': 'boolean'}},
 'nodeProperties': {'nodeRangeProperties': {'ecsProperties': {'taskProperties': [{'containers': [{'command': ['string'],
                                                                                                  'dependsOn': [{'condition': 'string',
                                                                                                                 'containerName': 'string'}],
                                                                                                  'environment': [{'name': 'string',
                                                                                                                   'value': 'string'}],
                                                                                                  'essential': 'boolean',
                                                                                                  'image': 'string',
                                                                                                  'linuxParameters': {'devices': [{'containerPath': 'string',
                                                                                                                                   'hostPath': 'string',
                                                                                                                                   'permissions': ['READ '
                                                                                                                                                   '| '
                                                                                                                                                   'WRITE '
                                                                                                                                                   '| '
                                                                                                                                                   'MKNOD']}],
                                                                                                                      'initProcessEnabled': 'boolean',
                                                                                                                      'maxSwap': 'integer',
                                                                                                                      'sharedMemorySize': 'integer',
                                                                                                                      'swappiness': 'integer',
                                                                                                                      'tmpfs': [{'containerPath': 'string',
                                                                                                                                 'mountOptions': ['string'],
                                                                                                                                 'size': 'integer'}]},
                                                                                                  'logConfiguration': {'logDriver': 'json-file '
                                                                                                                                    '| '
                                                                                                                                    'syslog '
                                                                                                                                    '| '
                                                                                                                                    'journald '
                                                                                                                                    '| '
                                                                                                                                    'gelf '
                                                                                                                                    '| '
                                                                                                                                    'fluentd '
                                                                                                                                    '| '
                                                                                                                                    'awslogs '
                                                                                                                                    '| '
                                                                                                                                    'splunk',
                                                                                                                       'options': {'string': 'string'},
                                                                                                                       'secretOptions': [{'name': 'string',
                                                                                                                                          'valueFrom': 'string'}]},
                                                                                                  'mountPoints': [{'containerPath': 'string',
                                                                                                                   'readOnly': 'boolean',
                                                                                                                   'sourceVolume': 'string'}],
                                                                                                  'name': 'string',
                                                                                                  'privileged': 'boolean',
                                                                                                  'readonlyRootFilesystem': 'boolean',
                                                                                                  'repositoryCredentials': {'credentialsParameter': 'string'},
                                                                                                  'resourceRequirements': [{'type': 'GPU '
                                                                                                                                    '| '
                                                                                                                                    'VCPU '
                                                                                                                                    '| '
                                                                                                                                    'MEMORY',
                                                                                                                            'value': 'string'}],
                                                                                                  'secrets': [{'name': 'string',
                                                                                                               'valueFrom': 'string'}],
                                                                                                  'ulimits': [{'hardLimit': 'integer',
                                                                                                               'name': 'string',
                                                                                                               'softLimit': 'integer'}],
                                                                                                  'user': 'string'}],
                                                                                  'ephemeralStorage': {'sizeInGiB': 'integer'},
                                                                                  'executionRoleArn': 'string',
                                                                                  'ipcMode': 'string',
                                                                                  'networkConfiguration': {'assignPublicIp': 'ENABLED '
                                                                                                                             '| '
                                                                                                                             'DISABLED'},
                                                                                  'pidMode': 'string',
                                                                                  'platformVersion': 'string',
                                                                                  'runtimePlatform': {'cpuArchitecture': 'string',
                                                                                                      'operatingSystemFamily': 'string'},
                                                                                  'taskRoleArn': 'string',
                                                                                  'volumes': [{'efsVolumeConfiguration': {'authorizationConfig': {'accessPointId': 'string',
                                                                                                                                                  'iam': 'ENABLED '
                                                                                                                                                         '| '
                                                                                                                                                         'DISABLED'},
                                                                                                                          'fileSystemId': 'string',
                                                                                                                          'rootDirectory': 'string',
                                                                                                                          'transitEncryption': 'ENABLED '
                                                                                                                                               '| '
                                                                                                                                               'DISABLED',
                                                                                                                          'transitEncryptionPort': 'integer'},
                                                                                               'host': {'sourcePath': 'string'},
                                                                                               'name': 'string'}]}]},
                                            'instanceTypes': ['string']}}}

Registers an Batch job definition.

See also: AWS API Documentation

Request Syntax

client.register_job_definition(
    jobDefinitionName='string',
    type='container'|'multinode',
    parameters={
        'string': 'string'
    },
    schedulingPriority=123,
    containerProperties={
        'image': 'string',
        'vcpus': 123,
        'memory': 123,
        'command': [
            'string',
        ],
        'jobRoleArn': 'string',
        'executionRoleArn': 'string',
        'volumes': [
            {
                'host': {
                    'sourcePath': 'string'
                },
                'name': 'string',
                'efsVolumeConfiguration': {
                    'fileSystemId': 'string',
                    'rootDirectory': 'string',
                    'transitEncryption': 'ENABLED'|'DISABLED',
                    'transitEncryptionPort': 123,
                    'authorizationConfig': {
                        'accessPointId': 'string',
                        'iam': 'ENABLED'|'DISABLED'
                    }
                }
            },
        ],
        'environment': [
            {
                'name': 'string',
                'value': 'string'
            },
        ],
        'mountPoints': [
            {
                'containerPath': 'string',
                'readOnly': True|False,
                'sourceVolume': 'string'
            },
        ],
        'readonlyRootFilesystem': True|False,
        'privileged': True|False,
        'ulimits': [
            {
                'hardLimit': 123,
                'name': 'string',
                'softLimit': 123
            },
        ],
        'user': 'string',
        'instanceType': 'string',
        'resourceRequirements': [
            {
                'value': 'string',
                'type': 'GPU'|'VCPU'|'MEMORY'
            },
        ],
        'linuxParameters': {
            'devices': [
                {
                    'hostPath': 'string',
                    'containerPath': 'string',
                    'permissions': [
                        'READ'|'WRITE'|'MKNOD',
                    ]
                },
            ],
            'initProcessEnabled': True|False,
            'sharedMemorySize': 123,
            'tmpfs': [
                {
                    'containerPath': 'string',
                    'size': 123,
                    'mountOptions': [
                        'string',
                    ]
                },
            ],
            'maxSwap': 123,
            'swappiness': 123
        },
        'logConfiguration': {
            'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
            'options': {
                'string': 'string'
            },
            'secretOptions': [
                {
                    'name': 'string',
                    'valueFrom': 'string'
                },
            ]
        },
        'secrets': [
            {
                'name': 'string',
                'valueFrom': 'string'
            },
        ],
        'networkConfiguration': {
            'assignPublicIp': 'ENABLED'|'DISABLED'
        },
        'fargatePlatformConfiguration': {
            'platformVersion': 'string'
        },
        'ephemeralStorage': {
            'sizeInGiB': 123
        },
        'runtimePlatform': {
            'operatingSystemFamily': 'string',
            'cpuArchitecture': 'string'
        },
        'repositoryCredentials': {
            'credentialsParameter': 'string'
        }
    },
    nodeProperties={
        'numNodes': 123,
        'mainNode': 123,
        'nodeRangeProperties': [
            {
                'targetNodes': 'string',
                'container': {
                    'image': 'string',
                    'vcpus': 123,
                    'memory': 123,
                    'command': [
                        'string',
                    ],
                    'jobRoleArn': 'string',
                    'executionRoleArn': 'string',
                    'volumes': [
                        {
                            'host': {
                                'sourcePath': 'string'
                            },
                            'name': 'string',
                            'efsVolumeConfiguration': {
                                'fileSystemId': 'string',
                                'rootDirectory': 'string',
                                'transitEncryption': 'ENABLED'|'DISABLED',
                                'transitEncryptionPort': 123,
                                'authorizationConfig': {
                                    'accessPointId': 'string',
                                    'iam': 'ENABLED'|'DISABLED'
                                }
                            }
                        },
                    ],
                    'environment': [
                        {
                            'name': 'string',
                            'value': 'string'
                        },
                    ],
                    'mountPoints': [
                        {
                            'containerPath': 'string',
                            'readOnly': True|False,
                            'sourceVolume': 'string'
                        },
                    ],
                    'readonlyRootFilesystem': True|False,
                    'privileged': True|False,
                    'ulimits': [
                        {
                            'hardLimit': 123,
                            'name': 'string',
                            'softLimit': 123
                        },
                    ],
                    'user': 'string',
                    'instanceType': 'string',
                    'resourceRequirements': [
                        {
                            'value': 'string',
                            'type': 'GPU'|'VCPU'|'MEMORY'
                        },
                    ],
                    'linuxParameters': {
                        'devices': [
                            {
                                'hostPath': 'string',
                                'containerPath': 'string',
                                'permissions': [
                                    'READ'|'WRITE'|'MKNOD',
                                ]
                            },
                        ],
                        'initProcessEnabled': True|False,
                        'sharedMemorySize': 123,
                        'tmpfs': [
                            {
                                'containerPath': 'string',
                                'size': 123,
                                'mountOptions': [
                                    'string',
                                ]
                            },
                        ],
                        'maxSwap': 123,
                        'swappiness': 123
                    },
                    'logConfiguration': {
                        'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                        'options': {
                            'string': 'string'
                        },
                        'secretOptions': [
                            {
                                'name': 'string',
                                'valueFrom': 'string'
                            },
                        ]
                    },
                    'secrets': [
                        {
                            'name': 'string',
                            'valueFrom': 'string'
                        },
                    ],
                    'networkConfiguration': {
                        'assignPublicIp': 'ENABLED'|'DISABLED'
                    },
                    'fargatePlatformConfiguration': {
                        'platformVersion': 'string'
                    },
                    'ephemeralStorage': {
                        'sizeInGiB': 123
                    },
                    'runtimePlatform': {
                        'operatingSystemFamily': 'string',
                        'cpuArchitecture': 'string'
                    },
                    'repositoryCredentials': {
                        'credentialsParameter': 'string'
                    }
                },
                'instanceTypes': [
                    'string',
                ],
                'ecsProperties': {
                    'taskProperties': [
                        {
                            'containers': [
                                {
                                    'command': [
                                        'string',
                                    ],
                                    'dependsOn': [
                                        {
                                            'containerName': 'string',
                                            'condition': 'string'
                                        },
                                    ],
                                    'environment': [
                                        {
                                            'name': 'string',
                                            'value': 'string'
                                        },
                                    ],
                                    'essential': True|False,
                                    'image': 'string',
                                    'linuxParameters': {
                                        'devices': [
                                            {
                                                'hostPath': 'string',
                                                'containerPath': 'string',
                                                'permissions': [
                                                    'READ'|'WRITE'|'MKNOD',
                                                ]
                                            },
                                        ],
                                        'initProcessEnabled': True|False,
                                        'sharedMemorySize': 123,
                                        'tmpfs': [
                                            {
                                                'containerPath': 'string',
                                                'size': 123,
                                                'mountOptions': [
                                                    'string',
                                                ]
                                            },
                                        ],
                                        'maxSwap': 123,
                                        'swappiness': 123
                                    },
                                    'logConfiguration': {
                                        'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                                        'options': {
                                            'string': 'string'
                                        },
                                        'secretOptions': [
                                            {
                                                'name': 'string',
                                                'valueFrom': 'string'
                                            },
                                        ]
                                    },
                                    'mountPoints': [
                                        {
                                            'containerPath': 'string',
                                            'readOnly': True|False,
                                            'sourceVolume': 'string'
                                        },
                                    ],
                                    'name': 'string',
                                    'privileged': True|False,
                                    'readonlyRootFilesystem': True|False,
                                    'repositoryCredentials': {
                                        'credentialsParameter': 'string'
                                    },
                                    'resourceRequirements': [
                                        {
                                            'value': 'string',
                                            'type': 'GPU'|'VCPU'|'MEMORY'
                                        },
                                    ],
                                    'secrets': [
                                        {
                                            'name': 'string',
                                            'valueFrom': 'string'
                                        },
                                    ],
                                    'ulimits': [
                                        {
                                            'hardLimit': 123,
                                            'name': 'string',
                                            'softLimit': 123
                                        },
                                    ],
                                    'user': 'string'
                                },
                            ],
                            'ephemeralStorage': {
                                'sizeInGiB': 123
                            },
                            'executionRoleArn': 'string',
                            'platformVersion': 'string',
                            'ipcMode': 'string',
                            'taskRoleArn': 'string',
                            'pidMode': 'string',
                            'networkConfiguration': {
                                'assignPublicIp': 'ENABLED'|'DISABLED'
                            },
                            'runtimePlatform': {
                                'operatingSystemFamily': 'string',
                                'cpuArchitecture': 'string'
                            },
                            'volumes': [
                                {
                                    'host': {
                                        'sourcePath': 'string'
                                    },
                                    'name': 'string',
                                    'efsVolumeConfiguration': {
                                        'fileSystemId': 'string',
                                        'rootDirectory': 'string',
                                        'transitEncryption': 'ENABLED'|'DISABLED',
                                        'transitEncryptionPort': 123,
                                        'authorizationConfig': {
                                            'accessPointId': 'string',
                                            'iam': 'ENABLED'|'DISABLED'
                                        }
                                    }
                                },
                            ]
                        },
                    ]
                }
            },
        ]
    },
    retryStrategy={
        'attempts': 123,
        'evaluateOnExit': [
            {
                'onStatusReason': 'string',
                'onReason': 'string',
                'onExitCode': 'string',
                'action': 'RETRY'|'EXIT'
            },
        ]
    },
    propagateTags=True|False,
    timeout={
        'attemptDurationSeconds': 123
    },
    tags={
        'string': 'string'
    },
    platformCapabilities=[
        'EC2'|'FARGATE',
    ],
    eksProperties={
        'podProperties': {
            'serviceAccountName': 'string',
            'hostNetwork': True|False,
            'dnsPolicy': 'string',
            'containers': [
                {
                    'name': 'string',
                    'image': 'string',
                    'imagePullPolicy': 'string',
                    'command': [
                        'string',
                    ],
                    'args': [
                        'string',
                    ],
                    'env': [
                        {
                            'name': 'string',
                            'value': 'string'
                        },
                    ],
                    'resources': {
                        'limits': {
                            'string': 'string'
                        },
                        'requests': {
                            'string': 'string'
                        }
                    },
                    'volumeMounts': [
                        {
                            'name': 'string',
                            'mountPath': 'string',
                            'readOnly': True|False
                        },
                    ],
                    'securityContext': {
                        'runAsUser': 123,
                        'runAsGroup': 123,
                        'privileged': True|False,
                        'readOnlyRootFilesystem': True|False,
                        'runAsNonRoot': True|False
                    }
                },
            ],
            'initContainers': [
                {
                    'name': 'string',
                    'image': 'string',
                    'imagePullPolicy': 'string',
                    'command': [
                        'string',
                    ],
                    'args': [
                        'string',
                    ],
                    'env': [
                        {
                            'name': 'string',
                            'value': 'string'
                        },
                    ],
                    'resources': {
                        'limits': {
                            'string': 'string'
                        },
                        'requests': {
                            'string': 'string'
                        }
                    },
                    'volumeMounts': [
                        {
                            'name': 'string',
                            'mountPath': 'string',
                            'readOnly': True|False
                        },
                    ],
                    'securityContext': {
                        'runAsUser': 123,
                        'runAsGroup': 123,
                        'privileged': True|False,
                        'readOnlyRootFilesystem': True|False,
                        'runAsNonRoot': True|False
                    }
                },
            ],
            'volumes': [
                {
                    'name': 'string',
                    'hostPath': {
                        'path': 'string'
                    },
                    'emptyDir': {
                        'medium': 'string',
                        'sizeLimit': 'string'
                    },
                    'secret': {
                        'secretName': 'string',
                        'optional': True|False
                    }
                },
            ],
            'metadata': {
                'labels': {
                    'string': 'string'
                }
            },
            'shareProcessNamespace': True|False
        }
    },
    ecsProperties={
        'taskProperties': [
            {
                'containers': [
                    {
                        'command': [
                            'string',
                        ],
                        'dependsOn': [
                            {
                                'containerName': 'string',
                                'condition': 'string'
                            },
                        ],
                        'environment': [
                            {
                                'name': 'string',
                                'value': 'string'
                            },
                        ],
                        'essential': True|False,
                        'image': 'string',
                        'linuxParameters': {
                            'devices': [
                                {
                                    'hostPath': 'string',
                                    'containerPath': 'string',
                                    'permissions': [
                                        'READ'|'WRITE'|'MKNOD',
                                    ]
                                },
                            ],
                            'initProcessEnabled': True|False,
                            'sharedMemorySize': 123,
                            'tmpfs': [
                                {
                                    'containerPath': 'string',
                                    'size': 123,
                                    'mountOptions': [
                                        'string',
                                    ]
                                },
                            ],
                            'maxSwap': 123,
                            'swappiness': 123
                        },
                        'logConfiguration': {
                            'logDriver': 'json-file'|'syslog'|'journald'|'gelf'|'fluentd'|'awslogs'|'splunk',
                            'options': {
                                'string': 'string'
                            },
                            'secretOptions': [
                                {
                                    'name': 'string',
                                    'valueFrom': 'string'
                                },
                            ]
                        },
                        'mountPoints': [
                            {
                                'containerPath': 'string',
                                'readOnly': True|False,
                                'sourceVolume': 'string'
                            },
                        ],
                        'name': 'string',
                        'privileged': True|False,
                        'readonlyRootFilesystem': True|False,
                        'repositoryCredentials': {
                            'credentialsParameter': 'string'
                        },
                        'resourceRequirements': [
                            {
                                'value': 'string',
                                'type': 'GPU'|'VCPU'|'MEMORY'
                            },
                        ],
                        'secrets': [
                            {
                                'name': 'string',
                                'valueFrom': 'string'
                            },
                        ],
                        'ulimits': [
                            {
                                'hardLimit': 123,
                                'name': 'string',
                                'softLimit': 123
                            },
                        ],
                        'user': 'string'
                    },
                ],
                'ephemeralStorage': {
                    'sizeInGiB': 123
                },
                'executionRoleArn': 'string',
                'platformVersion': 'string',
                'ipcMode': 'string',
                'taskRoleArn': 'string',
                'pidMode': 'string',
                'networkConfiguration': {
                    'assignPublicIp': 'ENABLED'|'DISABLED'
                },
                'runtimePlatform': {
                    'operatingSystemFamily': 'string',
                    'cpuArchitecture': 'string'
                },
                'volumes': [
                    {
                        'host': {
                            'sourcePath': 'string'
                        },
                        'name': 'string',
                        'efsVolumeConfiguration': {
                            'fileSystemId': 'string',
                            'rootDirectory': 'string',
                            'transitEncryption': 'ENABLED'|'DISABLED',
                            'transitEncryptionPort': 123,
                            'authorizationConfig': {
                                'accessPointId': 'string',
                                'iam': 'ENABLED'|'DISABLED'
                            }
                        }
                    },
                ]
            },
        ]
    }
)

  **Parameters**
  ::

      # This section is too large to render.
      # Please see the AWS API Documentation linked below.

  `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/batch-2016-08-10/RegisterJobDefinition>`_
rtype

dict

returns

Response Syntax

{
    'jobDefinitionName': 'string',
    'jobDefinitionArn': 'string',
    'revision': 123
}

Response Structure

  • (dict) --

    • jobDefinitionName (string) --

      The name of the job definition.

    • jobDefinitionArn (string) --

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

    • revision (integer) --

      The revision of the job definition.

SubmitJob (updated) Link ¶
Changes (request)
{'ecsPropertiesOverride': {'taskProperties': [{'containers': [{'command': ['string'],
                                                               'environment': [{'name': 'string',
                                                                                'value': 'string'}],
                                                               'name': 'string',
                                                               'resourceRequirements': [{'type': 'GPU '
                                                                                                 '| '
                                                                                                 'VCPU '
                                                                                                 '| '
                                                                                                 'MEMORY',
                                                                                         'value': 'string'}]}]}]},
 'eksPropertiesOverride': {'podProperties': {'containers': {'name': 'string'},
                                             'initContainers': [{'args': ['string'],
                                                                 'command': ['string'],
                                                                 'env': [{'name': 'string',
                                                                          'value': 'string'}],
                                                                 'image': 'string',
                                                                 'name': 'string',
                                                                 'resources': {'limits': {'string': 'string'},
                                                                               'requests': {'string': 'string'}}}]}},
 'nodeOverrides': {'nodePropertyOverrides': {'ecsPropertiesOverride': {'taskProperties': [{'containers': [{'command': ['string'],
                                                                                                           'environment': [{'name': 'string',
                                                                                                                            'value': 'string'}],
                                                                                                           'name': 'string',
                                                                                                           'resourceRequirements': [{'type': 'GPU '
                                                                                                                                             '| '
                                                                                                                                             'VCPU '
                                                                                                                                             '| '
                                                                                                                                             'MEMORY',
                                                                                                                                     'value': 'string'}]}]}]},
                                             'instanceTypes': ['string']}}}

Submits an Batch job from a job definition. Parameters that are specified during SubmitJob override parameters defined in the job definition. vCPU and memory requirements that are specified in the resourceRequirements objects in the job definition are the exception. They can't be overridden this way using the memory and vcpus parameters. Rather, you must specify updates to job definition parameters in a resourceRequirements object that's included in the containerOverrides parameter.

Note

Job queues with a scheduling policy are limited to 500 active fair share identifiers at a time.

Warning

Jobs that run on Fargate resources can't be guaranteed to run for more than 14 days. This is because, after 14 days, Fargate resources might become unavailable and job might be terminated.

See also: AWS API Documentation

Request Syntax

client.submit_job(
    jobName='string',
    jobQueue='string',
    shareIdentifier='string',
    schedulingPriorityOverride=123,
    arrayProperties={
        'size': 123
    },
    dependsOn=[
        {
            'jobId': 'string',
            'type': 'N_TO_N'|'SEQUENTIAL'
        },
    ],
    jobDefinition='string',
    parameters={
        'string': 'string'
    },
    containerOverrides={
        'vcpus': 123,
        'memory': 123,
        'command': [
            'string',
        ],
        'instanceType': 'string',
        'environment': [
            {
                'name': 'string',
                'value': 'string'
            },
        ],
        'resourceRequirements': [
            {
                'value': 'string',
                'type': 'GPU'|'VCPU'|'MEMORY'
            },
        ]
    },
    nodeOverrides={
        'numNodes': 123,
        'nodePropertyOverrides': [
            {
                'targetNodes': 'string',
                'containerOverrides': {
                    'vcpus': 123,
                    'memory': 123,
                    'command': [
                        'string',
                    ],
                    'instanceType': 'string',
                    'environment': [
                        {
                            'name': 'string',
                            'value': 'string'
                        },
                    ],
                    'resourceRequirements': [
                        {
                            'value': 'string',
                            'type': 'GPU'|'VCPU'|'MEMORY'
                        },
                    ]
                },
                'ecsPropertiesOverride': {
                    'taskProperties': [
                        {
                            'containers': [
                                {
                                    'command': [
                                        'string',
                                    ],
                                    'environment': [
                                        {
                                            'name': 'string',
                                            'value': 'string'
                                        },
                                    ],
                                    'name': 'string',
                                    'resourceRequirements': [
                                        {
                                            'value': 'string',
                                            'type': 'GPU'|'VCPU'|'MEMORY'
                                        },
                                    ]
                                },
                            ]
                        },
                    ]
                },
                'instanceTypes': [
                    'string',
                ]
            },
        ]
    },
    retryStrategy={
        'attempts': 123,
        'evaluateOnExit': [
            {
                'onStatusReason': 'string',
                'onReason': 'string',
                'onExitCode': 'string',
                'action': 'RETRY'|'EXIT'
            },
        ]
    },
    propagateTags=True|False,
    timeout={
        'attemptDurationSeconds': 123
    },
    tags={
        'string': 'string'
    },
    eksPropertiesOverride={
        'podProperties': {
            'containers': [
                {
                    'name': 'string',
                    'image': 'string',
                    'command': [
                        'string',
                    ],
                    'args': [
                        'string',
                    ],
                    'env': [
                        {
                            'name': 'string',
                            'value': 'string'
                        },
                    ],
                    'resources': {
                        'limits': {
                            'string': 'string'
                        },
                        'requests': {
                            'string': 'string'
                        }
                    }
                },
            ],
            'initContainers': [
                {
                    'name': 'string',
                    'image': 'string',
                    'command': [
                        'string',
                    ],
                    'args': [
                        'string',
                    ],
                    'env': [
                        {
                            'name': 'string',
                            'value': 'string'
                        },
                    ],
                    'resources': {
                        'limits': {
                            'string': 'string'
                        },
                        'requests': {
                            'string': 'string'
                        }
                    }
                },
            ],
            'metadata': {
                'labels': {
                    'string': 'string'
                }
            }
        }
    },
    ecsPropertiesOverride={
        'taskProperties': [
            {
                'containers': [
                    {
                        'command': [
                            'string',
                        ],
                        'environment': [
                            {
                                'name': 'string',
                                'value': 'string'
                            },
                        ],
                        'name': 'string',
                        'resourceRequirements': [
                            {
                                'value': 'string',
                                'type': 'GPU'|'VCPU'|'MEMORY'
                            },
                        ]
                    },
                ]
            },
        ]
    }
)
type jobName

string

param jobName

[REQUIRED]

The name of the job. It can be up to 128 letters long. The first character must be alphanumeric, can contain uppercase and lowercase letters, numbers, hyphens (-), and underscores (_).

type jobQueue

string

param jobQueue

[REQUIRED]

The job queue where the job is submitted. You can specify either the name or the Amazon Resource Name (ARN) of the queue.

type shareIdentifier

string

param shareIdentifier

The share identifier for the job. Don't specify this parameter if the job queue doesn't have a scheduling policy. If the job queue has a scheduling policy, then this parameter must be specified.

This string is limited to 255 alphanumeric characters, and can be followed by an asterisk (*).

type schedulingPriorityOverride

integer

param schedulingPriorityOverride

The scheduling priority for the job. 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. This overrides any scheduling priority in the job definition and works only within a single share identifier.

The minimum supported value is 0 and the maximum supported value is 9999.

type arrayProperties

dict

param arrayProperties

The array properties for the submitted job, such as the size of the array. The array size can be between 2 and 10,000. If you specify array properties for a job, it becomes an array job. For more information, see Array Jobs in the Batch User Guide .

  • size (integer) --

    The size of the array job.

type dependsOn

list

param dependsOn

A list of dependencies for the job. A job can depend upon a maximum of 20 jobs. You can specify a SEQUENTIAL type dependency without specifying a job ID for array jobs so that each child array job completes sequentially, starting at index 0. You can also specify an N_TO_N type dependency with a job ID for array jobs. In that case, each index child of this job must wait for the corresponding index child of each dependency to complete before it can begin.

  • (dict) --

    An object that represents an Batch job dependency.

    • jobId (string) --

      The job ID of the Batch job that's associated with this dependency.

    • type (string) --

      The type of the job dependency.

type jobDefinition

string

param jobDefinition

[REQUIRED]

The job definition used by this job. This value can be one of definition-name , definition-name:revision , or the Amazon Resource Name (ARN) for the job definition, with or without the revision ( arn:aws:batch:region:account:job-definition/definition-name:revision , or arn:aws:batch:region:account:job-definition/definition-name ).

If the revision is not specified, then the latest active revision is used.

type parameters

dict

param parameters

Additional parameters passed to the job that replace parameter substitution placeholders that are set in the job definition. Parameters are specified as a key and value pair mapping. Parameters in a SubmitJob request override any corresponding parameter defaults from the job definition.

  • (string) --

    • (string) --

type containerOverrides

dict

param containerOverrides

An object with properties that override the defaults for the job definition that specify the name of a container in the specified job definition and the overrides it should receive. You can override the default command for a container, which is specified in the job definition or the Docker image, with a command override. You can also override existing environment variables on a container or add new environment variables to it with an environment override.

  • vcpus (integer) --

    This parameter is deprecated, use resourceRequirements to override the vcpus parameter that's set in the job definition. It's not supported for jobs running on Fargate resources. For jobs that run on Amazon EC2 resources, it overrides the vcpus parameter set in the job definition, but doesn't override any vCPU requirement specified in the resourceRequirements structure in the job definition. To override vCPU requirements that are specified in the resourceRequirements structure in the job definition, resourceRequirements must be specified in the SubmitJob request, with type set to VCPU and value set to the new value. For more information, see Can't override job definition resource requirements in the Batch User Guide .

  • memory (integer) --

    This parameter is deprecated, use resourceRequirements to override the memory requirements specified in the job definition. It's not supported for jobs running on Fargate resources. For jobs that run on Amazon EC2 resources, it overrides the memory parameter set in the job definition, but doesn't override any memory requirement that's specified in the resourceRequirements structure in the job definition. To override memory requirements that are specified in the resourceRequirements structure in the job definition, resourceRequirements must be specified in the SubmitJob request, with type set to MEMORY and value set to the new value. For more information, see Can't override job definition resource requirements in the Batch User Guide .

  • command (list) --

    The command to send to the container that overrides the default command from the Docker image or the job definition.

    Note

    This parameter can't contain an empty string.

    • (string) --

  • instanceType (string) --

    The instance type to use for a multi-node parallel job.

    Note

    This parameter isn't applicable to single-node container jobs or jobs that run on Fargate resources, and shouldn't be provided.

  • environment (list) --

    The environment variables to send to the container. You can add new environment variables, which are added to the container at launch, or you can override the existing environment variables from the Docker image or the job definition.

    Note

    Environment variables cannot start with " AWS_BATCH ". This naming convention is reserved for variables that Batch sets.

    • (dict) --

      A key-value pair object.

      • name (string) --

        The name of the key-value pair. For environment variables, this is the name of the environment variable.

      • value (string) --

        The value of the key-value pair. For environment variables, this is the value of the environment variable.

  • resourceRequirements (list) --

    The type and amount of resources to assign to a container. This overrides the settings in the job definition. The supported resources include GPU , MEMORY , and VCPU .

    • (dict) --

      The type and amount of a resource to assign to a container. The supported resources include GPU , MEMORY , and VCPU .

      • value (string) -- [REQUIRED]

        The quantity of the specified resource to reserve for the container. The values vary based on the type specified.

        type="GPU"

        The number of physical GPUs to reserve for the container. Make sure that the number of GPUs reserved for all containers in a job doesn't exceed the number of available GPUs on the compute resource that the job is launched on.

        Note

        GPUs aren't available for jobs that are running on Fargate resources.

        type="MEMORY"

        The memory hard limit (in MiB) present to the container. This parameter is supported for jobs that are running on Amazon EC2 resources. If your container attempts to exceed the memory specified, the container is terminated. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run. You must specify at least 4 MiB of memory for a job. This is required but can be specified in several places for multi-node parallel (MNP) jobs. It must be specified for each node at least once. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run.

        Note

        If you're trying to maximize your resource utilization by providing your jobs as much memory as possible for a particular instance type, see Memory management in the Batch User Guide .

        For jobs that are running on Fargate resources, then value is the hard limit (in MiB), and must match one of the supported values and the VCPU values must be one of the values supported for that memory value.

        value = 512

        VCPU = 0.25

        value = 1024

        VCPU = 0.25 or 0.5

        value = 2048

        VCPU = 0.25, 0.5, or 1

        value = 3072

        VCPU = 0.5, or 1

        value = 4096

        VCPU = 0.5, 1, or 2

        value = 5120, 6144, or 7168

        VCPU = 1 or 2

        value = 8192

        VCPU = 1, 2, or 4

        value = 9216, 10240, 11264, 12288, 13312, 14336, or 15360

        VCPU = 2 or 4

        value = 16384

        VCPU = 2, 4, or 8

        value = 17408, 18432, 19456, 21504, 22528, 23552, 25600, 26624, 27648, 29696, or 30720

        VCPU = 4

        value = 20480, 24576, or 28672

        VCPU = 4 or 8

        value = 36864, 45056, 53248, or 61440

        VCPU = 8

        value = 32768, 40960, 49152, or 57344

        VCPU = 8 or 16

        value = 65536, 73728, 81920, 90112, 98304, 106496, 114688, or 122880

        VCPU = 16

        type="VCPU"

        The number of vCPUs reserved for the container. This parameter maps to CpuShares in the Create a container section of the Docker Remote API and the --cpu-shares option to docker run. Each vCPU is equivalent to 1,024 CPU shares. For Amazon EC2 resources, you must specify at least one vCPU. This is required but can be specified in several places; it must be specified for each node at least once.

        The default for the Fargate On-Demand vCPU resource count quota is 6 vCPUs. For more information about Fargate quotas, see Fargate quotas in the Amazon Web Services General Reference .

        For jobs that are running on Fargate resources, then value must match one of the supported values and the MEMORY values must be one of the values supported for that VCPU value. The supported values are 0.25, 0.5, 1, 2, 4, 8, and 16

        value = 0.25

        MEMORY = 512, 1024, or 2048

        value = 0.5

        MEMORY = 1024, 2048, 3072, or 4096

        value = 1

        MEMORY = 2048, 3072, 4096, 5120, 6144, 7168, or 8192

        value = 2

        MEMORY = 4096, 5120, 6144, 7168, 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, or 16384

        value = 4

        MEMORY = 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, 16384, 17408, 18432, 19456, 20480, 21504, 22528, 23552, 24576, 25600, 26624, 27648, 28672, 29696, or 30720

        value = 8

        MEMORY = 16384, 20480, 24576, 28672, 32768, 36864, 40960, 45056, 49152, 53248, 57344, or 61440

        value = 16

        MEMORY = 32768, 40960, 49152, 57344, 65536, 73728, 81920, 90112, 98304, 106496, 114688, or 122880

      • type (string) -- [REQUIRED]

        The type of resource to assign to a container. The supported resources include GPU , MEMORY , and VCPU .

type nodeOverrides

dict

param nodeOverrides

A list of node overrides in JSON format that specify the node range to target and the container overrides for that node range.

Note

This parameter isn't applicable to jobs that are running on Fargate resources; use containerOverrides instead.

  • numNodes (integer) --

    The number of nodes to use with a multi-node parallel job. This value overrides the number of nodes that are specified in the job definition. To use this override, you must meet the following conditions:

    • There must be at least one node range in your job definition that has an open upper boundary, such as : or n: .

    • The lower boundary of the node range that's specified in the job definition must be fewer than the number of nodes specified in the override.

    • The main node index that's specified in the job definition must be fewer than the number of nodes specified in the override.

  • nodePropertyOverrides (list) --

    The node property overrides for the job.

    • (dict) --

      The object that represents any node overrides to a job definition that's used in a SubmitJob API operation.

      • targetNodes (string) -- [REQUIRED]

        The range of nodes, using node index values, that's used to override. A range of 0:3 indicates nodes with index values of 0 through 3 . If the starting range value is omitted ( :n ), then 0 is used to start the range. If the ending range value is omitted ( n: ), then the highest possible node index is used to end the range.

      • containerOverrides (dict) --

        The overrides that are sent to a node range.

        • vcpus (integer) --

          This parameter is deprecated, use resourceRequirements to override the vcpus parameter that's set in the job definition. It's not supported for jobs running on Fargate resources. For jobs that run on Amazon EC2 resources, it overrides the vcpus parameter set in the job definition, but doesn't override any vCPU requirement specified in the resourceRequirements structure in the job definition. To override vCPU requirements that are specified in the resourceRequirements structure in the job definition, resourceRequirements must be specified in the SubmitJob request, with type set to VCPU and value set to the new value. For more information, see Can't override job definition resource requirements in the Batch User Guide .

        • memory (integer) --

          This parameter is deprecated, use resourceRequirements to override the memory requirements specified in the job definition. It's not supported for jobs running on Fargate resources. For jobs that run on Amazon EC2 resources, it overrides the memory parameter set in the job definition, but doesn't override any memory requirement that's specified in the resourceRequirements structure in the job definition. To override memory requirements that are specified in the resourceRequirements structure in the job definition, resourceRequirements must be specified in the SubmitJob request, with type set to MEMORY and value set to the new value. For more information, see Can't override job definition resource requirements in the Batch User Guide .

        • command (list) --

          The command to send to the container that overrides the default command from the Docker image or the job definition.

          Note

          This parameter can't contain an empty string.

          • (string) --

        • instanceType (string) --

          The instance type to use for a multi-node parallel job.

          Note

          This parameter isn't applicable to single-node container jobs or jobs that run on Fargate resources, and shouldn't be provided.

        • environment (list) --

          The environment variables to send to the container. You can add new environment variables, which are added to the container at launch, or you can override the existing environment variables from the Docker image or the job definition.

          Note

          Environment variables cannot start with " AWS_BATCH ". This naming convention is reserved for variables that Batch sets.

          • (dict) --

            A key-value pair object.

            • name (string) --

              The name of the key-value pair. For environment variables, this is the name of the environment variable.

            • value (string) --

              The value of the key-value pair. For environment variables, this is the value of the environment variable.

        • resourceRequirements (list) --

          The type and amount of resources to assign to a container. This overrides the settings in the job definition. The supported resources include GPU , MEMORY , and VCPU .

          • (dict) --

            The type and amount of a resource to assign to a container. The supported resources include GPU , MEMORY , and VCPU .

            • value (string) -- [REQUIRED]

              The quantity of the specified resource to reserve for the container. The values vary based on the type specified.

              type="GPU"

              The number of physical GPUs to reserve for the container. Make sure that the number of GPUs reserved for all containers in a job doesn't exceed the number of available GPUs on the compute resource that the job is launched on.

              Note

              GPUs aren't available for jobs that are running on Fargate resources.

              type="MEMORY"

              The memory hard limit (in MiB) present to the container. This parameter is supported for jobs that are running on Amazon EC2 resources. If your container attempts to exceed the memory specified, the container is terminated. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run. You must specify at least 4 MiB of memory for a job. This is required but can be specified in several places for multi-node parallel (MNP) jobs. It must be specified for each node at least once. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run.

              Note

              If you're trying to maximize your resource utilization by providing your jobs as much memory as possible for a particular instance type, see Memory management in the Batch User Guide .

              For jobs that are running on Fargate resources, then value is the hard limit (in MiB), and must match one of the supported values and the VCPU values must be one of the values supported for that memory value.

              value = 512

              VCPU = 0.25

              value = 1024

              VCPU = 0.25 or 0.5

              value = 2048

              VCPU = 0.25, 0.5, or 1

              value = 3072

              VCPU = 0.5, or 1

              value = 4096

              VCPU = 0.5, 1, or 2

              value = 5120, 6144, or 7168

              VCPU = 1 or 2

              value = 8192

              VCPU = 1, 2, or 4

              value = 9216, 10240, 11264, 12288, 13312, 14336, or 15360

              VCPU = 2 or 4

              value = 16384

              VCPU = 2, 4, or 8

              value = 17408, 18432, 19456, 21504, 22528, 23552, 25600, 26624, 27648, 29696, or 30720

              VCPU = 4

              value = 20480, 24576, or 28672

              VCPU = 4 or 8

              value = 36864, 45056, 53248, or 61440

              VCPU = 8

              value = 32768, 40960, 49152, or 57344

              VCPU = 8 or 16

              value = 65536, 73728, 81920, 90112, 98304, 106496, 114688, or 122880

              VCPU = 16

              type="VCPU"

              The number of vCPUs reserved for the container. This parameter maps to CpuShares in the Create a container section of the Docker Remote API and the --cpu-shares option to docker run. Each vCPU is equivalent to 1,024 CPU shares. For Amazon EC2 resources, you must specify at least one vCPU. This is required but can be specified in several places; it must be specified for each node at least once.

              The default for the Fargate On-Demand vCPU resource count quota is 6 vCPUs. For more information about Fargate quotas, see Fargate quotas in the Amazon Web Services General Reference .

              For jobs that are running on Fargate resources, then value must match one of the supported values and the MEMORY values must be one of the values supported for that VCPU value. The supported values are 0.25, 0.5, 1, 2, 4, 8, and 16

              value = 0.25

              MEMORY = 512, 1024, or 2048

              value = 0.5

              MEMORY = 1024, 2048, 3072, or 4096

              value = 1

              MEMORY = 2048, 3072, 4096, 5120, 6144, 7168, or 8192

              value = 2

              MEMORY = 4096, 5120, 6144, 7168, 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, or 16384

              value = 4

              MEMORY = 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, 16384, 17408, 18432, 19456, 20480, 21504, 22528, 23552, 24576, 25600, 26624, 27648, 28672, 29696, or 30720

              value = 8

              MEMORY = 16384, 20480, 24576, 28672, 32768, 36864, 40960, 45056, 49152, 53248, 57344, or 61440

              value = 16

              MEMORY = 32768, 40960, 49152, 57344, 65536, 73728, 81920, 90112, 98304, 106496, 114688, or 122880

            • type (string) -- [REQUIRED]

              The type of resource to assign to a container. The supported resources include GPU , MEMORY , and VCPU .

      • ecsPropertiesOverride (dict) --

        An object that contains the properties that you want to replace for the existing Amazon ECS resources of a job.

        • taskProperties (list) --

          The overrides for the Amazon ECS task definition of a job.

          Note

          This object is currently limited to one element.

          • (dict) --

            An object that contains overrides for the task definition of a job.

            • containers (list) --

              The overrides for the container definition of a job.

              • (dict) --

                The overrides that should be sent to a container.

                For information about using Batch overrides when you connect event sources to targets, see BatchContainerOverrides.

                • command (list) --

                  The command to send to the container that overrides the default command from the Docker image or the job definition.

                  Note

                  This parameter can't contain an empty string.

                  • (string) --

                • environment (list) --

                  The environment variables to send to the container. You can add new environment variables, which are added to the container at launch, or you can override the existing environment variables from the Docker image or the job definition.

                  Note

                  Environment variables cannot start with AWS_BATCH . This naming convention is reserved for variables that Batch sets.

                  • (dict) --

                    A key-value pair object.

                    • name (string) --

                      The name of the key-value pair. For environment variables, this is the name of the environment variable.

                    • value (string) --

                      The value of the key-value pair. For environment variables, this is the value of the environment variable.

                • name (string) --

                  A pointer to the container that you want to override. The container's name provides a unique identifier for the container being used.

                • resourceRequirements (list) --

                  The type and amount of resources to assign to a container. This overrides the settings in the job definition. The supported resources include GPU , MEMORY , and VCPU .

                  • (dict) --

                    The type and amount of a resource to assign to a container. The supported resources include GPU , MEMORY , and VCPU .

                    • value (string) -- [REQUIRED]

                      The quantity of the specified resource to reserve for the container. The values vary based on the type specified.

                      type="GPU"

                      The number of physical GPUs to reserve for the container. Make sure that the number of GPUs reserved for all containers in a job doesn't exceed the number of available GPUs on the compute resource that the job is launched on.

                      Note

                      GPUs aren't available for jobs that are running on Fargate resources.

                      type="MEMORY"

                      The memory hard limit (in MiB) present to the container. This parameter is supported for jobs that are running on Amazon EC2 resources. If your container attempts to exceed the memory specified, the container is terminated. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run. You must specify at least 4 MiB of memory for a job. This is required but can be specified in several places for multi-node parallel (MNP) jobs. It must be specified for each node at least once. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run.

                      Note

                      If you're trying to maximize your resource utilization by providing your jobs as much memory as possible for a particular instance type, see Memory management in the Batch User Guide .

                      For jobs that are running on Fargate resources, then value is the hard limit (in MiB), and must match one of the supported values and the VCPU values must be one of the values supported for that memory value.

                      value = 512

                      VCPU = 0.25

                      value = 1024

                      VCPU = 0.25 or 0.5

                      value = 2048

                      VCPU = 0.25, 0.5, or 1

                      value = 3072

                      VCPU = 0.5, or 1

                      value = 4096

                      VCPU = 0.5, 1, or 2

                      value = 5120, 6144, or 7168

                      VCPU = 1 or 2

                      value = 8192

                      VCPU = 1, 2, or 4

                      value = 9216, 10240, 11264, 12288, 13312, 14336, or 15360

                      VCPU = 2 or 4

                      value = 16384

                      VCPU = 2, 4, or 8

                      value = 17408, 18432, 19456, 21504, 22528, 23552, 25600, 26624, 27648, 29696, or 30720

                      VCPU = 4

                      value = 20480, 24576, or 28672

                      VCPU = 4 or 8

                      value = 36864, 45056, 53248, or 61440

                      VCPU = 8

                      value = 32768, 40960, 49152, or 57344

                      VCPU = 8 or 16

                      value = 65536, 73728, 81920, 90112, 98304, 106496, 114688, or 122880

                      VCPU = 16

                      type="VCPU"

                      The number of vCPUs reserved for the container. This parameter maps to CpuShares in the Create a container section of the Docker Remote API and the --cpu-shares option to docker run. Each vCPU is equivalent to 1,024 CPU shares. For Amazon EC2 resources, you must specify at least one vCPU. This is required but can be specified in several places; it must be specified for each node at least once.

                      The default for the Fargate On-Demand vCPU resource count quota is 6 vCPUs. For more information about Fargate quotas, see Fargate quotas in the Amazon Web Services General Reference .

                      For jobs that are running on Fargate resources, then value must match one of the supported values and the MEMORY values must be one of the values supported for that VCPU value. The supported values are 0.25, 0.5, 1, 2, 4, 8, and 16

                      value = 0.25

                      MEMORY = 512, 1024, or 2048

                      value = 0.5

                      MEMORY = 1024, 2048, 3072, or 4096

                      value = 1

                      MEMORY = 2048, 3072, 4096, 5120, 6144, 7168, or 8192

                      value = 2

                      MEMORY = 4096, 5120, 6144, 7168, 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, or 16384

                      value = 4

                      MEMORY = 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, 16384, 17408, 18432, 19456, 20480, 21504, 22528, 23552, 24576, 25600, 26624, 27648, 28672, 29696, or 30720

                      value = 8

                      MEMORY = 16384, 20480, 24576, 28672, 32768, 36864, 40960, 45056, 49152, 53248, 57344, or 61440

                      value = 16

                      MEMORY = 32768, 40960, 49152, 57344, 65536, 73728, 81920, 90112, 98304, 106496, 114688, or 122880

                    • type (string) -- [REQUIRED]

                      The type of resource to assign to a container. The supported resources include GPU , MEMORY , and VCPU .

      • instanceTypes (list) --

        An object that contains the instance types that you want to replace for the existing resources of a job.

        • (string) --

type retryStrategy

dict

param retryStrategy

The retry strategy to use for failed jobs from this SubmitJob operation. When a retry strategy is specified here, it overrides the retry strategy defined in the job definition.

  • attempts (integer) --

    The number of times to move a job to the RUNNABLE status. You can specify between 1 and 10 attempts. If the value of attempts is greater than one, the job is retried on failure the same number of attempts as the value.

  • evaluateOnExit (list) --

    Array of up to 5 objects that specify the conditions where jobs are retried or failed. If this parameter is specified, then the attempts parameter must also be specified. If none of the listed conditions match, then the job is retried.

    • (dict) --

      Specifies an array of up to 5 conditions to be met, and an action to take ( RETRY or EXIT ) if all conditions are met. If none of the EvaluateOnExit conditions in a RetryStrategy match, then the job is retried.

      • onStatusReason (string) --

        Contains a glob pattern to match against the StatusReason returned for a job. The pattern can contain up to 512 characters. It can contain letters, numbers, periods (.), colons (:), and white spaces (including spaces or tabs). It can optionally end with an asterisk (*) so that only the start of the string needs to be an exact match.

      • onReason (string) --

        Contains a glob pattern to match against the Reason returned for a job. The pattern can contain up to 512 characters. It can contain letters, numbers, periods (.), colons (:), and white space (including spaces and tabs). It can optionally end with an asterisk (*) so that only the start of the string needs to be an exact match.

      • onExitCode (string) --

        Contains a glob pattern to match against the decimal representation of the ExitCode returned for a job. The pattern can be up to 512 characters long. It can contain only numbers, and can end with an asterisk (*) so that only the start of the string needs to be an exact match.

        The string can contain up to 512 characters.

      • action (string) -- [REQUIRED]

        Specifies the action to take if all of the specified conditions ( onStatusReason , onReason , and onExitCode ) are met. The values aren't case sensitive.

type propagateTags

boolean

param propagateTags

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 aren't 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. When specified, this overrides the tag propagation setting in the job definition.

type timeout

dict

param timeout

The timeout configuration for this SubmitJob operation. You can specify a timeout duration after which Batch terminates your jobs if they haven't finished. If a job is terminated due to a timeout, it isn't retried. The minimum value for the timeout is 60 seconds. This configuration overrides any timeout configuration specified in the job definition. For array jobs, child jobs have the same timeout configuration as the parent job. For more information, see Job Timeouts in the Amazon Elastic Container Service Developer Guide .

  • attemptDurationSeconds (integer) --

    The job timeout time (in seconds) that's measured from the job attempt's startedAt timestamp. After this time passes, Batch terminates your jobs if they aren't finished. The minimum value for the timeout is 60 seconds.

    For array jobs, the timeout applies to the child jobs, not to the parent array job.

    For multi-node parallel (MNP) jobs, the timeout applies to the whole job, not to the individual nodes.

type tags

dict

param tags

The tags that you apply to the job request 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 Amazon Web Services General Reference .

  • (string) --

    • (string) --

type eksPropertiesOverride

dict

param eksPropertiesOverride

An object, with properties that override defaults for the job definition, can only be specified for jobs that are run on Amazon EKS resources.

  • podProperties (dict) --

    The overrides for the Kubernetes pod resources of a job.

    • containers (list) --

      The overrides for the container that's used on the Amazon EKS pod.

      • (dict) --

        Object representing any Kubernetes overrides to a job definition that's used in a SubmitJob API operation.

        • name (string) --

          A pointer to the container that you want to override. The name must match a unique container name that you wish to override.

        • image (string) --

          The override of the Docker image that's used to start the container.

        • command (list) --

          The command to send to the container that overrides the default command from the Docker image or the job definition.

          • (string) --

        • args (list) --

          The arguments to the entrypoint to send to the container that overrides the default arguments from the Docker image or the job definition. For more information, see Dockerfile reference: CMD and Define a command an arguments for a pod in the Kubernetes documentation .

          • (string) --

        • env (list) --

          The environment variables to send to the container. You can add new environment variables, which are added to the container at launch. Or, you can override the existing environment variables from the Docker image or the job definition.

          Note

          Environment variables cannot start with " AWS_BATCH ". This naming convention is reserved for variables that Batch sets.

          • (dict) --

            An environment variable.

            • name (string) -- [REQUIRED]

              The name of the environment variable.

            • value (string) --

              The value of the environment variable.

        • resources (dict) --

          The type and amount of resources to assign to a container. These override the settings in the job definition. The supported resources include memory , cpu , and nvidia.com/gpu . For more information, see Resource management for pods and containers in the Kubernetes documentation .

          • limits (dict) --

            The type and quantity of the resources to reserve for the container. The values vary based on the name that's specified. Resources can be requested using either the limits or the requests objects.

            memory

            The memory hard limit (in MiB) for the container, using whole integers, with a "Mi" suffix. If your container attempts to exceed the memory specified, the container is terminated. You must specify at least 4 MiB of memory for a job. memory can be specified in limits , requests , or both. If memory is specified in both places, then the value that's specified in limits must be equal to the value that's specified in requests .

            Note

            To maximize your resource utilization, provide your jobs with as much memory as possible for the specific instance type that you are using. To learn how, see Memory management in the Batch User Guide .

            cpu

            The number of CPUs that's reserved for the container. Values must be an even multiple of 0.25 . cpu can be specified in limits , requests , or both. If cpu is specified in both places, then the value that's specified in limits must be at least as large as the value that's specified in requests .

            nvidia.com/gpu

            The number of GPUs that's reserved for the container. Values must be a whole integer. memory can be specified in limits , requests , or both. If memory is specified in both places, then the value that's specified in limits must be equal to the value that's specified in requests .

            • (string) --

              • (string) --

          • requests (dict) --

            The type and quantity of the resources to request for the container. The values vary based on the name that's specified. Resources can be requested by using either the limits or the requests objects.

            memory

            The memory hard limit (in MiB) for the container, using whole integers, with a "Mi" suffix. If your container attempts to exceed the memory specified, the container is terminated. You must specify at least 4 MiB of memory for a job. memory can be specified in limits , requests , or both. If memory is specified in both, then the value that's specified in limits must be equal to the value that's specified in requests .

            Note

            If you're trying to maximize your resource utilization by providing your jobs as much memory as possible for a particular instance type, see Memory management in the Batch User Guide .

            cpu

            The number of CPUs that are reserved for the container. Values must be an even multiple of 0.25 . cpu can be specified in limits , requests , or both. If cpu is specified in both, then the value that's specified in limits must be at least as large as the value that's specified in requests .

            nvidia.com/gpu

            The number of GPUs that are reserved for the container. Values must be a whole integer. nvidia.com/gpu can be specified in limits , requests , or both. If nvidia.com/gpu is specified in both, then the value that's specified in limits must be equal to the value that's specified in requests .

            • (string) --

              • (string) --

    • initContainers (list) --

      The overrides for the conatainers defined in the Amazon EKS pod. These containers run before application containers, always runs to completion, and must complete successfully before the next container starts. These containers are registered with the Amazon EKS Connector agent and persists the registration information in the Kubernetes backend data store. For more information, see Init Containers in the Kubernetes documentation .

      Note

      This object is limited to 10 elements

      • (dict) --

        Object representing any Kubernetes overrides to a job definition that's used in a SubmitJob API operation.

        • name (string) --

          A pointer to the container that you want to override. The name must match a unique container name that you wish to override.

        • image (string) --

          The override of the Docker image that's used to start the container.

        • command (list) --

          The command to send to the container that overrides the default command from the Docker image or the job definition.

          • (string) --

        • args (list) --

          The arguments to the entrypoint to send to the container that overrides the default arguments from the Docker image or the job definition. For more information, see Dockerfile reference: CMD and Define a command an arguments for a pod in the Kubernetes documentation .

          • (string) --

        • env (list) --

          The environment variables to send to the container. You can add new environment variables, which are added to the container at launch. Or, you can override the existing environment variables from the Docker image or the job definition.

          Note

          Environment variables cannot start with " AWS_BATCH ". This naming convention is reserved for variables that Batch sets.

          • (dict) --

            An environment variable.

            • name (string) -- [REQUIRED]

              The name of the environment variable.

            • value (string) --

              The value of the environment variable.

        • resources (dict) --

          The type and amount of resources to assign to a container. These override the settings in the job definition. The supported resources include memory , cpu , and nvidia.com/gpu . For more information, see Resource management for pods and containers in the Kubernetes documentation .

          • limits (dict) --

            The type and quantity of the resources to reserve for the container. The values vary based on the name that's specified. Resources can be requested using either the limits or the requests objects.

            memory

            The memory hard limit (in MiB) for the container, using whole integers, with a "Mi" suffix. If your container attempts to exceed the memory specified, the container is terminated. You must specify at least 4 MiB of memory for a job. memory can be specified in limits , requests , or both. If memory is specified in both places, then the value that's specified in limits must be equal to the value that's specified in requests .

            Note

            To maximize your resource utilization, provide your jobs with as much memory as possible for the specific instance type that you are using. To learn how, see Memory management in the Batch User Guide .

            cpu

            The number of CPUs that's reserved for the container. Values must be an even multiple of 0.25 . cpu can be specified in limits , requests , or both. If cpu is specified in both places, then the value that's specified in limits must be at least as large as the value that's specified in requests .

            nvidia.com/gpu

            The number of GPUs that's reserved for the container. Values must be a whole integer. memory can be specified in limits , requests , or both. If memory is specified in both places, then the value that's specified in limits must be equal to the value that's specified in requests .

            • (string) --

              • (string) --

          • requests (dict) --

            The type and quantity of the resources to request for the container. The values vary based on the name that's specified. Resources can be requested by using either the limits or the requests objects.

            memory

            The memory hard limit (in MiB) for the container, using whole integers, with a "Mi" suffix. If your container attempts to exceed the memory specified, the container is terminated. You must specify at least 4 MiB of memory for a job. memory can be specified in limits , requests , or both. If memory is specified in both, then the value that's specified in limits must be equal to the value that's specified in requests .

            Note

            If you're trying to maximize your resource utilization by providing your jobs as much memory as possible for a particular instance type, see Memory management in the Batch User Guide .

            cpu

            The number of CPUs that are reserved for the container. Values must be an even multiple of 0.25 . cpu can be specified in limits , requests , or both. If cpu is specified in both, then the value that's specified in limits must be at least as large as the value that's specified in requests .

            nvidia.com/gpu

            The number of GPUs that are reserved for the container. Values must be a whole integer. nvidia.com/gpu can be specified in limits , requests , or both. If nvidia.com/gpu is specified in both, then the value that's specified in limits must be equal to the value that's specified in requests .

            • (string) --

              • (string) --

    • metadata (dict) --

      Metadata about the overrides for the container that's used on the Amazon EKS pod.

      • labels (dict) --

        Key-value pairs used to identify, sort, and organize cube resources. Can contain up to 63 uppercase letters, lowercase letters, numbers, hyphens (-), and underscores (_). Labels can be added or modified at any time. Each resource can have multiple labels, but each key must be unique for a given object.

        • (string) --

          • (string) --

type ecsPropertiesOverride

dict

param ecsPropertiesOverride

An object, with properties that override defaults for the job definition, can only be specified for jobs that are run on Amazon ECS resources.

  • taskProperties (list) --

    The overrides for the Amazon ECS task definition of a job.

    Note

    This object is currently limited to one element.

    • (dict) --

      An object that contains overrides for the task definition of a job.

      • containers (list) --

        The overrides for the container definition of a job.

        • (dict) --

          The overrides that should be sent to a container.

          For information about using Batch overrides when you connect event sources to targets, see BatchContainerOverrides.

          • command (list) --

            The command to send to the container that overrides the default command from the Docker image or the job definition.

            Note

            This parameter can't contain an empty string.

            • (string) --

          • environment (list) --

            The environment variables to send to the container. You can add new environment variables, which are added to the container at launch, or you can override the existing environment variables from the Docker image or the job definition.

            Note

            Environment variables cannot start with AWS_BATCH . This naming convention is reserved for variables that Batch sets.

            • (dict) --

              A key-value pair object.

              • name (string) --

                The name of the key-value pair. For environment variables, this is the name of the environment variable.

              • value (string) --

                The value of the key-value pair. For environment variables, this is the value of the environment variable.

          • name (string) --

            A pointer to the container that you want to override. The container's name provides a unique identifier for the container being used.

          • resourceRequirements (list) --

            The type and amount of resources to assign to a container. This overrides the settings in the job definition. The supported resources include GPU , MEMORY , and VCPU .

            • (dict) --

              The type and amount of a resource to assign to a container. The supported resources include GPU , MEMORY , and VCPU .

              • value (string) -- [REQUIRED]

                The quantity of the specified resource to reserve for the container. The values vary based on the type specified.

                type="GPU"

                The number of physical GPUs to reserve for the container. Make sure that the number of GPUs reserved for all containers in a job doesn't exceed the number of available GPUs on the compute resource that the job is launched on.

                Note

                GPUs aren't available for jobs that are running on Fargate resources.

                type="MEMORY"

                The memory hard limit (in MiB) present to the container. This parameter is supported for jobs that are running on Amazon EC2 resources. If your container attempts to exceed the memory specified, the container is terminated. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run. You must specify at least 4 MiB of memory for a job. This is required but can be specified in several places for multi-node parallel (MNP) jobs. It must be specified for each node at least once. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run.

                Note

                If you're trying to maximize your resource utilization by providing your jobs as much memory as possible for a particular instance type, see Memory management in the Batch User Guide .

                For jobs that are running on Fargate resources, then value is the hard limit (in MiB), and must match one of the supported values and the VCPU values must be one of the values supported for that memory value.

                value = 512

                VCPU = 0.25

                value = 1024

                VCPU = 0.25 or 0.5

                value = 2048

                VCPU = 0.25, 0.5, or 1

                value = 3072

                VCPU = 0.5, or 1

                value = 4096

                VCPU = 0.5, 1, or 2

                value = 5120, 6144, or 7168

                VCPU = 1 or 2

                value = 8192

                VCPU = 1, 2, or 4

                value = 9216, 10240, 11264, 12288, 13312, 14336, or 15360

                VCPU = 2 or 4

                value = 16384

                VCPU = 2, 4, or 8

                value = 17408, 18432, 19456, 21504, 22528, 23552, 25600, 26624, 27648, 29696, or 30720

                VCPU = 4

                value = 20480, 24576, or 28672

                VCPU = 4 or 8

                value = 36864, 45056, 53248, or 61440

                VCPU = 8

                value = 32768, 40960, 49152, or 57344

                VCPU = 8 or 16

                value = 65536, 73728, 81920, 90112, 98304, 106496, 114688, or 122880

                VCPU = 16

                type="VCPU"

                The number of vCPUs reserved for the container. This parameter maps to CpuShares in the Create a container section of the Docker Remote API and the --cpu-shares option to docker run. Each vCPU is equivalent to 1,024 CPU shares. For Amazon EC2 resources, you must specify at least one vCPU. This is required but can be specified in several places; it must be specified for each node at least once.

                The default for the Fargate On-Demand vCPU resource count quota is 6 vCPUs. For more information about Fargate quotas, see Fargate quotas in the Amazon Web Services General Reference .

                For jobs that are running on Fargate resources, then value must match one of the supported values and the MEMORY values must be one of the values supported for that VCPU value. The supported values are 0.25, 0.5, 1, 2, 4, 8, and 16

                value = 0.25

                MEMORY = 512, 1024, or 2048

                value = 0.5

                MEMORY = 1024, 2048, 3072, or 4096

                value = 1

                MEMORY = 2048, 3072, 4096, 5120, 6144, 7168, or 8192

                value = 2

                MEMORY = 4096, 5120, 6144, 7168, 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, or 16384

                value = 4

                MEMORY = 8192, 9216, 10240, 11264, 12288, 13312, 14336, 15360, 16384, 17408, 18432, 19456, 20480, 21504, 22528, 23552, 24576, 25600, 26624, 27648, 28672, 29696, or 30720

                value = 8

                MEMORY = 16384, 20480, 24576, 28672, 32768, 36864, 40960, 45056, 49152, 53248, 57344, or 61440

                value = 16

                MEMORY = 32768, 40960, 49152, 57344, 65536, 73728, 81920, 90112, 98304, 106496, 114688, or 122880

              • type (string) -- [REQUIRED]

                The type of resource to assign to a container. The supported resources include GPU , MEMORY , and VCPU .

rtype

dict

returns

Response Syntax

{
    'jobArn': 'string',
    'jobName': 'string',
    'jobId': 'string'
}

Response Structure

  • (dict) --

    • jobArn (string) --

      The Amazon Resource Name (ARN) for the job.

    • jobName (string) --

      The name of the job.

    • jobId (string) --

      The unique identifier for the job.