aws-sdk-kendra 1.63.0 → 1.65.0

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

@@ -536,6 +536,44 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Removes one or more sets of featured results. Features results are
+    # placed above all other results for certain queries. If there's an
+    # exact match of a query, then one or more specific documents are
+    # featured in the search results.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index used for featuring results.
+    #
+    # @option params [required, Array<String>] :featured_results_set_ids
+    #   The identifiers of the featured results sets that you want to delete.
+    #
+    # @return [Types::BatchDeleteFeaturedResultsSetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::BatchDeleteFeaturedResultsSetResponse#errors #errors} => Array&lt;Types::BatchDeleteFeaturedResultsSetError&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.batch_delete_featured_results_set({
+    #     index_id: "IndexId", # required
+    #     featured_results_set_ids: ["FeaturedResultsSetId"], # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.errors #=> Array
+    #   resp.errors[0].id #=> String
+    #   resp.errors[0].error_code #=> String, one of "InternalError", "InvalidRequest"
+    #   resp.errors[0].error_message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/BatchDeleteFeaturedResultsSet AWS API Documentation
+    #
+    # @overload batch_delete_featured_results_set(params = {})
+    # @param [Hash] params ({})
+    def batch_delete_featured_results_set(params = {}, options = {})
+      req = build_request(:batch_delete_featured_results_set, params)
+      req.send_request(options)
+    end
+
     # Returns the indexing status for one or more documents submitted with
     # the [ BatchPutDocument][1] API.
     #
@@ -639,8 +677,8 @@ module Aws::Kendra
     #   create the index first using the `CreateIndex` API.
     #
     # @option params [String] :role_arn
-    #   The Amazon Resource Name (ARN) of a role that is allowed to run the
-    #   `BatchPutDocument` API. For more information, see [IAM Roles for
+    #   The Amazon Resource Name (ARN) of an IAM role with permission to
+    #   access your S3 bucket. For more information, see [IAM access roles for
     #   Amazon Kendra][1].
     #
     #
@@ -652,14 +690,11 @@ module Aws::Kendra
     #
     #   Documents have the following file size limits.
     #
-    #   * 5 MB total size for inline documents
-    #
-    #   * 50 MB total size for files from an S3 bucket
+    #   * 50 MB total size for any file
     #
     #   * 5 MB extracted text for any file
     #
-    #   For more information about file size and transaction per second
-    #   quotas, see [Quotas][1].
+    #   For more information, see [Quotas][1].
     #
     #
     #
@@ -959,19 +994,15 @@ module Aws::Kendra
     # 200 if the data source was successfully created. Otherwise, an
     # exception is raised.
     #
-    # Amazon S3 and [custom][1] data sources are the only supported data
-    # sources in the Amazon Web Services GovCloud (US-West) region.
-    #
     # For an example of creating an index and data source using the Python
-    # SDK, see [Getting started with Python SDK][2]. For an example of
+    # SDK, see [Getting started with Python SDK][1]. For an example of
     # creating an index and data source using the Java SDK, see [Getting
-    # started with Java SDK][3].
+    # started with Java SDK][2].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/kendra/latest/dg/data-source-custom.html
-    # [2]: https://docs.aws.amazon.com/kendra/latest/dg/gs-python.html
-    # [3]: https://docs.aws.amazon.com/kendra/latest/dg/gs-java.html
+    # [1]: https://docs.aws.amazon.com/kendra/latest/dg/gs-python.html
+    # [2]: https://docs.aws.amazon.com/kendra/latest/dg/gs-java.html
     #
     # @option params [required, String] :name
     #   A name for the data source connector.
@@ -1010,14 +1041,17 @@ module Aws::Kendra
     #   schedule Amazon Kendra will not periodically update the index. You can
     #   call the `StartDataSourceSyncJob` API to update the index.
     #
+    #   Specify a `cron-` format schedule string or an empty string to
+    #   indicate that the index is updated on demand.
+    #
     #   You can't specify the `Schedule` parameter when the `Type` parameter
     #   is set to `CUSTOM`. If you do, you receive a `ValidationException`
     #   exception.
     #
     # @option params [String] :role_arn
-    #   The Amazon Resource Name (ARN) of a role with permission to access the
-    #   data source and required resources. For more information, see [IAM
-    #   roles for Amazon Kendra][1].
+    #   The Amazon Resource Name (ARN) of an IAM role with permission to
+    #   access the data source and required resources. For more information,
+    #   see [IAM access roles for Amazon Kendra.][1].
     #
     #   You can't specify the `RoleArn` parameter when the `Type` parameter
     #   is set to `CUSTOM`. If you do, you receive a `ValidationException`
@@ -1030,9 +1064,11 @@ module Aws::Kendra
     #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html
     #
     # @option params [Array<Types::Tag>] :tags
-    #   A list of key-value pairs that identify the data source connector. You
-    #   can use the tags to identify and organize your resources and to
-    #   control access to resources.
+    #   A list of key-value pairs that identify or categorize the data source
+    #   connector. You can also use tags to help control access to the data
+    #   source connector. Tag keys and values can consist of Unicode letters,
+    #   digits, white space, and any of the following symbols: \_ . : / = + -
+    #   @.
     #
     # @option params [String] :client_token
     #   A token that you provide to identify the request to create a data
