aws-sdk-personalize 1.25.0 → 1.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29830409ef97cb1b3008a898eea0294db9b39073ebe018b36ad8e456c07375d3
-  data.tar.gz: 927ace52a6888361455fded2ae51d77934d5250d6042c385a06c9cc7de167ef3
+  metadata.gz: ee77331f1a3519458b6668616bf4f9badbf47fd6bf2ca99f7f502eeeaddd2fbd
+  data.tar.gz: c5b2a053de73f692f7af2202bf854c50901b5b3c1c5088929ed2636de4c407d7
 SHA512:
-  metadata.gz: 3a4a72320a89bd03065ab824d8d9c08ee48b891ba7e0daf112704c584010ef8a7f21cd9cf9c09736590053ee44d73f5ddd3f06c65b1ed53413984d611e966505
-  data.tar.gz: a5d36268f5a8a5a168941fa6636cf491bb813315c1b15ac03596033822419f4db7a2019eea6372c159a8b54465fb2523464b2a44f4e8e4905819dffdd1eaee7a
+  metadata.gz: b3f84a41753e3df572fa33120ff0ee083f12493419bb0d894a8c62195d5fb9476a77c8f8741a710aa0ce1ece97e9f52175d303e1e42dae203136a1a5a075c32e
+  data.tar.gz: 60f83784c3675ff201765f499e97df860e7d54bf17e016a7d40209662c642ac120ea3e56bb312731041be68a3ddc064e9f8713fc1310a4f206886b3bb8f08657

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.29.0 (2021-07-28)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.28.0 (2021-07-21)
+------------------
+
+* Feature - My AWS Service (placeholder) - Making minProvisionedTPS an optional parameter when creating a campaign. If not provided, it defaults to 1.
+
+1.27.0 (2021-06-07)
+------------------
+
+* Feature - Update regex validation in kmsKeyArn and s3 path API parameters for AWS Personalize APIs
+
+1.26.0 (2021-05-20)
+------------------
+
+* Feature - Added new API to stop a solution version creation that is pending or in progress for Amazon Personalize
+
 1.25.0 (2021-05-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.25.0
+1.29.0

data/lib/aws-sdk-personalize.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-personalize/customizations'
 # @!group service
 module Aws::Personalize
 
-  GEM_VERSION = '1.25.0'
+  GEM_VERSION = '1.29.0'
 
 end

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

@@ -482,7 +482,7 @@ module Aws::Personalize
     # @option params [required, String] :solution_version_arn
     #   The Amazon Resource Name (ARN) of the solution version to deploy.
     #
-    # @option params [required, Integer] :min_provisioned_tps
+    # @option params [Integer] :min_provisioned_tps
     #   Specifies the requested minimum provisioned transactions
     #   (recommendations) per second that Amazon Personalize will support.
     #
@@ -498,7 +498,7 @@ module Aws::Personalize
     #   resp = client.create_campaign({
     #     name: "Name", # required
     #     solution_version_arn: "Arn", # required
-    #     min_provisioned_tps: 1, # required
+    #     min_provisioned_tps: 1,
     #     campaign_config: {
     #       item_exploration_config: {
     #         "ParameterName" => "ParameterValue",
@@ -603,10 +603,10 @@ module Aws::Personalize
 
     # Creates a job that exports data from your dataset to an Amazon S3
     # bucket. To allow Amazon Personalize to export the training data, you
-    # must specify an service-linked AWS Identity and Access Management
-    # (IAM) role that gives Amazon Personalize `PutObject` permissions for
-    # your Amazon S3 bucket. For information, see [Exporting a dataset][1]
-    # in the Amazon Personalize developer guide.
+    # must specify an service-linked IAM role that gives Amazon Personalize
+    # `PutObject` permissions for your Amazon S3 bucket. For information,
+    # see [Exporting a dataset][1] in the Amazon Personalize developer
+    # guide.
     #
     # **Status**
     #
@@ -642,9 +642,8 @@ module Aws::Personalize
     #   both types. The default value is `PUT`.
     #
     # @option params [required, String] :role_arn
-    #   The Amazon Resource Name (ARN) of the AWS Identity and Access
-    #   Management service role that has permissions to add data to your
-    #   output Amazon S3 bucket.
+    #   The Amazon Resource Name (ARN) of the IAM service role that has
+    #   permissions to add data to your output Amazon S3 bucket.
     #
     # @option params [required, Types::DatasetExportJobOutput] :job_output
     #   The path to the Amazon S3 bucket where the job's output is stored.
@@ -711,10 +710,10 @@ module Aws::Personalize
     #
     #  </note>
     #
-    # You can specify an AWS Key Management Service (KMS) key to encrypt the
+    # You can specify an Key Management Service (KMS) key to encrypt the
     # datasets in the group. If you specify a KMS key, you must also include
-    # an AWS Identity and Access Management (IAM) role that has permission
-    # to access the key.
+    # an Identity and Access Management (IAM) role that has permission to
+    # access the key.
     #
     # **APIs that require a dataset group ARN in the request**
     #
@@ -736,12 +735,13 @@ module Aws::Personalize
     #   The name for the new dataset group.
     #
     # @option params [String] :role_arn
-    #   The ARN of the IAM role that has permissions to access the KMS key.
-    #   Supplying an IAM role is only valid when also specifying a KMS key.
+    #   The ARN of the Identity and Access Management (IAM) role that has
+    #   permissions to access the Key Management Service (KMS) key. Supplying
+    #   an IAM role is only valid when also specifying a KMS key.
     #
     # @option params [String] :kms_key_arn
-    #   The Amazon Resource Name (ARN) of a KMS key used to encrypt the
-    #   datasets.
+    #   The Amazon Resource Name (ARN) of a Key Management Service (KMS) key
+    #   used to encrypt the datasets.
     #
     # @return [Types::CreateDatasetGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -770,12 +770,12 @@ module Aws::Personalize
 
     # Creates a job that imports training data from your data source (an
     # Amazon S3 bucket) to an Amazon Personalize dataset. To allow Amazon
-    # Personalize to import the training data, you must specify an AWS
-    # Identity and Access Management (IAM) service role that has permission
-    # to read from the data source, as Amazon Personalize makes a copy of
-    # your data and processes it in an internal AWS system. For information
-    # on granting access to your Amazon S3 bucket, see [Giving Amazon
-    # Personalize Access to Amazon S3 Resources][1].
+    # Personalize to import the training data, you must specify an IAM
+    # service role that has permission to read from the data source, as
+    # Amazon Personalize makes a copy of your data and processes it
+    # internally. For information on granting access to your Amazon S3
+    # bucket, see [Giving Amazon Personalize Access to Amazon S3
+    # Resources][1].
     #
     # The dataset import job replaces any existing data in the dataset that
     # you imported in bulk.
@@ -1198,10 +1198,17 @@ module Aws::Personalize
     #
     # A solution version can be in one of the following states:
     #
-    # * CREATE PENDING &gt; CREATE IN\_PROGRESS &gt; ACTIVE -or- CREATE
-    #   FAILED
+    # * CREATE PENDING
     #
-    # ^
+    # * CREATE IN\_PROGRESS
+    #
+    # * ACTIVE
+    #
+    # * CREATE FAILED
+    #
+    # * CREATE STOPPING
+    #
+    # * CREATE STOPPED
     #
     # To get the status of the version, call DescribeSolutionVersion. Wait
     # until the status shows as ACTIVE before calling `CreateCampaign`.
@@ -1834,7 +1841,7 @@ module Aws::Personalize
     #
     # @return [Types::DescribeFilterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
-    #   * {Types::DescribeFilterResponse#filter #filter} => Types::Filter
+    #   * {Types::DescribeFilterResponse#filter #data.filter} => Types::Filter (This method conflicts with a method on Response, call it through the data member)
     #
     # @example Request syntax with placeholder values
     #
@@ -1844,14 +1851,14 @@ module Aws::Personalize
     #
     # @example Response structure
     #
-    #   resp.filter.name #=> String
-    #   resp.filter.filter_arn #=> String
-    #   resp.filter.creation_date_time #=> Time
-    #   resp.filter.last_updated_date_time #=> Time
-    #   resp.filter.dataset_group_arn #=> String
-    #   resp.filter.failure_reason #=> String
-    #   resp.filter.filter_expression #=> String
-    #   resp.filter.status #=> String
+    #   resp.data.filter.name #=> String
+    #   resp.data.filter.filter_arn #=> String
+    #   resp.data.filter.creation_date_time #=> Time
+    #   resp.data.filter.last_updated_date_time #=> Time
+    #   resp.data.filter.dataset_group_arn #=> String
+    #   resp.data.filter.failure_reason #=> String
+    #   resp.data.filter.filter_expression #=> String
+    #   resp.data.filter.status #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeFilter AWS API Documentation
     #
@@ -2716,6 +2723,43 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Stops creating a solution version that is in a state of
+    # CREATE\_PENDING or CREATE IN\_PROGRESS.
+    #
+    # Depending on the current state of the solution version, the solution
+    # version state changes as follows:
+    #
+    # * CREATE\_PENDING &gt; CREATE\_STOPPED
+    #
+    #   or
+    #
+    # * CREATE\_IN\_PROGRESS &gt; CREATE\_STOPPING &gt; CREATE\_STOPPED
+    #
+    # You are billed for all of the training completed up until you stop the
+    # solution version creation. You cannot resume creating a solution
+    # version once it has been stopped.
+    #
+    # @option params [required, String] :solution_version_arn
+    #   The Amazon Resource Name (ARN) of the solution version you want to
+    #   stop creating.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.stop_solution_version_creation({
+    #     solution_version_arn: "Arn", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/StopSolutionVersionCreation AWS API Documentation
+    #
+    # @overload stop_solution_version_creation(params = {})
+    # @param [Hash] params ({})
+    def stop_solution_version_creation(params = {}, options = {})
+      req = build_request(:stop_solution_version_creation, params)
+      req.send_request(options)
+    end
+
     # Updates a campaign by either deploying a new solution or changing the
     # value of the campaign's `minProvisionedTPS` parameter.
     #
@@ -2785,7 +2829,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.25.0'
+      context[:gem_version] = '1.29.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-personalize/client_api.rb

@@ -217,6 +217,7 @@ module Aws::Personalize
     SolutionVersions = Shapes::ListShape.new(name: 'SolutionVersions')
     Solutions = Shapes::ListShape.new(name: 'Solutions')
     Status = Shapes::StringShape.new(name: 'Status')
+    StopSolutionVersionCreationRequest = Shapes::StructureShape.new(name: 'StopSolutionVersionCreationRequest')
     TrackingId = Shapes::StringShape.new(name: 'TrackingId')
     TrainingHours = Shapes::FloatShape.new(name: 'TrainingHours')
     TrainingInputMode = Shapes::StringShape.new(name: 'TrainingInputMode')
@@ -351,7 +352,7 @@ module Aws::Personalize
 
     CreateCampaignRequest.add_member(:name, Shapes::ShapeRef.new(shape: Name, required: true, location_name: "name"))
     CreateCampaignRequest.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "solutionVersionArn"))
-    CreateCampaignRequest.add_member(:min_provisioned_tps, Shapes::ShapeRef.new(shape: TransactionsPerSecond, required: true, location_name: "minProvisionedTPS"))
+    CreateCampaignRequest.add_member(:min_provisioned_tps, Shapes::ShapeRef.new(shape: TransactionsPerSecond, location_name: "minProvisionedTPS"))
     CreateCampaignRequest.add_member(:campaign_config, Shapes::ShapeRef.new(shape: CampaignConfig, location_name: "campaignConfig"))
     CreateCampaignRequest.struct_class = Types::CreateCampaignRequest
 
@@ -979,6 +980,9 @@ module Aws::Personalize
 
     Solutions.member = Shapes::ShapeRef.new(shape: SolutionSummary)
 
+    StopSolutionVersionCreationRequest.add_member(:solution_version_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "solutionVersionArn"))
+    StopSolutionVersionCreationRequest.struct_class = Types::StopSolutionVersionCreationRequest
+
     TunedHPOParams.add_member(:algorithm_hyper_parameters, Shapes::ShapeRef.new(shape: HyperParameters, location_name: "algorithmHyperParameters"))
     TunedHPOParams.struct_class = Types::TunedHPOParams
 
@@ -1565,6 +1569,17 @@ module Aws::Personalize
         )
       end)
 
+      api.add_operation(:stop_solution_version_creation, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StopSolutionVersionCreation"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: StopSolutionVersionCreationRequest)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: InvalidInputException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
+      end)
+
       api.add_operation(:update_campaign, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdateCampaign"
         o.http_method = "POST"

data/lib/aws-sdk-personalize/types.rb

@@ -734,7 +734,7 @@ module Aws::Personalize
     #       {
     #         name: "Name", # required
     #         solution_version_arn: "Arn", # required
-    #         min_provisioned_tps: 1, # required
+    #         min_provisioned_tps: 1,
     #         campaign_config: {
     #           item_exploration_config: {
     #             "ParameterName" => "ParameterValue",
@@ -817,9 +817,8 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] role_arn
-    #   The Amazon Resource Name (ARN) of the AWS Identity and Access
-    #   Management service role that has permissions to add data to your
-    #   output Amazon S3 bucket.
+    #   The Amazon Resource Name (ARN) of the IAM service role that has
+    #   permissions to add data to your output Amazon S3 bucket.
     #   @return [String]
     #
     # @!attribute [rw] job_output
@@ -864,13 +863,14 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] role_arn
-    #   The ARN of the IAM role that has permissions to access the KMS key.
+    #   The ARN of the Identity and Access Management (IAM) role that has
+    #   permissions to access the Key Management Service (KMS) key.
     #   Supplying an IAM role is only valid when also specifying a KMS key.
     #   @return [String]
     #
     # @!attribute [rw] kms_key_arn
-    #   The Amazon Resource Name (ARN) of a KMS key used to encrypt the
-    #   datasets.
+    #   The Amazon Resource Name (ARN) of a Key Management Service (KMS) key
+    #   used to encrypt the datasets.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateDatasetGroupRequest AWS API Documentation
@@ -1452,9 +1452,8 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] role_arn
-    #   The Amazon Resource Name (ARN) of the AWS Identity and Access
-    #   Management service role that has permissions to add data to your
-    #   output Amazon S3 bucket.
+    #   The Amazon Resource Name (ARN) of the IAM service role that has
+    #   permissions to add data to your output Amazon S3 bucket.
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -1585,7 +1584,7 @@ module Aws::Personalize
     # and train a solution by calling CreateSolution. A dataset group can
     # contain only one of each type of dataset.
     #
-    # You can specify an AWS Key Management Service (KMS) key to encrypt the
+    # You can specify an Key Management Service (KMS) key to encrypt the
     # datasets in the group.
     #
     # @!attribute [rw] name
@@ -1613,8 +1612,8 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] kms_key_arn
-    #   The Amazon Resource Name (ARN) of the KMS key used to encrypt the
-    #   datasets.
+    #   The Amazon Resource Name (ARN) of the Key Management Service (KMS)
+    #   key used to encrypt the datasets.
     #   @return [String]
     #
     # @!attribute [rw] creation_date_time
@@ -1721,8 +1720,8 @@ module Aws::Personalize
     #   @return [Types::DataSource]
     #
     # @!attribute [rw] role_arn
-    #   The ARN of the AWS Identity and Access Management (IAM) role that
-    #   has permissions to read from the Amazon S3 data source.
+    #   The ARN of the IAM role that has permissions to read from the Amazon
+    #   S3 data source.
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -2649,7 +2648,7 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] account_id
-    #   The Amazon AWS account that owns the event tracker.
+    #   The Amazon Web Services account that owns the event tracker.
     #   @return [String]
     #
     # @!attribute [rw] tracking_id
@@ -3963,9 +3962,9 @@ module Aws::Personalize
     #   @return [String]
     #
     # @!attribute [rw] kms_key_arn
-    #   The Amazon Resource Name (ARN) of the Amazon Key Management Service
-    #   (KMS) key that Amazon Personalize uses to encrypt or decrypt the
-    #   input and output files of a batch inference job.
+    #   The Amazon Resource Name (ARN) of the Key Management Service (KMS)
+    #   key that Amazon Personalize uses to encrypt or decrypt the input and
+    #   output files of a batch inference job.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/S3DataConfig AWS API Documentation
@@ -4294,6 +4293,10 @@ module Aws::Personalize
     #   * ACTIVE
     #
     #   * CREATE FAILED
+    #
+    #   * CREATE STOPPING
+    #
+    #   * CREATE STOPPED
     #   @return [String]
     #
     # @!attribute [rw] failure_reason
@@ -4375,6 +4378,26 @@ module Aws::Personalize
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass StopSolutionVersionCreationRequest
+    #   data as a hash:
+    #
+    #       {
+    #         solution_version_arn: "Arn", # required
+    #       }
+    #
+    # @!attribute [rw] solution_version_arn
+    #   The Amazon Resource Name (ARN) of the solution version you want to
+    #   stop creating.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/StopSolutionVersionCreationRequest AWS API Documentation
+    #
+    class StopSolutionVersionCreationRequest < Struct.new(
+      :solution_version_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # If hyperparameter optimization (HPO) was performed, contains the
     # hyperparameter values of the best performing model.
     #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-personalize
 version: !ruby/object:Gem::Version
-  version: 1.25.0
+  version: 1.29.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-18 00:00:00.000000000 Z
+date: 2021-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.112.0
+        version: 3.118.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.112.0
+        version: 3.118.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement