aws-sdk-braket 1.12.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ae43bd0f6b89ac01ad4b066a180c3cc85253ffd21ee37842dc8465c001b19c6
-  data.tar.gz: 0ed41c17edc2e834b2a22f4510f4159702b716877658339f52a51067475aff8c
+  metadata.gz: 000d201bcb0f95dbb7624eb39632fc3b4bfce1531fe0ba124e13ceee3f01c67e
+  data.tar.gz: 4934e35f1ea8d2cb6b7ab3b8f758d43af642f0cf02489d58b93e99fc363500e2
 SHA512:
-  metadata.gz: 2a9e231718bd4782e3431f6d7c53ba0fc9ce334d65524c147accd9e5fa5c739558212cb0cab030ca4f897cdd0650bc7a123611e2d24bba0fec15a771e7e94bfc
-  data.tar.gz: 892e00bbefc594a2b8d3a1aae9da16a464bc6f71f5fc8106b5c121f979a7fab876efcda237ea72f70c32630e6cab8293487f6738d4a05434bea8fcdc6f034e08
+  metadata.gz: aeb80fa9c8f4242f5026f6373652b66aa6abcf160623a4a20a5878a568be9eecd7e1384777e24b30797b4bd73582c2f3e783a5ec8fc3c7cd284bfd987dfd8434
+  data.tar.gz: 93b5a1333461457d6b7c257e4c11cf7929e77621175557615ae1c6890f2662f8f3c7379ed2d3ad25d93be706a10b013f767600df8a97590eead57cf5b5bcc561

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.16.0 (2021-12-21)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.15.0 (2021-11-30)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.14.0 (2021-11-22)
+------------------
+
+* Feature - This release adds support for Amazon Braket Hybrid Jobs.
+
+1.13.0 (2021-11-04)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.12.0 (2021-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.12.0
+1.16.0

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

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
@@ -73,6 +74,7 @@ module Aws::Braket
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::RestJson)
 
@@ -119,7 +121,9 @@ module Aws::Braket
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -173,6 +177,10 @@ module Aws::Braket
     #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
     #     a clock skew correction and retry requests with skewed client clocks.
     #
+    #   @option options [String] :defaults_mode ("legacy")
+    #     See {Aws::DefaultsModeConfiguration} for a list of the
+    #     accepted modes and the configuration defaults that are included.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -275,6 +283,15 @@ module Aws::Braket
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Boolean] :use_dualstack_endpoint
+    #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
+    #     will be used if available.
+    #
+    #   @option options [Boolean] :use_fips_endpoint
+    #     When set to `true`, fips compatible endpoints will be used if available.
+    #     When a `fips` region is used, the region is normalized and this config
+    #     is set to `true`.
+    #
     #   @option options [Boolean] :validate_params (true)
     #     When `true`, request parameters are validated before
     #     sending the request.
@@ -286,7 +303,7 @@ module Aws::Braket
     #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
-    #   @option options [Integer] :http_read_timeout (60) The default
+    #   @option options [Float] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
     #     safely be set per-request on the session.
     #
@@ -302,6 +319,9 @@ module Aws::Braket
     #     disables this behaviour.  This value can safely be set per
     #     request on the session.
     #
+    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
+    #     in seconds.
+    #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
     #
@@ -327,6 +347,36 @@ module Aws::Braket
 
     # @!group API Operations
 