@@ -1808,10 +1844,12 @@ module Aws::Kendra
     #   The identifier of the index for your Amazon Kendra experience.
     #
     # @option params [String] :role_arn
-    #   The Amazon Resource Name (ARN) of a role with permission to access
-    #   `Query` API, `QuerySuggestions` API, `SubmitFeedback` API, and IAM
-    #   Identity Center that stores your user and group information. For more
-    #   information, see [IAM roles for Amazon Kendra][1].
+    #   The Amazon Resource Name (ARN) of an IAM role with permission to
+    #   access `Query` API, `GetQuerySuggestions` API, and other required
+    #   APIs. The role also must include permission to access IAM Identity
+    #   Center (successor to Single Sign-On) that stores your user and group
+    #   information. For more information, see [IAM access roles for Amazon
+    #   Kendra][1].
     #
     #
     #
@@ -1872,8 +1910,8 @@ module Aws::Kendra
       req.send_request(options)
     end
 
-    # Creates an new set of frequently asked question (FAQ) questions and
-    # answers.
+    # Creates a set of frequently ask questions (FAQs) using a specified FAQ
+    # file stored in an Amazon S3 bucket.
     #
     # Adding FAQs to an index is an asynchronous operation.
     #
@@ -1897,9 +1935,9 @@ module Aws::Kendra
     #   The path to the FAQ file in S3.
     #
     # @option params [required, String] :role_arn
-    #   The Amazon Resource Name (ARN) of a role with permission to access the
-    #   S3 bucket that contains the FAQs. For more information, see [IAM Roles
-    #   for Amazon Kendra][1].
+    #   The Amazon Resource Name (ARN) of an IAM role with permission to
+    #   access the S3 bucket that contains the FAQs. For more information, see
+    #   [IAM access roles for Amazon Kendra][1].
     #
     #
     #
