aws-sdk-braket 1.56.0 → 1.57.0

data/lib/aws-sdk-braket/client.rb

@@ -476,15 +476,15 @@ module Aws::Braket
 
     # @!group API Operations
 
-    # Cancels an Amazon Braket job.
+    # Cancels an Amazon Braket hybrid job.
     #
     # @option params [required, String] :job_arn
-    #   The ARN of the Amazon Braket job to cancel.
+    #   The ARN of the Amazon Braket hybrid job to cancel.
     #
     # @return [Types::CancelJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::CancelJobResponse#cancellation_status #cancellation_status} => String
     #   * {Types::CancelJobResponse#job_arn #job_arn} => String
+    #   * {Types::CancelJobResponse#cancellation_status #cancellation_status} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -494,8 +494,8 @@ module Aws::Braket
     #
     # @example Response structure
     #
-    #   resp.cancellation_status #=> String, one of "CANCELLING", "CANCELLED"
     #   resp.job_arn #=> String
+    #   resp.cancellation_status #=> String, one of "CANCELLING", "CANCELLED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/CancelJob AWS API Documentation
     #
@@ -508,31 +508,31 @@ module Aws::Braket
 
     # Cancels the specified task.
     #
+    # @option params [required, String] :quantum_task_arn
+    #   The ARN of the quantum task to cancel.
+    #
     # @option params [required, String] :client_token
-    #   The client token associated with the request.
+    #   The client token associated with the cancellation request.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
-    # @option params [required, String] :quantum_task_arn
-    #   The ARN of the task to cancel.
-    #
     # @return [Types::CancelQuantumTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::CancelQuantumTaskResponse#cancellation_status #cancellation_status} => String
     #   * {Types::CancelQuantumTaskResponse#quantum_task_arn #quantum_task_arn} => String
+    #   * {Types::CancelQuantumTaskResponse#cancellation_status #cancellation_status} => String
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.cancel_quantum_task({
-    #     client_token: "String64", # required
     #     quantum_task_arn: "QuantumTaskArn", # required
+    #     client_token: "String64", # required
     #   })
     #
     # @example Response structure
     #
-    #   resp.cancellation_status #=> String, one of "CANCELLING", "CANCELLED"
     #   resp.quantum_task_arn #=> String
+    #   resp.cancellation_status #=> String, one of "CANCELLING", "CANCELLED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/CancelQuantumTask AWS API Documentation
     #
@@ -543,63 +543,70 @@ module Aws::Braket
       req.send_request(options)
     end
 
-    # Creates an Amazon Braket job.
-    #
-    # @option params [required, Types::AlgorithmSpecification] :algorithm_specification
-    #   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.
-    #
-    # @option params [Array<Types::Association>] :associations
-    #   The list of Amazon Braket resources associated with the hybrid job.
-    #
-    # @option params [Types::JobCheckpointConfig] :checkpoint_config
-    #   Information about the output locations for job checkpoint data.
+    # Creates an Amazon Braket hybrid job.
     #
     # @option params [required, String] :client_token
-    #   A unique token that guarantees that the call to this API is
-    #   idempotent.
+    #   The client token associated with this request that guarantees that the
+    #   request is idempotent.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
-    # @option params [required, Types::DeviceConfig] :device_config
-    #   The quantum processing unit (QPU) or simulator used to create an
-    #   Amazon Braket job.
-    #
-    # @option params [Hash<String,String>] :hyper_parameters
-    #   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.
+    # @option params [required, Types::AlgorithmSpecification] :algorithm_specification
+    #   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.
     #
     # @option params [Array<Types::InputFileConfig>] :input_data_config
     #   A list of parameters that specify the name and type of input data and
     #   where it is located.
     #
-    # @option params [required, Types::InstanceConfig] :instance_config
-    #   Configuration of the resource instances to use while running the
-    #   hybrid job on Amazon Braket.
+    # @option params [required, Types::JobOutputDataConfig] :output_data_config
+    #   The path to the S3 location where you want to store hybrid job
+    #   artifacts and the encryption key used to store them.
     #
-    # @option params [required, String] :job_name
-    #   The name of the Amazon Braket job.
+    # @option params [Types::JobCheckpointConfig] :checkpoint_config
+    #   Information about the output locations for hybrid job checkpoint data.
     #
-    # @option params [required, Types::JobOutputDataConfig] :output_data_config
-    #   The path to the S3 location where you want to store job artifacts and
-    #   the encryption key used to store them.
+    # @option params [required, String] :job_name
+    #   The name of the Amazon Braket hybrid job.
     #
     # @option params [required, String] :role_arn
     #   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.
+    #   output results and hybrid job details to the users' s3 buckets.
     #
     # @option params [Types::JobStoppingCondition] :stopping_condition
-    #   The user-defined criteria that specifies when a job stops running.
+    #   The user-defined criteria that specifies when a hybrid job stops
+    #   running.
+    #
+    # @option params [required, Types::InstanceConfig] :instance_config
+    #   Configuration of the resource instances to use while running the
+    #   hybrid job on Amazon Braket.
+    #
+    # @option params [Hash<String,String>] :hyper_parameters
+    #   Algorithm-specific parameters used by an Amazon Braket hybrid job that
+    #   influence the quality of the training job. The values are set with a
+    #   map of JSON key:value pairs, where the key is the name of the
+    #   hyperparameter and the value is the value of the hyperparameter.
+    #
+    #   Do not include any security-sensitive information including account
+    #   access IDs, secrets, or tokens in any hyperparameter fields. As part
+    #   of the shared responsibility model, you are responsible for any
+    #   potential exposure, unauthorized access, or compromise of your
+    #   sensitive data if caused by security-sensitive information included in
+    #   the request hyperparameter variable or plain text fields.
+    #
+    # @option params [required, Types::DeviceConfig] :device_config
+    #   The quantum processing unit (QPU) or simulator used to create an
+    #   Amazon Braket hybrid job.
     #
     # @option params [Hash<String,String>] :tags
-    #   A tag object that consists of a key and an optional value, used to
-    #   manage metadata for Amazon Braket resources.
+    #   Tags to be added to the hybrid job you're creating.
+    #
+    # @option params [Array<Types::Association>] :associations
+    #   The list of Amazon Braket resources associated with the hybrid job.
     #
     # @return [Types::CreateJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -608,32 +615,16 @@ module Aws::Braket
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_job({
+    #     client_token: "String64", # required
     #     algorithm_specification: { # required
-    #       container_image: {
-    #         uri: "Uri", # required
-    #       },
     #       script_mode_config: {
-    #         compression_type: "NONE", # accepts NONE, GZIP
     #         entry_point: "String", # required
     #         s3_uri: "S3Path", # required
+    #         compression_type: "NONE", # accepts NONE, GZIP
     #       },
-    #     },
-    #     associations: [
-    #       {
-    #         arn: "BraketResourceArn", # required
-    #         type: "RESERVATION_TIME_WINDOW_ARN", # required, accepts RESERVATION_TIME_WINDOW_ARN
+    #       container_image: {
+    #         uri: "Uri", # required
     #       },
-    #     ],
-    #     checkpoint_config: {
-    #       local_path: "String4096",
-    #       s3_uri: "S3Path", # required
-    #     },
-    #     client_token: "String64", # required
-    #     device_config: { # required
-    #       device: "String256", # required
-    #     },
-    #     hyper_parameters: {
-    #       "String256" => "HyperParametersValueString",
     #     },
     #     input_data_config: [
     #       {
@@ -646,23 +637,39 @@ module Aws::Braket
     #         },
     #       },
     #     ],
-    #     instance_config: { # required
-    #       instance_count: 1,
-    #       instance_type: "ml.m4.xlarge", # required, accepts ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.g4dn.xlarge, ml.g4dn.2xlarge, ml.g4dn.4xlarge, ml.g4dn.8xlarge, ml.g4dn.12xlarge, ml.g4dn.16xlarge, ml.m5.large, ml.m5.xlarge, ml.m5.2xlarge, ml.m5.4xlarge, ml.m5.12xlarge, ml.m5.24xlarge, ml.c4.xlarge, ml.c4.2xlarge, ml.c4.4xlarge, ml.c4.8xlarge, ml.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge, ml.p3dn.24xlarge, ml.p4d.24xlarge, ml.c5.xlarge, ml.c5.2xlarge, ml.c5.4xlarge, ml.c5.9xlarge, ml.c5.18xlarge, ml.c5n.xlarge, ml.c5n.2xlarge, ml.c5n.4xlarge, ml.c5n.9xlarge, ml.c5n.18xlarge
-    #       volume_size_in_gb: 1, # required
-    #     },
-    #     job_name: "CreateJobRequestJobNameString", # required
     #     output_data_config: { # required
     #       kms_key_id: "String2048",
     #       s3_path: "S3Path", # required
     #     },
+    #     checkpoint_config: {
+    #       local_path: "String4096",
+    #       s3_uri: "S3Path", # required
+    #     },
+    #     job_name: "CreateJobRequestJobNameString", # required
     #     role_arn: "RoleArn", # required
     #     stopping_condition: {
     #       max_runtime_in_seconds: 1,
     #     },
+    #     instance_config: { # required
+    #       instance_type: "ml.m4.xlarge", # required, accepts ml.m4.xlarge, ml.m4.2xlarge, ml.m4.4xlarge, ml.m4.10xlarge, ml.m4.16xlarge, ml.g4dn.xlarge, ml.g4dn.2xlarge, ml.g4dn.4xlarge, ml.g4dn.8xlarge, ml.g4dn.12xlarge, ml.g4dn.16xlarge, ml.m5.large, ml.m5.xlarge, ml.m5.2xlarge, ml.m5.4xlarge, ml.m5.12xlarge, ml.m5.24xlarge, ml.c4.xlarge, ml.c4.2xlarge, ml.c4.4xlarge, ml.c4.8xlarge, ml.p2.xlarge, ml.p2.8xlarge, ml.p2.16xlarge, ml.p3.2xlarge, ml.p3.8xlarge, ml.p3.16xlarge, ml.p3dn.24xlarge, ml.p4d.24xlarge, ml.c5.xlarge, ml.c5.2xlarge, ml.c5.4xlarge, ml.c5.9xlarge, ml.c5.18xlarge, ml.c5n.xlarge, ml.c5n.2xlarge, ml.c5n.4xlarge, ml.c5n.9xlarge, ml.c5n.18xlarge
+    #       volume_size_in_gb: 1, # required
+    #       instance_count: 1,
+    #     },
+    #     hyper_parameters: {
+    #       "String256" => "HyperParametersValueString",
+    #     },
+    #     device_config: { # required
+    #       device: "String256", # required
+    #     },
     #     tags: {
     #       "String" => "String",
     #     },
+    #     associations: [
+    #       {
+    #         arn: "BraketResourceArn", # required
+    #         type: "RESERVATION_TIME_WINDOW_ARN", # required, accepts RESERVATION_TIME_WINDOW_ARN
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -680,16 +687,6 @@ module Aws::Braket
 
     # Creates a quantum task.
     #
-    # @option params [required, String] :action
-    #   The action associated with the task.
-    #
-    #   **SDK automatically handles json encoding and base64 encoding for you
-    #   when the required value (Hash, Array, etc.) is provided according to
-    #   the description.**
-    #
-    # @option params [Array<Types::Association>] :associations
-    #   The list of Amazon Braket resources associated with the quantum task.
-    #
     # @option params [required, String] :client_token
     #   The client token associated with the request.
     #
@@ -697,32 +694,42 @@ module Aws::Braket
     #   not need to pass this option.**
     #
     # @option params [required, String] :device_arn
-    #   The ARN of the device to run the task on.
+    #   The ARN of the device to run the quantum task on.
     #
     # @option params [String] :device_parameters
-    #   The parameters for the device to run the task on.
+    #   The parameters for the device to run the quantum task on.
     #
     #   **SDK automatically handles json encoding and base64 encoding for you
     #   when the required value (Hash, Array, etc.) is provided according to
     #   the description.**
     #
-    # @option params [String] :job_token
-    #   The token for an Amazon Braket job that associates it with the quantum
-    #   task.
+    # @option params [required, Integer] :shots
+    #   The number of shots to use for the quantum task.
     #
     # @option params [required, String] :output_s3_bucket
-    #   The S3 bucket to store task result files in.
+    #   The S3 bucket to store quantum task result files in.
     #
     # @option params [required, String] :output_s3_key_prefix
-    #   The key prefix for the location in the S3 bucket to store task results
-    #   in.
+    #   The key prefix for the location in the S3 bucket to store quantum task
+    #   results in.
     #
-    # @option params [required, Integer] :shots
-    #   The number of shots to use for the task.
+    # @option params [required, String] :action
+    #   The action associated with the quantum task.
+    #
+    #   **SDK automatically handles json encoding and base64 encoding for you
+    #   when the required value (Hash, Array, etc.) is provided according to
+    #   the description.**
     #
     # @option params [Hash<String,String>] :tags
     #   Tags to be added to the quantum task you're creating.
     #
+    # @option params [String] :job_token
+    #   The token for an Amazon Braket hybrid job that associates it with the
+    #   quantum task.
+    #
+    # @option params [Array<Types::Association>] :associations
+    #   The list of Amazon Braket resources associated with the quantum task.
+    #
     # @return [Types::CreateQuantumTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateQuantumTaskResponse#quantum_task_arn #quantum_task_arn} => String
@@ -730,23 +737,23 @@ module Aws::Braket
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_quantum_task({
-    #     action: "JsonValue", # required
-    #     associations: [
-    #       {
-    #         arn: "BraketResourceArn", # required
-    #         type: "RESERVATION_TIME_WINDOW_ARN", # required, accepts RESERVATION_TIME_WINDOW_ARN
-    #       },
-    #     ],
     #     client_token: "String64", # required
     #     device_arn: "DeviceArn", # required
     #     device_parameters: "CreateQuantumTaskRequestDeviceParametersString",
-    #     job_token: "JobToken",
+    #     shots: 1, # required
     #     output_s3_bucket: "CreateQuantumTaskRequestOutputS3BucketString", # required
     #     output_s3_key_prefix: "CreateQuantumTaskRequestOutputS3KeyPrefixString", # required
-    #     shots: 1, # required
+    #     action: "JsonValue", # required
     #     tags: {
     #       "String" => "String",
     #     },
+    #     job_token: "JobToken",
+    #     associations: [
+    #       {
+    #         arn: "BraketResourceArn", # required
+    #         type: "RESERVATION_TIME_WINDOW_ARN", # required, accepts RESERVATION_TIME_WINDOW_ARN
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -782,12 +789,12 @@ module Aws::Braket
     # @return [Types::GetDeviceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetDeviceResponse#device_arn #device_arn} => String
-    #   * {Types::GetDeviceResponse#device_capabilities #device_capabilities} => String
     #   * {Types::GetDeviceResponse#device_name #device_name} => String
-    #   * {Types::GetDeviceResponse#device_queue_info #device_queue_info} => Array&lt;Types::DeviceQueueInfo&gt;
-    #   * {Types::GetDeviceResponse#device_status #device_status} => String
-    #   * {Types::GetDeviceResponse#device_type #device_type} => String
     #   * {Types::GetDeviceResponse#provider_name #provider_name} => String
+    #   * {Types::GetDeviceResponse#device_type #device_type} => String
+    #   * {Types::GetDeviceResponse#device_status #device_status} => String
+    #   * {Types::GetDeviceResponse#device_capabilities #device_capabilities} => String
+    #   * {Types::GetDeviceResponse#device_queue_info #device_queue_info} => Array&lt;Types::DeviceQueueInfo&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -798,15 +805,15 @@ module Aws::Braket
     # @example Response structure
     #
     #   resp.device_arn #=> String
-    #   resp.device_capabilities #=> String
     #   resp.device_name #=> String
+    #   resp.provider_name #=> String
+    #   resp.device_type #=> String, one of "QPU", "SIMULATOR"
+    #   resp.device_status #=> String, one of "ONLINE", "OFFLINE", "RETIRED"
+    #   resp.device_capabilities #=> String
     #   resp.device_queue_info #=> Array
     #   resp.device_queue_info[0].queue #=> String, one of "QUANTUM_TASKS_QUEUE", "JOBS_QUEUE"
-    #   resp.device_queue_info[0].queue_priority #=> String, one of "Normal", "Priority"
     #   resp.device_queue_info[0].queue_size #=> String
-    #   resp.device_status #=> String, one of "ONLINE", "OFFLINE", "RETIRED"
-    #   resp.device_type #=> String, one of "QPU", "SIMULATOR"
-    #   resp.provider_name #=> String
+    #   resp.device_queue_info[0].queue_priority #=> String, one of "Normal", "Priority"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/GetDevice AWS API Documentation
     #
@@ -817,87 +824,88 @@ module Aws::Braket
       req.send_request(options)
     end
 
-    # Retrieves the specified Amazon Braket job.
-    #
-    # @option params [Array<String>] :additional_attribute_names
-    #   A list of attributes to return information for.
+    # Retrieves the specified Amazon Braket hybrid job.
     #
     # @option params [required, String] :job_arn
-    #   The ARN of the job to retrieve.
+    #   The ARN of the hybrid job to retrieve.
+    #
+    # @option params [Array<String>] :additional_attribute_names
+    #   A list of attributes to return additional information for. Only the
+    #   QueueInfo additional attribute name is currently supported.
     #
     # @return [Types::GetJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::GetJobResponse#algorithm_specification #algorithm_specification} => Types::AlgorithmSpecification
-    #   * {Types::GetJobResponse#associations #associations} => Array&lt;Types::Association&gt;
-    #   * {Types::GetJobResponse#billable_duration #billable_duration} => Integer
-    #   * {Types::GetJobResponse#checkpoint_config #checkpoint_config} => Types::JobCheckpointConfig
-    #   * {Types::GetJobResponse#created_at #created_at} => Time
-    #   * {Types::GetJobResponse#device_config #device_config} => Types::DeviceConfig
-    #   * {Types::GetJobResponse#ended_at #ended_at} => Time
-    #   * {Types::GetJobResponse#events #events} => Array&lt;Types::JobEventDetails&gt;
+    #   * {Types::GetJobResponse#status #status} => String
+    #   * {Types::GetJobResponse#job_arn #job_arn} => String
+    #   * {Types::GetJobResponse#role_arn #role_arn} => String
     #   * {Types::GetJobResponse#failure_reason #failure_reason} => String
+    #   * {Types::GetJobResponse#job_name #job_name} => String
     #   * {Types::GetJobResponse#hyper_parameters #hyper_parameters} => Hash&lt;String,String&gt;
     #   * {Types::GetJobResponse#input_data_config #input_data_config} => Array&lt;Types::InputFileConfig&gt;
-    #   * {Types::GetJobResponse#instance_config #instance_config} => Types::InstanceConfig
-    #   * {Types::GetJobResponse#job_arn #job_arn} => String
-    #   * {Types::GetJobResponse#job_name #job_name} => String
     #   * {Types::GetJobResponse#output_data_config #output_data_config} => Types::JobOutputDataConfig
-    #   * {Types::GetJobResponse#queue_info #queue_info} => Types::HybridJobQueueInfo
-    #   * {Types::GetJobResponse#role_arn #role_arn} => String
-    #   * {Types::GetJobResponse#started_at #started_at} => Time
-    #   * {Types::GetJobResponse#status #status} => String
     #   * {Types::GetJobResponse#stopping_condition #stopping_condition} => Types::JobStoppingCondition
+    #   * {Types::GetJobResponse#checkpoint_config #checkpoint_config} => Types::JobCheckpointConfig
+    #   * {Types::GetJobResponse#algorithm_specification #algorithm_specification} => Types::AlgorithmSpecification
+    #   * {Types::GetJobResponse#instance_config #instance_config} => Types::InstanceConfig
+    #   * {Types::GetJobResponse#created_at #created_at} => Time
+    #   * {Types::GetJobResponse#started_at #started_at} => Time
+    #   * {Types::GetJobResponse#ended_at #ended_at} => Time
+    #   * {Types::GetJobResponse#billable_duration #billable_duration} => Integer
+    #   * {Types::GetJobResponse#device_config #device_config} => Types::DeviceConfig
+    #   * {Types::GetJobResponse#events #events} => Array&lt;Types::JobEventDetails&gt;
     #   * {Types::GetJobResponse#tags #tags} => Hash&lt;String,String&gt;
+    #   * {Types::GetJobResponse#queue_info #queue_info} => Types::HybridJobQueueInfo
+    #   * {Types::GetJobResponse#associations #associations} => Array&lt;Types::Association&gt;
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_job({
-    #     additional_attribute_names: ["QueueInfo"], # accepts QueueInfo
     #     job_arn: "JobArn", # required
+    #     additional_attribute_names: ["QueueInfo"], # accepts QueueInfo
     #   })
     #
     # @example Response structure
     #
-    #   resp.algorithm_specification.container_image.uri #=> String
-    #   resp.algorithm_specification.script_mode_config.compression_type #=> String, one of "NONE", "GZIP"
-    #   resp.algorithm_specification.script_mode_config.entry_point #=> String
-    #   resp.algorithm_specification.script_mode_config.s3_uri #=> String
-    #   resp.associations #=> Array
-    #   resp.associations[0].arn #=> String
-    #   resp.associations[0].type #=> String, one of "RESERVATION_TIME_WINDOW_ARN"
-    #   resp.billable_duration #=> Integer
-    #   resp.checkpoint_config.local_path #=> String
-    #   resp.checkpoint_config.s3_uri #=> String
-    #   resp.created_at #=> Time
-    #   resp.device_config.device #=> String
-    #   resp.ended_at #=> Time
-    #   resp.events #=> Array
-    #   resp.events[0].event_type #=> String, one of "WAITING_FOR_PRIORITY", "QUEUED_FOR_EXECUTION", "STARTING_INSTANCE", "DOWNLOADING_DATA", "RUNNING", "DEPRIORITIZED_DUE_TO_INACTIVITY", "UPLOADING_RESULTS", "COMPLETED", "FAILED", "MAX_RUNTIME_EXCEEDED", "CANCELLED"
-    #   resp.events[0].message #=> String
-    #   resp.events[0].time_of_event #=> Time
+    #   resp.status #=> String, one of "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLING", "CANCELLED"
+    #   resp.job_arn #=> String
+    #   resp.role_arn #=> String
     #   resp.failure_reason #=> String
+    #   resp.job_name #=> String
     #   resp.hyper_parameters #=> Hash
     #   resp.hyper_parameters["String256"] #=> String
     #   resp.input_data_config #=> Array
     #   resp.input_data_config[0].channel_name #=> String
     #   resp.input_data_config[0].content_type #=> String
     #   resp.input_data_config[0].data_source.s3_data_source.s3_uri #=> String
-    #   resp.instance_config.instance_count #=> Integer
-    #   resp.instance_config.instance_type #=> String, one of "ml.m4.xlarge", "ml.m4.2xlarge", "ml.m4.4xlarge", "ml.m4.10xlarge", "ml.m4.16xlarge", "ml.g4dn.xlarge", "ml.g4dn.2xlarge", "ml.g4dn.4xlarge", "ml.g4dn.8xlarge", "ml.g4dn.12xlarge", "ml.g4dn.16xlarge", "ml.m5.large", "ml.m5.xlarge", "ml.m5.2xlarge", "ml.m5.4xlarge", "ml.m5.12xlarge", "ml.m5.24xlarge", "ml.c4.xlarge", "ml.c4.2xlarge", "ml.c4.4xlarge", "ml.c4.8xlarge", "ml.p2.xlarge", "ml.p2.8xlarge", "ml.p2.16xlarge", "ml.p3.2xlarge", "ml.p3.8xlarge", "ml.p3.16xlarge", "ml.p3dn.24xlarge", "ml.p4d.24xlarge", "ml.c5.xlarge", "ml.c5.2xlarge", "ml.c5.4xlarge", "ml.c5.9xlarge", "ml.c5.18xlarge", "ml.c5n.xlarge", "ml.c5n.2xlarge", "ml.c5n.4xlarge", "ml.c5n.9xlarge", "ml.c5n.18xlarge"
-    #   resp.instance_config.volume_size_in_gb #=> Integer
-    #   resp.job_arn #=> String
-    #   resp.job_name #=> String
     #   resp.output_data_config.kms_key_id #=> String
     #   resp.output_data_config.s3_path #=> String
-    #   resp.queue_info.message #=> String
-    #   resp.queue_info.position #=> String
-    #   resp.queue_info.queue #=> String, one of "QUANTUM_TASKS_QUEUE", "JOBS_QUEUE"
-    #   resp.role_arn #=> String
-    #   resp.started_at #=> Time
-    #   resp.status #=> String, one of "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLING", "CANCELLED"
     #   resp.stopping_condition.max_runtime_in_seconds #=> Integer
+    #   resp.checkpoint_config.local_path #=> String
+    #   resp.checkpoint_config.s3_uri #=> String
+    #   resp.algorithm_specification.script_mode_config.entry_point #=> String
+    #   resp.algorithm_specification.script_mode_config.s3_uri #=> String
+    #   resp.algorithm_specification.script_mode_config.compression_type #=> String, one of "NONE", "GZIP"
+    #   resp.algorithm_specification.container_image.uri #=> String
+    #   resp.instance_config.instance_type #=> String, one of "ml.m4.xlarge", "ml.m4.2xlarge", "ml.m4.4xlarge", "ml.m4.10xlarge", "ml.m4.16xlarge", "ml.g4dn.xlarge", "ml.g4dn.2xlarge", "ml.g4dn.4xlarge", "ml.g4dn.8xlarge", "ml.g4dn.12xlarge", "ml.g4dn.16xlarge", "ml.m5.large", "ml.m5.xlarge", "ml.m5.2xlarge", "ml.m5.4xlarge", "ml.m5.12xlarge", "ml.m5.24xlarge", "ml.c4.xlarge", "ml.c4.2xlarge", "ml.c4.4xlarge", "ml.c4.8xlarge", "ml.p2.xlarge", "ml.p2.8xlarge", "ml.p2.16xlarge", "ml.p3.2xlarge", "ml.p3.8xlarge", "ml.p3.16xlarge", "ml.p3dn.24xlarge", "ml.p4d.24xlarge", "ml.c5.xlarge", "ml.c5.2xlarge", "ml.c5.4xlarge", "ml.c5.9xlarge", "ml.c5.18xlarge", "ml.c5n.xlarge", "ml.c5n.2xlarge", "ml.c5n.4xlarge", "ml.c5n.9xlarge", "ml.c5n.18xlarge"
+    #   resp.instance_config.volume_size_in_gb #=> Integer
+    #   resp.instance_config.instance_count #=> Integer
+    #   resp.created_at #=> Time
+    #   resp.started_at #=> Time
+    #   resp.ended_at #=> Time
+    #   resp.billable_duration #=> Integer
+    #   resp.device_config.device #=> String
+    #   resp.events #=> Array
+    #   resp.events[0].event_type #=> String, one of "WAITING_FOR_PRIORITY", "QUEUED_FOR_EXECUTION", "STARTING_INSTANCE", "DOWNLOADING_DATA", "RUNNING", "DEPRIORITIZED_DUE_TO_INACTIVITY", "UPLOADING_RESULTS", "COMPLETED", "FAILED", "MAX_RUNTIME_EXCEEDED", "CANCELLED"
+    #   resp.events[0].time_of_event #=> Time
+    #   resp.events[0].message #=> String
     #   resp.tags #=> Hash
     #   resp.tags["String"] #=> String
+    #   resp.queue_info.queue #=> String, one of "QUANTUM_TASKS_QUEUE", "JOBS_QUEUE"
+    #   resp.queue_info.position #=> String
+    #   resp.queue_info.message #=> String
+    #   resp.associations #=> Array
+    #   resp.associations[0].arn #=> String
+    #   resp.associations[0].type #=> String, one of "RESERVATION_TIME_WINDOW_ARN"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/GetJob AWS API Documentation
     #
@@ -910,58 +918,65 @@ module Aws::Braket
 
     # Retrieves the specified quantum task.
     #
-    # @option params [Array<String>] :additional_attribute_names
-    #   A list of attributes to return information for.
-    #
     # @option params [required, String] :quantum_task_arn
-    #   The ARN of the task to retrieve.
+    #   The ARN of the quantum task to retrieve.
+    #
+    # @option params [Array<String>] :additional_attribute_names
+    #   A list of attributes to return additional information for. Only the
+    #   QueueInfo additional attribute name is currently supported.
     #
     # @return [Types::GetQuantumTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::GetQuantumTaskResponse#associations #associations} => Array&lt;Types::Association&gt;
-    #   * {Types::GetQuantumTaskResponse#created_at #created_at} => Time
+    #   * {Types::GetQuantumTaskResponse#quantum_task_arn #quantum_task_arn} => String
+    #   * {Types::GetQuantumTaskResponse#status #status} => String
+    #   * {Types::GetQuantumTaskResponse#failure_reason #failure_reason} => String
     #   * {Types::GetQuantumTaskResponse#device_arn #device_arn} => String
     #   * {Types::GetQuantumTaskResponse#device_parameters #device_parameters} => String
-    #   * {Types::GetQuantumTaskResponse#ended_at #ended_at} => Time
-    #   * {Types::GetQuantumTaskResponse#failure_reason #failure_reason} => String
-    #   * {Types::GetQuantumTaskResponse#job_arn #job_arn} => String
+    #   * {Types::GetQuantumTaskResponse#shots #shots} => Integer
     #   * {Types::GetQuantumTaskResponse#output_s3_bucket #output_s3_bucket} => String
     #   * {Types::GetQuantumTaskResponse#output_s3_directory #output_s3_directory} => String
-    #   * {Types::GetQuantumTaskResponse#quantum_task_arn #quantum_task_arn} => String
-    #   * {Types::GetQuantumTaskResponse#queue_info #queue_info} => Types::QuantumTaskQueueInfo
-    #   * {Types::GetQuantumTaskResponse#shots #shots} => Integer
-    #   * {Types::GetQuantumTaskResponse#status #status} => String
+    #   * {Types::GetQuantumTaskResponse#created_at #created_at} => Time
+    #   * {Types::GetQuantumTaskResponse#ended_at #ended_at} => Time
     #   * {Types::GetQuantumTaskResponse#tags #tags} => Hash&lt;String,String&gt;
+    #   * {Types::GetQuantumTaskResponse#job_arn #job_arn} => String
+    #   * {Types::GetQuantumTaskResponse#queue_info #queue_info} => Types::QuantumTaskQueueInfo
+    #   * {Types::GetQuantumTaskResponse#associations #associations} => Array&lt;Types::Association&gt;
+    #   * {Types::GetQuantumTaskResponse#num_successful_shots #num_successful_shots} => Integer
+    #   * {Types::GetQuantumTaskResponse#action_metadata #action_metadata} => Types::ActionMetadata
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_quantum_task({
-    #     additional_attribute_names: ["QueueInfo"], # accepts QueueInfo
     #     quantum_task_arn: "QuantumTaskArn", # required
+    #     additional_attribute_names: ["QueueInfo"], # accepts QueueInfo
     #   })
     #
     # @example Response structure
     #
-    #   resp.associations #=> Array
-    #   resp.associations[0].arn #=> String
-    #   resp.associations[0].type #=> String, one of "RESERVATION_TIME_WINDOW_ARN"
-    #   resp.created_at #=> Time
+    #   resp.quantum_task_arn #=> String
+    #   resp.status #=> String, one of "CREATED", "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLING", "CANCELLED"
+    #   resp.failure_reason #=> String
     #   resp.device_arn #=> String
     #   resp.device_parameters #=> String
-    #   resp.ended_at #=> Time
-    #   resp.failure_reason #=> String
-    #   resp.job_arn #=> String
+    #   resp.shots #=> Integer
     #   resp.output_s3_bucket #=> String
     #   resp.output_s3_directory #=> String
-    #   resp.quantum_task_arn #=> String
-    #   resp.queue_info.message #=> String
-    #   resp.queue_info.position #=> String
-    #   resp.queue_info.queue #=> String, one of "QUANTUM_TASKS_QUEUE", "JOBS_QUEUE"
-    #   resp.queue_info.queue_priority #=> String, one of "Normal", "Priority"
-    #   resp.shots #=> Integer
-    #   resp.status #=> String, one of "CREATED", "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLING", "CANCELLED"
+    #   resp.created_at #=> Time
+    #   resp.ended_at #=> Time
     #   resp.tags #=> Hash
     #   resp.tags["String"] #=> String
+    #   resp.job_arn #=> String
+    #   resp.queue_info.queue #=> String, one of "QUANTUM_TASKS_QUEUE", "JOBS_QUEUE"
+    #   resp.queue_info.position #=> String
+    #   resp.queue_info.queue_priority #=> String, one of "Normal", "Priority"
+    #   resp.queue_info.message #=> String
+    #   resp.associations #=> Array
+    #   resp.associations[0].arn #=> String
+    #   resp.associations[0].type #=> String, one of "RESERVATION_TIME_WINDOW_ARN"
+    #   resp.num_successful_shots #=> Integer
+    #   resp.action_metadata.action_type #=> String
+    #   resp.action_metadata.program_count #=> Integer
+    #   resp.action_metadata.executable_count #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/GetQuantumTask AWS API Documentation
     #
@@ -1003,16 +1018,17 @@ module Aws::Braket
 
     # Searches for devices using the specified filters.
     #
-    # @option params [required, Array<Types::SearchDevicesFilter>] :filters
-    #   The filter values to use to search for a device.
+    # @option params [String] :next_token
+    #   A token used for pagination of results returned in the response. Use
+    #   the token returned from the previous request to continue search where
+    #   the previous request ended.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return in the response.
     #
-    # @option params [String] :next_token
-    #   A token used for pagination of results returned in the response. Use
-    #   the token returned from the previous request continue results where
-    #   the previous request ended.
+    # @option params [required, Array<Types::SearchDevicesFilter>] :filters
+    #   Array of SearchDevicesFilter objects to use when searching for
+    #   devices.
     #
     # @return [Types::SearchDevicesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1024,14 +1040,14 @@ module Aws::Braket
     # @example Request syntax with placeholder values
     #
     #   resp = client.search_devices({
+    #     next_token: "String",
+    #     max_results: 1,
     #     filters: [ # required
     #       {
     #         name: "SearchDevicesFilterNameString", # required
     #         values: ["String256"], # required
     #       },
     #     ],
-    #     max_results: 1,
-    #     next_token: "String",
     #   })
     #
     # @example Response structure
@@ -1039,9 +1055,9 @@ module Aws::Braket
     #   resp.devices #=> Array
     #   resp.devices[0].device_arn #=> String
     #   resp.devices[0].device_name #=> String
-    #   resp.devices[0].device_status #=> String, one of "ONLINE", "OFFLINE", "RETIRED"
-    #   resp.devices[0].device_type #=> String, one of "QPU", "SIMULATOR"
     #   resp.devices[0].provider_name #=> String
+    #   resp.devices[0].device_type #=> String, one of "QPU", "SIMULATOR"
+    #   resp.devices[0].device_status #=> String, one of "ONLINE", "OFFLINE", "RETIRED"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/SearchDevices AWS API Documentation
@@ -1053,19 +1069,20 @@ module Aws::Braket
       req.send_request(options)
     end
 
-    # Searches for Amazon Braket jobs that match the specified filter
+    # Searches for Amazon Braket hybrid jobs that match the specified filter
     # values.
     #
-    # @option params [required, Array<Types::SearchJobsFilter>] :filters
-    #   The filter values to use when searching for a job.
+    # @option params [String] :next_token
+    #   A token used for pagination of results returned in the response. Use
+    #   the token returned from the previous request to continue search where
+    #   the previous request ended.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return in the response.
     #
-    # @option params [String] :next_token
-    #   A token used for pagination of results returned in the response. Use
-    #   the token returned from the previous request to continue results where
-    #   the previous request ended.
+    # @option params [required, Array<Types::SearchJobsFilter>] :filters
+    #   Array of SearchJobsFilter objects to use when searching for hybrid
+    #   jobs.
     #
     # @return [Types::SearchJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1077,27 +1094,27 @@ module Aws::Braket
     # @example Request syntax with placeholder values
     #
     #   resp = client.search_jobs({
+    #     next_token: "String",
+    #     max_results: 1,
     #     filters: [ # required
     #       {
     #         name: "String64", # required
-    #         operator: "LT", # required, accepts LT, LTE, EQUAL, GT, GTE, BETWEEN, CONTAINS
     #         values: ["String256"], # required
+    #         operator: "LT", # required, accepts LT, LTE, EQUAL, GT, GTE, BETWEEN, CONTAINS
     #       },
     #     ],
-    #     max_results: 1,
-    #     next_token: "String",
     #   })
     #
     # @example Response structure
     #
     #   resp.jobs #=> Array
-    #   resp.jobs[0].created_at #=> Time
-    #   resp.jobs[0].device #=> String
-    #   resp.jobs[0].ended_at #=> Time
+    #   resp.jobs[0].status #=> String, one of "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLING", "CANCELLED"
     #   resp.jobs[0].job_arn #=> String
     #   resp.jobs[0].job_name #=> String
+    #   resp.jobs[0].device #=> String
+    #   resp.jobs[0].created_at #=> Time
     #   resp.jobs[0].started_at #=> Time
-    #   resp.jobs[0].status #=> String, one of "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLING", "CANCELLED"
+    #   resp.jobs[0].ended_at #=> Time
     #   resp.jobs[0].tags #=> Hash
     #   resp.jobs[0].tags["String"] #=> String
     #   resp.next_token #=> String
@@ -1113,52 +1130,53 @@ module Aws::Braket
 
     # Searches for tasks that match the specified filter values.
     #
-    # @option params [required, Array<Types::SearchQuantumTasksFilter>] :filters
-    #   Array of `SearchQuantumTasksFilter` objects.
+    # @option params [String] :next_token
+    #   A token used for pagination of results returned in the response. Use
+    #   the token returned from the previous request to continue search where
+    #   the previous request ended.
     #
     # @option params [Integer] :max_results
     #   Maximum number of results to return in the response.
     #
-    # @option params [String] :next_token
-    #   A token used for pagination of results returned in the response. Use
-    #   the token returned from the previous request continue results where
-    #   the previous request ended.
+    # @option params [required, Array<Types::SearchQuantumTasksFilter>] :filters
+    #   Array of `SearchQuantumTasksFilter` objects to use when searching for
+    #   quantum tasks.
     #
     # @return [Types::SearchQuantumTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::SearchQuantumTasksResponse#next_token #next_token} => String
     #   * {Types::SearchQuantumTasksResponse#quantum_tasks #quantum_tasks} => Array&lt;Types::QuantumTaskSummary&gt;
+    #   * {Types::SearchQuantumTasksResponse#next_token #next_token} => String
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.search_quantum_tasks({
+    #     next_token: "String",
+    #     max_results: 1,
     #     filters: [ # required
     #       {
     #         name: "String64", # required
-    #         operator: "LT", # required, accepts LT, LTE, EQUAL, GT, GTE, BETWEEN
     #         values: ["String256"], # required
+    #         operator: "LT", # required, accepts LT, LTE, EQUAL, GT, GTE, BETWEEN
     #       },
     #     ],
-    #     max_results: 1,
-    #     next_token: "String",
     #   })
     #
     # @example Response structure
     #
-    #   resp.next_token #=> String
     #   resp.quantum_tasks #=> Array
-    #   resp.quantum_tasks[0].created_at #=> Time
+    #   resp.quantum_tasks[0].quantum_task_arn #=> String
+    #   resp.quantum_tasks[0].status #=> String, one of "CREATED", "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLING", "CANCELLED"
     #   resp.quantum_tasks[0].device_arn #=> String
-    #   resp.quantum_tasks[0].ended_at #=> Time
+    #   resp.quantum_tasks[0].shots #=> Integer
     #   resp.quantum_tasks[0].output_s3_bucket #=> String
     #   resp.quantum_tasks[0].output_s3_directory #=> String
-    #   resp.quantum_tasks[0].quantum_task_arn #=> String
-    #   resp.quantum_tasks[0].shots #=> Integer
-    #   resp.quantum_tasks[0].status #=> String, one of "CREATED", "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLING", "CANCELLED"
+    #   resp.quantum_tasks[0].created_at #=> Time
+    #   resp.quantum_tasks[0].ended_at #=> Time
     #   resp.quantum_tasks[0].tags #=> Hash
     #   resp.quantum_tasks[0].tags["String"] #=> String
+    #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/SearchQuantumTasks AWS API Documentation
     #
@@ -1176,7 +1194,8 @@ module Aws::Braket
     #   added.
     #
     # @option params [required, Hash<String,String>] :tags
-    #   Specify the tags to add to the resource.
+    #   Specify the tags to add to the resource. Tags can be specified as a
+    #   key-value map.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1243,7 +1262,7 @@ module Aws::Braket
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-braket'
-      context[:gem_version] = '1.56.0'
+      context[:gem_version] = '1.57.0'
       Seahorse::Client::Request.new(handlers, context)
     end