Braket / Client / get_quantum_task
get_quantum_task¶
- Braket.Client.get_quantum_task(**kwargs)¶
Retrieves the specified quantum task.
See also: AWS API Documentation
Request Syntax
response = client.get_quantum_task( quantumTaskArn='string', additionalAttributeNames=[ 'QueueInfo', ] )
- Parameters:
quantumTaskArn (string) –
[REQUIRED]
The ARN of the quantum task to retrieve.
additionalAttributeNames (list) –
A list of attributes to return additional information for. Only the QueueInfo additional attribute name is currently supported.
(string) –
- Return type:
dict
- Returns:
Response Syntax
{ 'quantumTaskArn': 'string', 'status': 'CREATED'|'QUEUED'|'RUNNING'|'COMPLETED'|'FAILED'|'CANCELLING'|'CANCELLED', 'failureReason': 'string', 'deviceArn': 'string', 'deviceParameters': 'string', 'shots': 123, 'outputS3Bucket': 'string', 'outputS3Directory': 'string', 'createdAt': datetime(2015, 1, 1), 'endedAt': datetime(2015, 1, 1), 'tags': { 'string': 'string' }, 'jobArn': 'string', 'queueInfo': { 'queue': 'QUANTUM_TASKS_QUEUE'|'JOBS_QUEUE', 'position': 'string', 'queuePriority': 'Normal'|'Priority', 'message': 'string' }, 'associations': [ { 'arn': 'string', 'type': 'RESERVATION_TIME_WINDOW_ARN' }, ], 'numSuccessfulShots': 123, 'actionMetadata': { 'actionType': 'string', 'programCount': 123, 'executableCount': 123 } }
Response Structure
(dict) –
quantumTaskArn (string) –
The ARN of the quantum task.
status (string) –
The status of the quantum task.
failureReason (string) –
The reason that a quantum task failed.
deviceArn (string) –
The ARN of the device the quantum task was run on.
deviceParameters (string) –
The parameters for the device on which the quantum task ran.
shots (integer) –
The number of shots used in the quantum task.
outputS3Bucket (string) –
The S3 bucket where quantum task results are stored.
outputS3Directory (string) –
The folder in the S3 bucket where quantum task results are stored.
createdAt (datetime) –
The time at which the quantum task was created.
endedAt (datetime) –
The time at which the quantum task ended.
tags (dict) –
The tags that belong to this quantum task.
(string) –
(string) –
jobArn (string) –
The ARN of the Amazon Braket job associated with the quantum task.
queueInfo (dict) –
Queue information for the requested quantum task. Only returned if
QueueInfo
is specified in theadditionalAttributeNames"
field in theGetQuantumTask
API request.queue (string) –
The name of the queue.
position (string) –
Current position of the quantum task in the quantum tasks queue.
queuePriority (string) –
Optional. Specifies the priority of the queue. Quantum tasks in a priority queue are processed before the quantum tasks in a normal queue.
message (string) –
Optional. Provides more information about the queue position. For example, if the quantum task is complete and no longer in the queue, the message field contains that information.
associations (list) –
The list of Amazon Braket resources associated with the quantum task.
(dict) –
The Amazon Braket resource and the association type.
arn (string) –
The Amazon Braket resource arn.
type (string) –
The association type for the specified Amazon Braket resource arn.
numSuccessfulShots (integer) –
The number of successful shots for the quantum task. This is available after a successfully completed quantum task.
actionMetadata (dict) –
Metadata about the action performed by the quantum task, including information about the type of action and program counts.
actionType (string) –
The type of action associated with the quantum task.
programCount (integer) –
The number of programs in a program set. This is only available for a Program Set.
executableCount (integer) –
The number of executables in a program set. This is only available for a Program Set.
Exceptions