@@ -1981,6 +2019,119 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Creates a set of featured results to display at the top of the search
+    # results page. Featured results are placed above all other results for
+    # certain queries. You map specific queries to specific documents for
+    # featuring in the results. If a query contains an exact match, then one
+    # or more specific documents are featured in the search results.
+    #
+    # You can create up to 50 sets of featured results per index. You can
+    # request to increase this limit by contacting [Support][1].
+    #
+    #
+    #
+    # [1]: http://aws.amazon.com/contact-us/
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index that you want to use for featuring
+    #   results.
+    #
+    # @option params [required, String] :featured_results_set_name
+    #   A name for the set of featured results.
+    #
+    # @option params [String] :description
+    #   A description for the set of featured results.
+    #
+    # @option params [String] :client_token
+    #   A token that you provide to identify the request to create a set of
+    #   featured results. Multiple calls to the `CreateFeaturedResultsSet` API
+    #   with the same client token will create only one featured results set.
+    #
+    # @option params [String] :status
+    #   The current status of the set of featured results. When the value is
+    #   `ACTIVE`, featured results are ready for use. You can still configure
+    #   your settings before setting the status to `ACTIVE`. You can set the
+    #   status to `ACTIVE` or `INACTIVE` using the
+    #   [UpdateFeaturedResultsSet][1] API. The queries you specify for
+    #   featured results must be unique per featured results set for each
+    #   index, whether the status is `ACTIVE` or `INACTIVE`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_UpdateFeaturedResultsSet.html
+    #
+    # @option params [Array<String>] :query_texts
+    #   A list of queries for featuring results. For more information on the
+    #   list of queries, see [FeaturedResultsSet][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html
+    #
+    # @option params [Array<Types::FeaturedDocument>] :featured_documents
+    #   A list of document IDs for the documents you want to feature at the
+    #   top of the search results page. For more information on the list of
+    #   documents, see [FeaturedResultsSet][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   A list of key-value pairs that identify or categorize the featured
+    #   results set. You can also use tags to help control access to the
+    #   featured results set. Tag keys and values can consist of Unicode
+    #   letters, digits, white space, and any of the following symbols:\_ . :
+    #   / = + - @.
+    #
+    # @return [Types::CreateFeaturedResultsSetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateFeaturedResultsSetResponse#featured_results_set #featured_results_set} => Types::FeaturedResultsSet
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_featured_results_set({
+    #     index_id: "IndexId", # required
+    #     featured_results_set_name: "FeaturedResultsSetName", # required
+    #     description: "FeaturedResultsSetDescription",
+    #     client_token: "ClientTokenName",
+    #     status: "ACTIVE", # accepts ACTIVE, INACTIVE
+    #     query_texts: ["QueryText"],
+    #     featured_documents: [
+    #       {
+    #         id: "DocumentId",
+    #       },
+    #     ],
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.featured_results_set.featured_results_set_id #=> String
+    #   resp.featured_results_set.featured_results_set_name #=> String
+    #   resp.featured_results_set.description #=> String
+    #   resp.featured_results_set.status #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.featured_results_set.query_texts #=> Array
+    #   resp.featured_results_set.query_texts[0] #=> String
+    #   resp.featured_results_set.featured_documents #=> Array
+    #   resp.featured_results_set.featured_documents[0].id #=> String
+    #   resp.featured_results_set.last_updated_timestamp #=> Integer
+    #   resp.featured_results_set.creation_timestamp #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/CreateFeaturedResultsSet AWS API Documentation
+    #
+    # @overload create_featured_results_set(params = {})
+    # @param [Hash] params ({})
+    def create_featured_results_set(params = {}, options = {})
+      req = build_request(:create_featured_results_set, params)
+      req.send_request(options)
+    end
+
     # Creates an Amazon Kendra index. Index creation is an asynchronous API.
     # To determine if index creation has completed, check the `Status` field
     # returned from a call to `DescribeIndex`. The `Status` field is set to
@@ -2005,14 +2156,13 @@ module Aws::Kendra
     # @option params [String] :edition
     #   The Amazon Kendra edition to use for the index. Choose
     #   `DEVELOPER_EDITION` for indexes intended for development, testing, or
-    #   proof of concept. Use `ENTERPRISE_EDITION` for your production
-    #   databases. Once you set the edition for an index, it can't be
-    #   changed.
+    #   proof of concept. Use `ENTERPRISE_EDITION` for production. Once you
+    #   set the edition for an index, it can't be changed.
     #
     #   The `Edition` parameter is optional. If you don't supply a value, the
     #   default is `ENTERPRISE_EDITION`.
     #
-    #   For more information on quota limits for enterprise and developer
+    #   For more information on quota limits for Enterprise and Developer
     #   editions, see [Quotas][1].
     #
     #
@@ -2020,10 +2170,13 @@ module Aws::Kendra
     #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/quotas.html
     #
     # @option params [required, String] :role_arn
-    #   An Identity and Access Management (IAM) role that gives Amazon Kendra
-    #   permissions to access your Amazon CloudWatch logs and metrics. This is
-    #   also the role you use when you call the `BatchPutDocument` API to
-    #   index documents from an Amazon S3 bucket.
+    #   The Amazon Resource Name (ARN) of an IAM role with permission to
+    #   access your Amazon CloudWatch logs and metrics. For more information,
+    #   see [IAM access roles for Amazon Kendra][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html
     #
     # @option params [Types::ServerSideEncryptionConfiguration] :server_side_encryption_configuration
     #   The identifier of the KMS customer managed key (CMK) that's used to
@@ -2042,9 +2195,10 @@ module Aws::Kendra
     #   not need to pass this option.**
     #
     # @option params [Array<Types::Tag>] :tags
-    #   A list of key-value pairs that identify the index. You can use the
-    #   tags to identify and organize your resources and to control access to
-    #   resources.
+    #   A list of key-value pairs that identify or categorize the index. You
+    #   can also use tags to help control access to the index. Tag keys and
+    #   values can consist of Unicode letters, digits, white space, and any of
+    #   the following symbols: \_ . : / = + - @.
     #
     # @option params [Array<Types::UserTokenConfiguration>] :user_token_configurations
     #   The user token configuration.
@@ -2066,9 +2220,9 @@ module Aws::Kendra
     #     accessible to the user will be searchable and displayable.
     #
     # @option params [Types::UserGroupResolutionConfiguration] :user_group_resolution_configuration
-    #   Enables fetching access levels of groups and users from an IAM
-    #   Identity Center (successor to Single Sign-On) identity source. To
-    #   configure this, see [UserGroupResolutionConfiguration][1].
+    #   Gets users and groups from IAM Identity Center (successor to Single
+    #   Sign-On) identity source. To configure this, see
+    #   [UserGroupResolutionConfiguration][1].
     #
     #
     #
@@ -2152,21 +2306,21 @@ module Aws::Kendra
     #
     #
     # [1]: https://docs.aws.amazon.com/kendra/latest/dg/quotas.html
-    # [2]: https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html#suggestions-block-list
+    # [2]: https://docs.aws.amazon.com/kendra/latest/dg/query-suggestions.html#query-suggestions-blocklist
     #
     # @option params [required, String] :index_id
     #   The identifier of the index you want to create a query suggestions
     #   block list for.
     #
     # @option params [required, String] :name
-    #   A user friendly name for the block list.
+    #   A name for the block list.
     #
-    #   For example, the block list named 'offensive-words' includes all
+    #   For example, the name 'offensive-words', which includes all
     #   offensive words that could appear in user queries and need to be
     #   blocked from suggestions.
     #
     # @option params [String] :description
-    #   A user-friendly description for the block list.
+    #   A description for the block list.
     #
     #   For example, the description "List of all offensive words that can
     #   appear in user queries and need to be blocked from suggestions."
@@ -2191,17 +2345,18 @@ module Aws::Kendra
     #   not need to pass this option.**
     #
     # @option params [required, String] :role_arn
-    #   The IAM (Identity and Access Management) role used by Amazon Kendra to
-    #   access the block list text file in your S3 bucket.
+    #   The Amazon Resource Name (ARN) of an IAM role with permission to
+    #   access your S3 bucket that contains the block list text file. For more
+    #   information, see [IAM access roles for Amazon Kendra][1].
+    #
+    #
     #
-    #   You need permissions to the role ARN (Amazon Web Services Resource
-    #   Name). The role needs S3 read permissions to your file in S3 and needs
-    #   to give STS (Security Token Service) assume role permissions to Amazon
-    #   Kendra.
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html
     #
     # @option params [Array<Types::Tag>] :tags
-    #   A tag that you can assign to a block list that categorizes the block
-    #   list.
+    #   A list of key-value pairs that identify or categorize the block list.
+    #   Tag keys and values can consist of Unicode letters, digits, white
+    #   space, and any of the following symbols: \_ . : / = + - @.
     #
     # @return [Types::CreateQuerySuggestionsBlockListResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2260,13 +2415,19 @@ module Aws::Kendra
     #   A description for the thesaurus.
     #
     # @option params [required, String] :role_arn
-    #   An IAM role that gives Amazon Kendra permissions to access thesaurus
-    #   file specified in `SourceS3Path`.
+    #   The Amazon Resource Name (ARN) of an IAM role with permission to
+    #   access your S3 bucket that contains the thesaurus file. For more
+    #   information, see [IAM access roles for Amazon Kendra][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html
     #
     # @option params [Array<Types::Tag>] :tags
-    #   A list of key-value pairs that identify the thesaurus. You can use the
-    #   tags to identify and organize your resources and to control access to
-    #   resources.
+    #   A list of key-value pairs that identify or categorize the thesaurus.
+    #   You can also use tags to help control access to the thesaurus. Tag
+    #   keys and values can consist of Unicode letters, digits, white space,
+    #   and any of the following symbols: \_ . : / = + - @.
     #
     # @option params [required, Types::S3Path] :source_s3_path
     #   The path to the thesaurus file in S3.
@@ -2507,14 +2668,14 @@ module Aws::Kendra
     #   prevents previous actions with lower number IDs from possibly
     #   overriding the latest action.
     #
-    #   The ordering ID can be the UNIX time of the last update you made to a
+    #   The ordering ID can be the Unix time of the last update you made to a
     #   group members list. You would then provide this list when calling
     #   `PutPrincipalMapping`. This ensures your `DELETE` action for that
     #   updated group with the latest members list doesn't get overwritten by
     #   earlier `DELETE` actions for the same group which are yet to be
     #   processed.
     #
-    #   The default ordering ID is the current UNIX time in milliseconds that
+    #   The default ordering ID is the current Unix time in milliseconds that
     #   the action was received by Amazon Kendra.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -3324,6 +3485,63 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Gets information about a set of featured results. Features results are
+    # placed above all other results for certain queries. If there's an
+    # exact match of a query, then one or more specific documents are
+    # featured in the search results.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index used for featuring results.
+    #
+    # @option params [required, String] :featured_results_set_id
+    #   The identifier of the set of featured results that you want to get
+    #   information on.
+    #
+    # @return [Types::DescribeFeaturedResultsSetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeFeaturedResultsSetResponse#featured_results_set_id #featured_results_set_id} => String
+    #   * {Types::DescribeFeaturedResultsSetResponse#featured_results_set_name #featured_results_set_name} => String
+    #   * {Types::DescribeFeaturedResultsSetResponse#description #description} => String
+    #   * {Types::DescribeFeaturedResultsSetResponse#status #status} => String
+    #   * {Types::DescribeFeaturedResultsSetResponse#query_texts #query_texts} => Array&lt;String&gt;
+    #   * {Types::DescribeFeaturedResultsSetResponse#featured_documents_with_metadata #featured_documents_with_metadata} => Array&lt;Types::FeaturedDocumentWithMetadata&gt;
+    #   * {Types::DescribeFeaturedResultsSetResponse#featured_documents_missing #featured_documents_missing} => Array&lt;Types::FeaturedDocumentMissing&gt;
+    #   * {Types::DescribeFeaturedResultsSetResponse#last_updated_timestamp #last_updated_timestamp} => Integer
+    #   * {Types::DescribeFeaturedResultsSetResponse#creation_timestamp #creation_timestamp} => Integer
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_featured_results_set({
+    #     index_id: "IndexId", # required
+    #     featured_results_set_id: "FeaturedResultsSetId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.featured_results_set_id #=> String
+    #   resp.featured_results_set_name #=> String
+    #   resp.description #=> String
+    #   resp.status #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.query_texts #=> Array
+    #   resp.query_texts[0] #=> String
+    #   resp.featured_documents_with_metadata #=> Array
+    #   resp.featured_documents_with_metadata[0].id #=> String
+    #   resp.featured_documents_with_metadata[0].title #=> String
+    #   resp.featured_documents_with_metadata[0].uri #=> String
+    #   resp.featured_documents_missing #=> Array
+    #   resp.featured_documents_missing[0].id #=> String
+    #   resp.last_updated_timestamp #=> Integer
+    #   resp.creation_timestamp #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeFeaturedResultsSet AWS API Documentation
+    #
+    # @overload describe_featured_results_set(params = {})
+    # @param [Hash] params ({})
+    def describe_featured_results_set(params = {}, options = {})
+      req = build_request(:describe_featured_results_set, params)
+      req.send_request(options)
+    end
+
     # Gets information about an existing Amazon Kendra index.
     #
     # @option params [required, String] :id
@@ -3549,6 +3767,7 @@ module Aws::Kendra
     #   * {Types::DescribeQuerySuggestionsConfigResponse#last_suggestions_build_time #last_suggestions_build_time} => Time
     #   * {Types::DescribeQuerySuggestionsConfigResponse#last_clear_time #last_clear_time} => Time
     #   * {Types::DescribeQuerySuggestionsConfigResponse#total_suggestions_count #total_suggestions_count} => Integer
+    #   * {Types::DescribeQuerySuggestionsConfigResponse#attribute_suggestions_config #attribute_suggestions_config} => Types::AttributeSuggestionsDescribeConfig
     #
     # @example Request syntax with placeholder values
     #
@@ -3567,6 +3786,10 @@ module Aws::Kendra
     #   resp.last_suggestions_build_time #=> Time
     #   resp.last_clear_time #=> Time
     #   resp.total_suggestions_count #=> Integer
+    #   resp.attribute_suggestions_config.suggestable_config_list #=> Array
+    #   resp.attribute_suggestions_config.suggestable_config_list[0].attribute_name #=> String
+    #   resp.attribute_suggestions_config.suggestable_config_list[0].suggestable #=> Boolean
+    #   resp.attribute_suggestions_config.attribute_suggestions_mode #=> String, one of "ACTIVE", "INACTIVE"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeQuerySuggestionsConfig AWS API Documentation
     #
@@ -3756,6 +3979,23 @@ module Aws::Kendra
     #   The maximum number of query suggestions you want to show to your
     #   users.
     #
+    # @option params [Array<String>] :suggestion_types
+    #   The suggestions type to base query suggestions on. The suggestion
+    #   types are query history or document fields/attributes. You can set one
+    #   type or the other.
+    #
+    #   If you set query history as your suggestions type, Amazon Kendra
+    #   suggests queries relevant to your users based on popular queries in
+    #   the query history.
+    #
+    #   If you set document fields/attributes as your suggestions type, Amazon
+    #   Kendra suggests queries relevant to your users based on the contents
+    #   of document fields.
+    #
+    # @option params [Types::AttributeSuggestionsGetConfig] :attribute_suggestions_config
+    #   Configuration information for the document fields/attributes that you
+    #   want to base query suggestions on.
+    #
     # @return [Types::GetQuerySuggestionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetQuerySuggestionsResponse#query_suggestions_id #query_suggestions_id} => String
@@ -3767,6 +4007,100 @@ module Aws::Kendra
     #     index_id: "IndexId", # required
     #     query_text: "SuggestionQueryText", # required
     #     max_suggestions_count: 1,
+    #     suggestion_types: ["QUERY"], # accepts QUERY, DOCUMENT_ATTRIBUTES
+    #     attribute_suggestions_config: {
+    #       suggestion_attributes: ["DocumentAttributeKey"],
+    #       additional_response_attributes: ["DocumentAttributeKey"],
+    #       attribute_filter: {
+    #         and_all_filters: [
+    #           {
+    #             # recursive AttributeFilter
+    #           },
+    #         ],
+    #         or_all_filters: [
+    #           {
+    #             # recursive AttributeFilter
+    #           },
+    #         ],
+    #         not_filter: {
+    #           # recursive AttributeFilter
+    #         },
+    #         equals_to: {
+    #           key: "DocumentAttributeKey", # required
+    #           value: { # required
+    #             string_value: "DocumentAttributeStringValue",
+    #             string_list_value: ["String"],
+    #             long_value: 1,
+    #             date_value: Time.now,
+    #           },
+    #         },
+    #         contains_all: {
+    #           key: "DocumentAttributeKey", # required
+    #           value: { # required
+    #             string_value: "DocumentAttributeStringValue",
+    #             string_list_value: ["String"],
+    #             long_value: 1,
+    #             date_value: Time.now,
+    #           },
+    #         },
+    #         contains_any: {
+    #           key: "DocumentAttributeKey", # required
+    #           value: { # required
+    #             string_value: "DocumentAttributeStringValue",
+    #             string_list_value: ["String"],
+    #             long_value: 1,
+    #             date_value: Time.now,
+    #           },
+    #         },
+    #         greater_than: {
+    #           key: "DocumentAttributeKey", # required
+    #           value: { # required
+    #             string_value: "DocumentAttributeStringValue",
+    #             string_list_value: ["String"],
+    #             long_value: 1,
+    #             date_value: Time.now,
+    #           },
+    #         },
+    #         greater_than_or_equals: {
+    #           key: "DocumentAttributeKey", # required
+    #           value: { # required
+    #             string_value: "DocumentAttributeStringValue",
+    #             string_list_value: ["String"],
+    #             long_value: 1,
+    #             date_value: Time.now,
+    #           },
+    #         },
+    #         less_than: {
+    #           key: "DocumentAttributeKey", # required
+    #           value: { # required
+    #             string_value: "DocumentAttributeStringValue",
+    #             string_list_value: ["String"],
+    #             long_value: 1,
+    #             date_value: Time.now,
+    #           },
+    #         },
+    #         less_than_or_equals: {
+    #           key: "DocumentAttributeKey", # required
+    #           value: { # required
+    #             string_value: "DocumentAttributeStringValue",
+    #             string_list_value: ["String"],
+    #             long_value: 1,
+    #             date_value: Time.now,
+    #           },
+    #         },
+    #       },
+    #       user_context: {
+    #         token: "Token",
+    #         user_id: "PrincipalName",
+    #         groups: ["PrincipalName"],
+    #         data_source_groups: [
+    #           {
+    #             group_id: "PrincipalName", # required
+    #             data_source_id: "DataSourceId", # required
+    #           },
+    #         ],
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -3778,6 +4112,17 @@ module Aws::Kendra
     #   resp.suggestions[0].value.text.highlights #=> Array
     #   resp.suggestions[0].value.text.highlights[0].begin_offset #=> Integer
     #   resp.suggestions[0].value.text.highlights[0].end_offset #=> Integer
+    #   resp.suggestions[0].source_documents #=> Array
+    #   resp.suggestions[0].source_documents[0].document_id #=> String
+    #   resp.suggestions[0].source_documents[0].suggestion_attributes #=> Array
+    #   resp.suggestions[0].source_documents[0].suggestion_attributes[0] #=> String
+    #   resp.suggestions[0].source_documents[0].additional_attributes #=> Array
+    #   resp.suggestions[0].source_documents[0].additional_attributes[0].key #=> String
+    #   resp.suggestions[0].source_documents[0].additional_attributes[0].value.string_value #=> String
+    #   resp.suggestions[0].source_documents[0].additional_attributes[0].value.string_list_value #=> Array
+    #   resp.suggestions[0].source_documents[0].additional_attributes[0].value.string_list_value[0] #=> String
+    #   resp.suggestions[0].source_documents[0].additional_attributes[0].value.long_value #=> Integer
+    #   resp.suggestions[0].source_documents[0].additional_attributes[0].value.date_value #=> Time
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/GetQuerySuggestions AWS API Documentation
     #
@@ -3800,22 +4145,22 @@ module Aws::Kendra
     #   interval uses the time zone of your index. You can view data in the
     #   following time windows:
     #
-    #   * `THIS_WEEK`\: The current week, starting on the Sunday and ending on
+    #   * `THIS_WEEK`: The current week, starting on the Sunday and ending on
     #     the day before the current date.
     #
-    #   * `ONE_WEEK_AGO`\: The previous week, starting on the Sunday and
-    #     ending on the following Saturday.
+    #   * `ONE_WEEK_AGO`: The previous week, starting on the Sunday and ending
+    #     on the following Saturday.
     #
-    #   * `TWO_WEEKS_AGO`\: The week before the previous week, starting on the
+    #   * `TWO_WEEKS_AGO`: The week before the previous week, starting on the
     #     Sunday and ending on the following Saturday.
     #
-    #   * `THIS_MONTH`\: The current month, starting on the first day of the
+    #   * `THIS_MONTH`: The current month, starting on the first day of the
     #     month and ending on the day before the current date.
     #
-    #   * `ONE_MONTH_AGO`\: The previous month, starting on the first day of
+    #   * `ONE_MONTH_AGO`: The previous month, starting on the first day of
     #     the month and ending on the last day of the month.
     #
-    #   * `TWO_MONTHS_AGO`\: The month before the previous month, starting on
+    #   * `TWO_MONTHS_AGO`: The month before the previous month, starting on
     #     the first day of the month and ending on last day of the month.
     #
     # @option params [required, String] :metric_type
@@ -4266,6 +4611,54 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Lists all your sets of featured results for a given index. Features
+    # results are placed above all other results for certain queries. If
+    # there's an exact match of a query, then one or more specific
+    # documents are featured in the search results.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index used for featuring results.
+    #
+    # @option params [String] :next_token
+    #   If the response is truncated, Amazon Kendra returns a pagination token
+    #   in the response. You can use this pagination token to retrieve the
+    #   next set of featured results sets.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of featured results sets to return.
+    #
+    # @return [Types::ListFeaturedResultsSetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListFeaturedResultsSetsResponse#featured_results_set_summary_items #featured_results_set_summary_items} => Array&lt;Types::FeaturedResultsSetSummary&gt;
+    #   * {Types::ListFeaturedResultsSetsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_featured_results_sets({
+    #     index_id: "IndexId", # required
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.featured_results_set_summary_items #=> Array
+    #   resp.featured_results_set_summary_items[0].featured_results_set_id #=> String
+    #   resp.featured_results_set_summary_items[0].featured_results_set_name #=> String
+    #   resp.featured_results_set_summary_items[0].status #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.featured_results_set_summary_items[0].last_updated_timestamp #=> Integer
+    #   resp.featured_results_set_summary_items[0].creation_timestamp #=> Integer
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ListFeaturedResultsSets AWS API Documentation
+    #
+    # @overload list_featured_results_sets(params = {})
+    # @param [Hash] params ({})
+    def list_featured_results_sets(params = {}, options = {})
+      req = build_request(:list_featured_results_sets, params)
+      req.send_request(options)
+    end
+
     # Provides a list of groups that are mapped to users before a given
     # ordering or timestamp identifier.
     #
@@ -4537,9 +4930,6 @@ module Aws::Kendra
     # If more than five `PUT` actions for a group are currently processing,
     # a validation exception is thrown.
     #
-    # `PutPrincipalMapping` is currently not supported in the Amazon Web
-    # Services GovCloud (US-West) region.
-    #
     #
     #
     # [1]: https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html
@@ -4583,13 +4973,13 @@ module Aws::Kendra
     #   prevents previous actions with lower number IDs from possibly
     #   overriding the latest action.
     #
-    #   The ordering ID can be the UNIX time of the last update you made to a
+    #   The ordering ID can be the Unix time of the last update you made to a
     #   group members list. You would then provide this list when calling
     #   `PutPrincipalMapping`. This ensures your `PUT` action for that updated
     #   group with the latest members list doesn't get overwritten by earlier
     #   `PUT` actions for the same group which are yet to be processed.
     #
-    #   The default ordering ID is the current UNIX time in milliseconds that
+    #   The default ordering ID is the current Unix time in milliseconds that
     #   the action was received by Amazon Kendra.
     #
     # @option params [String] :role_arn
@@ -4754,6 +5144,7 @@ module Aws::Kendra
     #   * {Types::QueryResult#total_number_of_results #total_number_of_results} => Integer
     #   * {Types::QueryResult#warnings #warnings} => Array&lt;Types::Warning&gt;
     #   * {Types::QueryResult#spell_corrected_queries #spell_corrected_queries} => Array&lt;Types::SpellCorrectedQuery&gt;
+    #   * {Types::QueryResult#featured_results_items #featured_results_items} => Array&lt;Types::FeaturedResultsItem&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -4954,6 +5345,40 @@ module Aws::Kendra
     #   resp.spell_corrected_queries[0].corrections[0].end_offset #=> Integer
     #   resp.spell_corrected_queries[0].corrections[0].term #=> String
     #   resp.spell_corrected_queries[0].corrections[0].corrected_term #=> String
+    #   resp.featured_results_items #=> Array
+    #   resp.featured_results_items[0].id #=> String
+    #   resp.featured_results_items[0].type #=> String, one of "DOCUMENT", "QUESTION_ANSWER", "ANSWER"
+    #   resp.featured_results_items[0].additional_attributes #=> Array
+    #   resp.featured_results_items[0].additional_attributes[0].key #=> String
+    #   resp.featured_results_items[0].additional_attributes[0].value_type #=> String, one of "TEXT_WITH_HIGHLIGHTS_VALUE"
+    #   resp.featured_results_items[0].additional_attributes[0].value.text_with_highlights_value.text #=> String
+    #   resp.featured_results_items[0].additional_attributes[0].value.text_with_highlights_value.highlights #=> Array
+    #   resp.featured_results_items[0].additional_attributes[0].value.text_with_highlights_value.highlights[0].begin_offset #=> Integer
+    #   resp.featured_results_items[0].additional_attributes[0].value.text_with_highlights_value.highlights[0].end_offset #=> Integer
+    #   resp.featured_results_items[0].additional_attributes[0].value.text_with_highlights_value.highlights[0].top_answer #=> Boolean
+    #   resp.featured_results_items[0].additional_attributes[0].value.text_with_highlights_value.highlights[0].type #=> String, one of "STANDARD", "THESAURUS_SYNONYM"
+    #   resp.featured_results_items[0].document_id #=> String
+    #   resp.featured_results_items[0].document_title.text #=> String
+    #   resp.featured_results_items[0].document_title.highlights #=> Array
+    #   resp.featured_results_items[0].document_title.highlights[0].begin_offset #=> Integer
+    #   resp.featured_results_items[0].document_title.highlights[0].end_offset #=> Integer
+    #   resp.featured_results_items[0].document_title.highlights[0].top_answer #=> Boolean
+    #   resp.featured_results_items[0].document_title.highlights[0].type #=> String, one of "STANDARD", "THESAURUS_SYNONYM"
+    #   resp.featured_results_items[0].document_excerpt.text #=> String
+    #   resp.featured_results_items[0].document_excerpt.highlights #=> Array
+    #   resp.featured_results_items[0].document_excerpt.highlights[0].begin_offset #=> Integer
+    #   resp.featured_results_items[0].document_excerpt.highlights[0].end_offset #=> Integer
+    #   resp.featured_results_items[0].document_excerpt.highlights[0].top_answer #=> Boolean
+    #   resp.featured_results_items[0].document_excerpt.highlights[0].type #=> String, one of "STANDARD", "THESAURUS_SYNONYM"
+    #   resp.featured_results_items[0].document_uri #=> String
+    #   resp.featured_results_items[0].document_attributes #=> Array
+    #   resp.featured_results_items[0].document_attributes[0].key #=> String
+    #   resp.featured_results_items[0].document_attributes[0].value.string_value #=> String
+    #   resp.featured_results_items[0].document_attributes[0].value.string_list_value #=> Array
+    #   resp.featured_results_items[0].document_attributes[0].value.string_list_value[0] #=> String
+    #   resp.featured_results_items[0].document_attributes[0].value.long_value #=> Integer
+    #   resp.featured_results_items[0].document_attributes[0].value.date_value #=> Time
+    #   resp.featured_results_items[0].feedback_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/Query AWS API Documentation
     #
@@ -6077,6 +6502,90 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Updates a set of featured results. Features results are placed above
+    # all other results for certain queries. You map specific queries to
+    # specific documents for featuring in the results. If a query contains
+    # an exact match of a query, then one or more specific documents are
+    # featured in the search results.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index used for featuring results.
+    #
+    # @option params [required, String] :featured_results_set_id
+    #   The identifier of the set of featured results that you want to update.
+    #
+    # @option params [String] :featured_results_set_name
+    #   A new name for the set of featured results.
+    #
+    # @option params [String] :description
+    #   A new description for the set of featured results.
+    #
+    # @option params [String] :status
+    #   You can set the status to `ACTIVE` or `INACTIVE`. When the value is
+    #   `ACTIVE`, featured results are ready for use. You can still configure
+    #   your settings before setting the status to `ACTIVE`. The queries you
+    #   specify for featured results must be unique per featured results set
+    #   for each index, whether the status is `ACTIVE` or `INACTIVE`.
+    #
+    # @option params [Array<String>] :query_texts
+    #   A list of queries for featuring results. For more information on the
+    #   list of queries, see [FeaturedResultsSet][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html
+    #
+    # @option params [Array<Types::FeaturedDocument>] :featured_documents
+    #   A list of document IDs for the documents you want to feature at the
+    #   top of the search results page. For more information on the list of
+    #   featured documents, see [FeaturedResultsSet][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html
+    #
+    # @return [Types::UpdateFeaturedResultsSetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateFeaturedResultsSetResponse#featured_results_set #featured_results_set} => Types::FeaturedResultsSet
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_featured_results_set({
+    #     index_id: "IndexId", # required
+    #     featured_results_set_id: "FeaturedResultsSetId", # required
+    #     featured_results_set_name: "FeaturedResultsSetName",
+    #     description: "FeaturedResultsSetDescription",
+    #     status: "ACTIVE", # accepts ACTIVE, INACTIVE
+    #     query_texts: ["QueryText"],
+    #     featured_documents: [
+    #       {
+    #         id: "DocumentId",
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.featured_results_set.featured_results_set_id #=> String
+    #   resp.featured_results_set.featured_results_set_name #=> String
+    #   resp.featured_results_set.description #=> String
+    #   resp.featured_results_set.status #=> String, one of "ACTIVE", "INACTIVE"
+    #   resp.featured_results_set.query_texts #=> Array
+    #   resp.featured_results_set.query_texts[0] #=> String
+    #   resp.featured_results_set.featured_documents #=> Array
+    #   resp.featured_results_set.featured_documents[0].id #=> String
+    #   resp.featured_results_set.last_updated_timestamp #=> Integer
+    #   resp.featured_results_set.creation_timestamp #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/UpdateFeaturedResultsSet AWS API Documentation
+    #
+    # @overload update_featured_results_set(params = {})
+    # @param [Hash] params ({})
+    def update_featured_results_set(params = {}, options = {})
+      req = build_request(:update_featured_results_set, params)
+      req.send_request(options)
+    end
+
     # Updates an existing Amazon Kendra index.
     #
     # @option params [required, String] :id
@@ -6263,8 +6772,8 @@ module Aws::Kendra
     # Amazon Kendra supports partial updates, so you only need to provide
     # the fields you want to update.
     #
-    # If an update is currently processing (i.e. 'happening'), you need to
-    # wait for the update to finish before making another update.
+    # If an update is currently processing, you need to wait for the update
+    # to finish before making another update.
     #
     # Updates to query suggestions settings might not take effect right
     # away. The time for your updated settings to take effect depends on the
@@ -6332,6 +6841,10 @@ module Aws::Kendra
     #
     #   How you tune this setting depends on your specific needs.
     #
+    # @option params [Types::AttributeSuggestionsUpdateConfig] :attribute_suggestions_config
+    #   Configuration information for the document fields/attributes that you
+    #   want to base query suggestions on.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -6343,6 +6856,15 @@ module Aws::Kendra
     #     include_queries_without_user_information: false,
     #     minimum_number_of_querying_users: 1,
     #     minimum_query_count: 1,
+    #     attribute_suggestions_config: {
+    #       suggestable_config_list: [
+    #         {
+    #           attribute_name: "DocumentAttributeKey",
+    #           suggestable: false,
+    #         },
+    #       ],
+    #       attribute_suggestions_mode: "ACTIVE", # accepts ACTIVE, INACTIVE
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/UpdateQuerySuggestionsConfig AWS API Documentation
@@ -6413,7 +6935,7 @@ module Aws::Kendra
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kendra'
-      context[:gem_version] = '1.63.0'
+      context[:gem_version] = '1.65.0'
       Seahorse::Client::Request.new(handlers, context)
     end