Expand description
Using AWS Batch, you can run batch computing workloads on the AWS Cloud. Batch computing is a common means for developers, scientists, and engineers to access large amounts of compute resources. AWS Batch uses the advantages of this computing workload to remove the undifferentiated heavy lifting of configuring and managing required infrastructure. At the same time, it also adopts a familiar batch computing software approach. Given these advantages, AWS Batch can help you to efficiently provision resources in response to jobs submitted, thus effectively helping you to eliminate capacity constraints, reduce compute costs, and deliver your results more quickly.
As a fully managed service, AWS Batch can run batch computing workloads of any scale. AWS Batch automatically provisions compute resources and optimizes workload distribution based on the quantity and scale of your specific workloads. With AWS Batch, there's no need to install or manage batch computing software. This means that you can focus your time and energy on analyzing results and solving your specific problems.
If you’re using the service, you’re probably looking for BatchClient and Batch.
Structs§
- Array
Properties An object representing an AWS Batch array job.
- Array
Properties Detail An object representing the array properties of a job.
- Array
Properties Summary An object representing the array properties of a job.
- Attempt
Container Detail An object representing the details of a container that's part of a job attempt.
- Attempt
Detail An object representing a job attempt.
- Batch
Client - A client for the AWS Batch API.
- Cancel
JobRequest Contains the parameters for
CancelJob
.- Cancel
JobResponse - Compute
Environment Detail An object representing an AWS Batch compute environment.
- Compute
Environment Order The order in which compute environments are tried for job placement within a queue. Compute environments are tried in ascending order. For example, if two compute environments are associated with a job queue, the compute environment with a lower order integer value is tried for job placement first. Compute environments must be in the
VALID
state before you can associate them with a job queue. All of the compute environments must be either EC2 (EC2
orSPOT
) or Fargate (FARGATE
orFARGATE_SPOT
); EC2 and Fargate compute environments can't be mixed.All compute environments that are associated with a job queue must share the same architecture. AWS Batch doesn't support mixing compute environment architecture types in a single job queue.
- Compute
Resource An object representing an AWS Batch compute resource. For more information, see Compute Environments in the AWS Batch User Guide.
- Compute
Resource Update An object representing the attributes of a compute environment that can be updated. For more information, see Compute Environments in the AWS Batch User Guide.
- Container
Detail An object representing the details of a container that's part of a job.
- Container
Overrides The overrides that should be sent to a container.
- Container
Properties Container properties are used in job definitions to describe the container that's launched as part of a job.
- Container
Summary An object representing summary details of a container within a job.
- Create
Compute Environment Request Contains the parameters for
CreateComputeEnvironment
.- Create
Compute Environment Response - Create
JobQueue Request Contains the parameters for
CreateJobQueue
.- Create
JobQueue Response - Delete
Compute Environment Request Contains the parameters for
DeleteComputeEnvironment
.- Delete
Compute Environment Response - Delete
JobQueue Request Contains the parameters for
DeleteJobQueue
.- Delete
JobQueue Response - Deregister
JobDefinition Request - Deregister
JobDefinition Response - Describe
Compute Environments Request Contains the parameters for
DescribeComputeEnvironments
.- Describe
Compute Environments Response - Describe
JobDefinitions Request Contains the parameters for
DescribeJobDefinitions
.- Describe
JobDefinitions Response - Describe
JobQueues Request Contains the parameters for
DescribeJobQueues
.- Describe
JobQueues Response - Describe
Jobs Request Contains the parameters for
DescribeJobs
.- Describe
Jobs Response - Device
An object representing a container instance host device.
This object isn't applicable to jobs running on Fargate resources and shouldn't be provided.
- EFSAuthorization
Config The authorization configuration details for the Amazon EFS file system.
- EFSVolume
Configuration This parameter is specified when you are using an Amazon Elastic File System file system for task storage. For more information, see Amazon EFS Volumes in the AWS Batch User Guide.
- Ec2Configuration
Provides information used to select Amazon Machine Images (AMIs) for instances in the compute environment. If
Ec2Configuration
isn't specified, the default is currentlyECSAL1
(<a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimizedAMI.html#alami">Amazon Linux) for non-GPU, non-Graviton instances. Starting on March 31, 2021, this default will be changing toECSAL2
(<a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimizedAMI.html#al2ami">Amazon Linux 2).This object isn't applicable to jobs running on Fargate resources.
- Evaluate
OnExit Specifies a set of conditions to be met, and an action to take (
RETRY
orEXIT
) if all conditions are met.- Fargate
Platform Configuration The platform configuration for jobs running on Fargate resources. For jobs that run on EC2 resources, you shouldn't specify this parameter.
- Host
Determine whether your data volume persists on the host container instance and where it is stored. If this parameter is empty, then the Docker daemon assigns a host path for your data volume, but the data isn't guaranteed to persist after the containers associated with it stop running.
- JobDefinition
An object representing an AWS Batch job definition.
- JobDependency
An object representing an AWS Batch job dependency.
- JobDetail
An object representing an AWS Batch job.
- JobQueue
Detail An object representing the details of an AWS Batch job queue.
- JobSummary
An object representing summary details of a job.
- JobTimeout
An object representing a job timeout configuration.
- KeyValue
Pair A key-value pair object.
- Launch
Template Specification An object representing a launch template associated with a compute resource. You must specify either the launch template ID or launch template name in the request, but not both.
If security groups are specified using both the
securityGroupIds
parameter ofCreateComputeEnvironment
and the launch template, the values in thesecurityGroupIds
parameter ofCreateComputeEnvironment
will be used.This object isn't applicable to jobs running on Fargate resources.
- Linux
Parameters Linux-specific modifications that are applied to the container, such as details for device mappings.
- List
Jobs Request Contains the parameters for
ListJobs
.- List
Jobs Response - List
Tags ForResource Request - List
Tags ForResource Response - LogConfiguration
Log configuration options to send to a custom log driver for the container.
- Mount
Point Details on a Docker volume mount point that's used in a job's container properties. This parameter maps to
Volumes
in the Create a container section of the Docker Remote API and the--volume
option to docker run.- Network
Configuration The network configuration for jobs running on Fargate resources. Jobs running on EC2 resources must not specify this parameter.
- Network
Interface An object representing the elastic network interface for a multi-node parallel job node.
- Node
Details An object representing the details of a multi-node parallel job node.
- Node
Overrides Object representing any node overrides to a job definition that's used in a SubmitJob API operation.
This isn't applicable to jobs running on Fargate resources and shouldn't be provided; use
containerOverrides
instead.- Node
Properties An object representing the node properties of a multi-node parallel job.
- Node
Properties Summary An object representing the properties of a node that's associated with a multi-node parallel job.
- Node
Property Override Object representing any node overrides to a job definition that's used in a SubmitJob API operation.
- Node
Range Property An object representing the properties of the node range for a multi-node parallel job.
- Register
JobDefinition Request Contains the parameters for
RegisterJobDefinition
.- Register
JobDefinition Response - Resource
Requirement The type and amount of a resource to assign to a container. The supported resources include
GPU
,MEMORY
, andVCPU
.- Retry
Strategy The retry strategy associated with a job. For more information, see Automated job retries in the AWS Batch User Guide.
- Secret
An object representing the secret to expose to your container. Secrets can be exposed to a container in the following ways:
-
To inject sensitive data into your containers as environment variables, use the
secrets
container definition parameter. -
To reference sensitive information in the log configuration of a container, use the
secretOptions
container definition parameter.
For more information, see Specifying sensitive data in the AWS Batch User Guide.
-
- Submit
JobRequest Contains the parameters for
SubmitJob
.- Submit
JobResponse - TagResource
Request - TagResource
Response - Terminate
JobRequest Contains the parameters for
TerminateJob
.- Terminate
JobResponse - Tmpfs
The container path, mount options, and size of the tmpfs mount.
This object isn't applicable to jobs running on Fargate resources.
- Ulimit
The
ulimit
settings to pass to the container.This object isn't applicable to jobs running on Fargate resources.
- Untag
Resource Request - Untag
Resource Response - Update
Compute Environment Request Contains the parameters for
UpdateComputeEnvironment
.- Update
Compute Environment Response - Update
JobQueue Request Contains the parameters for
UpdateJobQueue
.- Update
JobQueue Response - Volume
A data volume used in a job's container properties.
Enums§
- Cancel
JobError - Errors returned by CancelJob
- Create
Compute Environment Error - Errors returned by CreateComputeEnvironment
- Create
JobQueue Error - Errors returned by CreateJobQueue
- Delete
Compute Environment Error - Errors returned by DeleteComputeEnvironment
- Delete
JobQueue Error - Errors returned by DeleteJobQueue
- Deregister
JobDefinition Error - Errors returned by DeregisterJobDefinition
- Describe
Compute Environments Error - Errors returned by DescribeComputeEnvironments
- Describe
JobDefinitions Error - Errors returned by DescribeJobDefinitions
- Describe
JobQueues Error - Errors returned by DescribeJobQueues
- Describe
Jobs Error - Errors returned by DescribeJobs
- List
Jobs Error - Errors returned by ListJobs
- List
Tags ForResource Error - Errors returned by ListTagsForResource
- Register
JobDefinition Error - Errors returned by RegisterJobDefinition
- Submit
JobError - Errors returned by SubmitJob
- TagResource
Error - Errors returned by TagResource
- Terminate
JobError - Errors returned by TerminateJob
- Untag
Resource Error - Errors returned by UntagResource
- Update
Compute Environment Error - Errors returned by UpdateComputeEnvironment
- Update
JobQueue Error - Errors returned by UpdateJobQueue
Traits§
- Batch
- Trait representing the capabilities of the AWS Batch API. AWS Batch clients implement this trait.