+    # Cancels an Amazon Braket job.
+    #
+    # @option params [required, String] :job_arn
+    #   The ARN of the Amazon Braket 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
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.cancel_job({
+    #     job_arn: "JobArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.cancellation_status #=> String, one of "CANCELLING", "CANCELLED"
+    #   resp.job_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/CancelJob AWS API Documentation
+    #
+    # @overload cancel_job(params = {})
+    # @param [Hash] params ({})
+    def cancel_job(params = {}, options = {})
+      req = build_request(:cancel_job, params)
+      req.send_request(options)
+    end
+
     # Cancels the specified task.
     #
     # @option params [required, String] :client_token
@@ -364,6 +414,131 @@ 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 [Types::JobCheckpointConfig] :checkpoint_config
+    #   Information about the output locations for job checkpoint data.
+    #
+    # @option params [required, String] :client_token
+    #   A unique token that guarantees that the call to this API 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 [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, String] :job_name
+    #   The name of the Amazon Braket job.
+    #
+    # @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] :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.
+    #
+    # @option params [Types::JobStoppingCondition] :stopping_condition
+    #   The user-defined criteria that specifies when a job stops running.
+    #
+    # @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.
+    #
+    # @return [Types::CreateJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateJobResponse#job_arn #job_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_job({
+    #     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
+    #       },
+    #     },
+    #     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: [
+    #       {
+    #         channel_name: "InputFileConfigChannelNameString", # required
+    #         content_type: "String256",
+    #         data_source: { # required
+    #           s3_data_source: { # required
+    #             s3_uri: "S3Path", # required
+    #           },
+    #         },
+    #       },
+    #     ],
+    #     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
+    #     },
+    #     job_name: "CreateJobRequestJobNameString", # required
+    #     output_data_config: { # required
+    #       kms_key_id: "String2048",
+    #       s3_path: "S3Path", # required
+    #     },
+    #     role_arn: "RoleArn", # required
+    #     stopping_condition: {
+    #       max_runtime_in_seconds: 1,
+    #     },
+    #     tags: {
+    #       "String" => "String",
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.job_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/CreateJob AWS API Documentation
+    #
+    # @overload create_job(params = {})
+    # @param [Hash] params ({})
+    def create_job(params = {}, options = {})
+      req = build_request(:create_job, params)
+      req.send_request(options)
+    end
+
     # Creates a quantum task.
     #
     # @option params [required, String] :action
@@ -389,6 +564,10 @@ module Aws::Braket
     #   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, String] :output_s3_bucket
     #   The S3 bucket to store task result files in.
     #
@@ -413,6 +592,7 @@ module Aws::Braket
     #     client_token: "String64", # required
     #     device_arn: "DeviceArn", # required
     #     device_parameters: "CreateQuantumTaskRequestDeviceParametersString",
+    #     job_token: "JobToken",
     #     output_s3_bucket: "CreateQuantumTaskRequestOutputS3BucketString", # required
     #     output_s3_key_prefix: "CreateQuantumTaskRequestOutputS3KeyPrefixString", # required
     #     shots: 1, # required
@@ -472,6 +652,84 @@ module Aws::Braket
       req.send_request(options)
     end
 
+    # Retrieves the specified Amazon Braket job.
+    #
+    # @option params [required, String] :job_arn
+    #   The ARN of the job to retrieve.
+    #
+    # @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#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#failure_reason #failure_reason} => 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#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#tags #tags} => Hash&lt;String,String&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_job({
+    #     job_arn: "JobArn", # required
+    #   })
+    #
+    # @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.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.failure_reason #=> 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_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.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.tags #=> Hash
+    #   resp.tags["String"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/GetJob AWS API Documentation
+    #
+    # @overload get_job(params = {})
+    # @param [Hash] params ({})
+    def get_job(params = {}, options = {})
+      req = build_request(:get_job, params)
+      req.send_request(options)
+    end
+
     # Retrieves the specified quantum task.
     #
     # @option params [required, String] :quantum_task_arn
@@ -484,6 +742,7 @@ module Aws::Braket
     #   * {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#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
@@ -504,6 +763,7 @@ module Aws::Braket
     #   resp.device_parameters #=> String
     #   resp.ended_at #=> Time
     #   resp.failure_reason #=> String
+    #   resp.job_arn #=> String
     #   resp.output_s3_bucket #=> String
     #   resp.output_s3_directory #=> String
     #   resp.quantum_task_arn #=> String
@@ -602,6 +862,64 @@ module Aws::Braket
       req.send_request(options)
     end
 
+    # Searches for Amazon Braket 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 [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.
+    #
+    # @return [Types::SearchJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::SearchJobsResponse#jobs #jobs} => Array&lt;Types::JobSummary&gt;
+    #   * {Types::SearchJobsResponse#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_jobs({
+    #     filters: [ # required
+    #       {
+    #         name: "String64", # required
+    #         operator: "LT", # required, accepts LT, LTE, EQUAL, GT, GTE, BETWEEN, CONTAINS
+    #         values: ["String256"], # required
+    #       },
+    #     ],
+    #     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].job_arn #=> String
+    #   resp.jobs[0].job_name #=> String
+    #   resp.jobs[0].started_at #=> Time
+    #   resp.jobs[0].status #=> String, one of "QUEUED", "RUNNING", "COMPLETED", "FAILED", "CANCELLING", "CANCELLED"
+    #   resp.jobs[0].tags #=> Hash
+    #   resp.jobs[0].tags["String"] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/SearchJobs AWS API Documentation
+    #
+    # @overload search_jobs(params = {})
+    # @param [Hash] params ({})
+    def search_jobs(params = {}, options = {})
+      req = build_request(:search_jobs, params)
+      req.send_request(options)
+    end
+
     # Searches for tasks that match the specified filter values.
     #
     # @option params [required, Array<Types::SearchQuantumTasksFilter>] :filters
@@ -729,7 +1047,7 @@ module Aws::Braket
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-braket'
-      context[:gem_version] = '1.12.0'
+      context[:gem_version] = '1.16.0'
       Seahorse::Client::Request.new(handlers, context)
     end