IAmazonBatch.SubmitJob Method (SubmitJobRequest)

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.

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

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.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to SubmitJobAsync.

Namespace: Amazon.Batch
Assembly: AWSSDK.Batch.dll
Version: 3.x.y.z

Syntax

public abstract SubmitJobResponse SubmitJob(
         SubmitJobRequest request
)

Parameters

request: Type: Amazon.Batch.Model.SubmitJobRequest

Container for the necessary parameters to execute the SubmitJob service method.

Return Value

Type: SubmitJobResponse

The response from the SubmitJob service method, as returned by Batch.

Exceptions

Exception	Condition
ClientException	These errors are usually caused by a client action. One example cause is using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Another cause is specifying an identifier that's not valid.
ServerException	These errors are usually caused by a server issue.

Examples

This example submits a simple container job called example to the HighPriority job queue.

To submit a job to a queue


var client = new AmazonBatchClient();
var response = client.SubmitJob(new SubmitJobRequest 
{
    JobDefinition = "sleep60",
    JobName = "example",
    JobQueue = "HighPriority"
});

string jobId = response.JobId;
string jobName = response.JobName;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

IAmazonBatch.SubmitJob (SubmitJobRequest)

Method