CreateJob - Amazon Braket


Creates an Amazon Braket job.

Request Syntax

POST /job HTTP/1.1 Content-type: application/json { "algorithmSpecification": { "containerImage": { "uri": "string" }, "scriptModeConfig": { "compressionType": "string", "entryPoint": "string", "s3Uri": "string" } }, "checkpointConfig": { "localPath": "string", "s3Uri": "string" }, "clientToken": "string", "deviceConfig": { "device": "string" }, "hyperParameters": { "string" : "string" }, "inputDataConfig": [ { "channelName": "string", "contentType": "string", "dataSource": { "s3DataSource": { "s3Uri": "string" } } } ], "instanceConfig": { "instanceCount": number, "instanceType": "string", "volumeSizeInGb": number }, "jobName": "string", "outputDataConfig": { "kmsKeyId": "string", "s3Path": "string" }, "roleArn": "string", "stoppingCondition": { "maxRuntimeInSeconds": number }, "tags": { "string" : "string" } }

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.


Definition of the Amazon Braket job to be created. Specifies the container image the job uses and information about the Python scripts used for entry and training.

Type: AlgorithmSpecification object

Required: Yes


Information about the output locations for job checkpoint data.

Type: JobCheckpointConfig object

Required: No


A unique token that guarantees that the call to this API is idempotent.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: Yes


The quantum processing unit (QPU) or simulator used to create an Amazon Braket job.

Type: DeviceConfig object

Required: Yes


Algorithm-specific parameters used by an Amazon Braket job that influence the quality of the training job. The values are set with a string of JSON key:value pairs, where the key is the name of the hyperparameter and the value is the value of th hyperparameter.

Type: String to string map

Map Entries: Minimum number of 0 items. Maximum number of 100 items.

Key Length Constraints: Minimum length of 1. Maximum length of 256.

Value Length Constraints: Minimum length of 1. Maximum length of 2500.

Required: No


A list of parameters that specify the name and type of input data and where it is located.

Type: Array of InputFileConfig objects

Array Members: Minimum number of 0 items. Maximum number of 20 items.

Required: No


Configuration of the resource instances to use while running the hybrid job on Amazon Braket.

Type: InstanceConfig object

Required: Yes


The name of the Amazon Braket job.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 50.

Pattern: ^[a-zA-Z0-9](-*[a-zA-Z0-9]){0,50}$

Required: Yes


The path to the S3 location where you want to store job artifacts and the encryption key used to store them.

Type: JobOutputDataConfig object

Required: Yes


The Amazon Resource Name (ARN) of an IAM role that Amazon Braket can assume to perform tasks on behalf of a user. It can access user resources, run an Amazon Braket job container on behalf of user, and output resources to the users' s3 buckets.

Type: String

Pattern: ^arn:aws[a-z\-]*:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+$

Required: Yes


The user-defined criteria that specifies when a job stops running.

Type: JobStoppingCondition object

Required: No


A tag object that consists of a key and an optional value, used to manage metadata for Amazon Braket resources.

Type: String to string map

Required: No

Response Syntax

HTTP/1.1 201 Content-type: application/json { "jobArn": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.


The ARN of the Amazon Braket job created.

Type: String

Pattern: ^arn:aws[a-z\-]*:braket:[a-z0-9\-]*:[0-9]{12}:job/.*$


For information about the errors that are common to all actions, see Common Errors.


You do not have sufficient access to perform this action.

HTTP Status Code: 403


An error occurred due to a conflict.

HTTP Status Code: 409


The specified device has been retired.

HTTP Status Code: 410


The request processing has failed because of an unknown error, exception, or failure.

HTTP Status Code: 500


The request failed because a service quota is exceeded.

HTTP Status Code: 402


The throttling rate limit is met.

HTTP Status Code: 429


The input fails to satisfy the constraints specified by an AWS service.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: