aws-sdk-personalize 1.43.0 → 1.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7edd0851f01831788bae9768fa224c5f7ef20f9d4562cceb562ad6876f9abb7
-  data.tar.gz: c06b3758b0783bf773cb6ef1fa4f976da683db704907a1b25280eadec2eb758c
+  metadata.gz: 6cb4bb9c7ee70652f3c644264762f3a0cffe6902ad8e7bb21f4aa55e6d4dadfd
+  data.tar.gz: aba40a8129081ba4765deadc6bbc3f80add89cc26f63ee6a2c46500b67279478
 SHA512:
-  metadata.gz: b91e363f2c8552d2fe685307d9fe4a1c13359614e3c608bc28cc2fc1bbfe419169c760cd7ee8ca679c47c4e3cc425bc9a416fe54d49fc188924c910384eac8ec
-  data.tar.gz: 320d1995371797f6002bcf864ca5dde647aeb36f99c48f258f27aa516a08bd0236e28806be0bd09542121668c33ccd47365118c5a16ad6d2ef0a0557e7f1b2c3
+  metadata.gz: f1d6a04dfbe7a537a94cc560c7f4fbf17baebeac3ebc7583af1839a7ed8088c9ee0edeba5d40a632d14cea1e4083a83c72a939f2a5e59a403db9ff81d74c907b
+  data.tar.gz: 84317573eed5c4bad5b909bf4da7d1513e9f2ce1930d9a035bb69f7bd18ca0b318caeedeb5c5f05bc0cd285e0ee5e59b739ede810b6018274fed22953315ba10

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.45.0 (2022-11-17)
+------------------
+
+* Feature - This release provides support for creation and use of metric attributions in AWS Personalize
+
+1.44.0 (2022-10-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.43.0 (2022-08-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.43.0
+1.45.0

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

@@ -30,7 +30,7 @@ require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
-require 'aws-sdk-core/plugins/signature_v4.rb'
+require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
 Aws::Plugins::GlobalConfiguration.add_identifier(:personalize)
@@ -79,8 +79,9 @@ module Aws::Personalize
     add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
-    add_plugin(Aws::Plugins::SignatureV4)
+    add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
+    add_plugin(Aws::Personalize::Plugins::Endpoints)
 
     # @overload initialize(options)
     #   @param [Hash] options
@@ -297,6 +298,19 @@ module Aws::Personalize
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Aws::TokenProvider] :token_provider
+    #     A Bearer Token Provider. This can be an instance of any one of the
+    #     following classes:
+    #
+    #     * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
+    #       tokens.
+    #
+    #     * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
+    #     will be used to search for tokens configured for your profile in shared configuration files.
+    #
     #   @option options [Boolean] :use_dualstack_endpoint
     #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
     #     will be used if available.
@@ -310,6 +324,9 @@ module Aws::Personalize
     #     When `true`, request parameters are validated before
     #     sending the request.
     #
+    #   @option options [Aws::Personalize::EndpointProvider] :endpoint_provider
+    #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::Personalize::EndpointParameters`
+    #
     #   @option options [URI::HTTP,String] :http_proxy A proxy to send
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
@@ -1072,6 +1089,10 @@ module Aws::Personalize
     #     in your dataset. Amazon Personalize replaces any record with the
     #     same ID with the new one.
     #
+    # @option params [Boolean] :publish_attribution_metrics_to_s3
+    #   If you created a metric attribution, specify whether to publish
+    #   metrics for this import job to Amazon S3
+    #
     # @return [Types::CreateDatasetImportJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateDatasetImportJobResponse#dataset_import_job_arn #dataset_import_job_arn} => String
@@ -1092,6 +1113,7 @@ module Aws::Personalize
     #       },
     #     ],
     #     import_mode: "FULL", # accepts FULL, INCREMENTAL
+    #     publish_attribution_metrics_to_s3: false,
     #   })
     #
     # @example Response structure
@@ -1259,6 +1281,71 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Creates a metric attribution. A metric attribution creates reports on
+    # the data that you import into Amazon Personalize. Depending on how you
+    # imported the data, you can view reports in Amazon CloudWatch or Amazon
+    # S3. For more information, see [Measuring impact of
+    # recommendations][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html
+    #
+    # @option params [required, String] :name
+    #   A name for the metric attribution.
+    #
+    # @option params [required, String] :dataset_group_arn
+    #   The Amazon Resource Name (ARN) of the destination dataset group for
+    #   the metric attribution.
+    #
+    # @option params [required, Array<Types::MetricAttribute>] :metrics
+    #   A list of metric attributes for the metric attribution. Each metric
+    #   attribute specifies an event type to track and a function. Available
+    #   functions are `SUM()` or `SAMPLECOUNT()`. For SUM() functions, provide
+    #   the dataset type (either Interactions or Items) and column to sum as a
+    #   parameter. For example SUM(Items.PRICE).
+    #
+    # @option params [required, Types::MetricAttributionOutput] :metrics_output_config
+    #   The output configuration details for the metric attribution.
+    #
+    # @return [Types::CreateMetricAttributionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateMetricAttributionResponse#metric_attribution_arn #metric_attribution_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_metric_attribution({
+    #     name: "Name", # required
+    #     dataset_group_arn: "Arn", # required
+    #     metrics: [ # required
+    #       {
+    #         event_type: "EventType", # required
+    #         metric_name: "MetricName", # required
+    #         expression: "MetricExpression", # required
+    #       },
+    #     ],
+    #     metrics_output_config: { # required
+    #       s3_data_destination: {
+    #         path: "S3Location", # required
+    #         kms_key_arn: "KmsKeyArn",
+    #       },
+    #       role_arn: "RoleArn", # required
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.metric_attribution_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/CreateMetricAttribution AWS API Documentation
+    #
+    # @overload create_metric_attribution(params = {})
+    # @param [Hash] params ({})
+    def create_metric_attribution(params = {}, options = {})
+      req = build_request(:create_metric_attribution, params)
+      req.send_request(options)
+    end
+
     # Creates a recommender with the recipe (a Domain dataset group use
     # case) you specify. You create recommenders for a Domain dataset group
     # and specify the recommender's Amazon Resource Name (ARN) when you
@@ -1704,6 +1791,9 @@ module Aws::Personalize
     # [5]: https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html
     # [6]: https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html
     #
+    # @option params [String] :name
+    #   The name of the solution version.
+    #
     # @option params [required, String] :solution_arn
     #   The Amazon Resource Name (ARN) of the solution containing the training
     #   configuration information.
@@ -1740,6 +1830,7 @@ module Aws::Personalize
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_solution_version({
+    #     name: "Name",
     #     solution_arn: "Arn", # required
     #     training_mode: "FULL", # accepts FULL, UPDATE
     #     tags: [
@@ -1902,6 +1993,28 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Deletes a metric attribution.
+    #
+    # @option params [required, String] :metric_attribution_arn
+    #   The metric attribution's Amazon Resource Name (ARN).
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_metric_attribution({
+    #     metric_attribution_arn: "Arn", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DeleteMetricAttribution AWS API Documentation
+    #
+    # @overload delete_metric_attribution(params = {})
+    # @param [Hash] params ({})
+    def delete_metric_attribution(params = {}, options = {})
+      req = build_request(:delete_metric_attribution, params)
+      req.send_request(options)
+    end
+
     # Deactivates and removes a recommender. A deleted recommender can no
     # longer be specified in a [GetRecommendations][1] request.
     #
@@ -2349,6 +2462,7 @@ module Aws::Personalize
     #   resp.dataset_import_job.last_updated_date_time #=> Time
     #   resp.dataset_import_job.failure_reason #=> String
     #   resp.dataset_import_job.import_mode #=> String, one of "FULL", "INCREMENTAL"
+    #   resp.dataset_import_job.publish_attribution_metrics_to_s3 #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeDatasetImportJob AWS API Documentation
     #
@@ -2470,6 +2584,43 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Describes a metric attribution.
+    #
+    # @option params [required, String] :metric_attribution_arn
+    #   The metric attribution's Amazon Resource Name (ARN).
+    #
+    # @return [Types::DescribeMetricAttributionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeMetricAttributionResponse#metric_attribution #metric_attribution} => Types::MetricAttribution
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_metric_attribution({
+    #     metric_attribution_arn: "Arn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.metric_attribution.name #=> String
+    #   resp.metric_attribution.metric_attribution_arn #=> String
+    #   resp.metric_attribution.dataset_group_arn #=> String
+    #   resp.metric_attribution.metrics_output_config.s3_data_destination.path #=> String
+    #   resp.metric_attribution.metrics_output_config.s3_data_destination.kms_key_arn #=> String
+    #   resp.metric_attribution.metrics_output_config.role_arn #=> String
+    #   resp.metric_attribution.status #=> String
+    #   resp.metric_attribution.creation_date_time #=> Time
+    #   resp.metric_attribution.last_updated_date_time #=> Time
+    #   resp.metric_attribution.failure_reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/DescribeMetricAttribution AWS API Documentation
+    #
+    # @overload describe_metric_attribution(params = {})
+    # @param [Hash] params ({})
+    def describe_metric_attribution(params = {}, options = {})
+      req = build_request(:describe_metric_attribution, params)
+      req.send_request(options)
+    end
+
     # Describes a recipe.
     #
     # A recipe contains three items:
@@ -2731,6 +2882,7 @@ module Aws::Personalize
     #
     # @example Response structure
     #
+    #   resp.solution_version.name #=> String
     #   resp.solution_version.solution_version_arn #=> String
     #   resp.solution_version.solution_arn #=> String
     #   resp.solution_version.perform_hpo #=> Boolean
@@ -3301,6 +3453,99 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Lists the metrics for the metric attribution.
+    #
+    # @option params [String] :metric_attribution_arn
+    #   The Amazon Resource Name (ARN) of the metric attribution to retrieve
+    #   attributes for.
+    #
+    # @option params [String] :next_token
+    #   Specify the pagination token from a previous request to retrieve the
+    #   next page of results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of metrics to return in one page of results.
+    #
+    # @return [Types::ListMetricAttributionMetricsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListMetricAttributionMetricsResponse#metrics #metrics} => Array&lt;Types::MetricAttribute&gt;
+    #   * {Types::ListMetricAttributionMetricsResponse#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.list_metric_attribution_metrics({
+    #     metric_attribution_arn: "Arn",
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.metrics #=> Array
+    #   resp.metrics[0].event_type #=> String
+    #   resp.metrics[0].metric_name #=> String
+    #   resp.metrics[0].expression #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListMetricAttributionMetrics AWS API Documentation
+    #
+    # @overload list_metric_attribution_metrics(params = {})
+    # @param [Hash] params ({})
+    def list_metric_attribution_metrics(params = {}, options = {})
+      req = build_request(:list_metric_attribution_metrics, params)
+      req.send_request(options)
+    end
+
+    # Lists metric attributions.
+    #
+    # @option params [String] :dataset_group_arn
+    #   The metric attributions' dataset group Amazon Resource Name (ARN).
+    #
+    # @option params [String] :next_token
+    #   Specify the pagination token from a previous request to retrieve the
+    #   next page of results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of metric attributions to return in one page of
+    #   results.
+    #
+    # @return [Types::ListMetricAttributionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListMetricAttributionsResponse#metric_attributions #metric_attributions} => Array&lt;Types::MetricAttributionSummary&gt;
+    #   * {Types::ListMetricAttributionsResponse#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.list_metric_attributions({
+    #     dataset_group_arn: "Arn",
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.metric_attributions #=> Array
+    #   resp.metric_attributions[0].name #=> String
+    #   resp.metric_attributions[0].metric_attribution_arn #=> String
+    #   resp.metric_attributions[0].status #=> String
+    #   resp.metric_attributions[0].creation_date_time #=> Time
+    #   resp.metric_attributions[0].last_updated_date_time #=> Time
+    #   resp.metric_attributions[0].failure_reason #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListMetricAttributions AWS API Documentation
+    #
+    # @overload list_metric_attributions(params = {})
+    # @param [Hash] params ({})
+    def list_metric_attributions(params = {}, options = {})
+      req = build_request(:list_metric_attributions, params)
+      req.send_request(options)
+    end
+
     # Returns a list of available recipes. The response provides the
     # properties for each recipe, including the recipe's Amazon Resource
     # Name (ARN).
@@ -3558,6 +3803,7 @@ module Aws::Personalize
     #   resp.solutions[0].status #=> String
     #   resp.solutions[0].creation_date_time #=> Time
     #   resp.solutions[0].last_updated_date_time #=> Time
+    #   resp.solutions[0].recipe_arn #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/ListSolutions AWS API Documentation
@@ -3829,6 +4075,58 @@ module Aws::Personalize
       req.send_request(options)
     end
 
+    # Updates a metric attribution.
+    #
+    # @option params [Array<Types::MetricAttribute>] :add_metrics
+    #   Add new metric attributes to the metric attribution.
+    #
+    # @option params [Array<String>] :remove_metrics
+    #   Remove metric attributes from the metric attribution.
+    #
+    # @option params [Types::MetricAttributionOutput] :metrics_output_config
+    #   An output config for the metric attribution.
+    #
+    # @option params [String] :metric_attribution_arn
+    #   The Amazon Resource Name (ARN) for the metric attribution to update.
+    #
+    # @return [Types::UpdateMetricAttributionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateMetricAttributionResponse#metric_attribution_arn #metric_attribution_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_metric_attribution({
+    #     add_metrics: [
+    #       {
+    #         event_type: "EventType", # required
+    #         metric_name: "MetricName", # required
+    #         expression: "MetricExpression", # required
+    #       },
+    #     ],
+    #     remove_metrics: ["MetricName"],
+    #     metrics_output_config: {
+    #       s3_data_destination: {
+    #         path: "S3Location", # required
+    #         kms_key_arn: "KmsKeyArn",
+    #       },
+    #       role_arn: "RoleArn", # required
+    #     },
+    #     metric_attribution_arn: "Arn",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.metric_attribution_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/personalize-2018-05-22/UpdateMetricAttribution AWS API Documentation
+    #
+    # @overload update_metric_attribution(params = {})
+    # @param [Hash] params ({})
+    def update_metric_attribution(params = {}, options = {})
+      req = build_request(:update_metric_attribution, params)
+      req.send_request(options)
+    end
+
     # Updates the recommender to modify the recommender configuration.
     #
     # @option params [required, String] :recommender_arn
@@ -3879,7 +4177,7 @@ module Aws::Personalize
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-personalize'
-      context[:gem_version] = '1.43.0'
+      context[:gem_version] = '1.45.0'
       Seahorse::Client::Request.new(handlers, context)
     end