aws-sdk-kendra 1.20.0 → 1.25.0

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -61,7 +61,7 @@ module Aws::Kendra
     #   A list of groups, separated by semi-colons, that filters a query
     #   response based on user context. The document is only returned to
     #   users that are in one of the groups specified in the `UserContext`
-    #   field of the Query operation.
+    #   field of the `Query` operation.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/AclConfiguration AWS API Documentation
@@ -500,7 +500,7 @@ module Aws::Kendra
     #         document_id_list: ["DocumentId"], # required
     #         data_source_sync_job_metric_target: {
     #           data_source_id: "DataSourceId", # required
-    #           data_source_sync_job_id: "DataSourceSyncJobId", # required
+    #           data_source_sync_job_id: "DataSourceSyncJobId",
     #         },
     #       }
     #
@@ -541,7 +541,7 @@ module Aws::Kendra
     end
 
     # Provides information about documents that could not be removed from an
-    # index by the BatchDeleteDocument operation.
+    # index by the `BatchDeleteDocument` operation.
     #
     # @!attribute [rw] id
     #   The identifier of the document that couldn't be removed from the
@@ -608,7 +608,7 @@ module Aws::Kendra
     #
     # @!attribute [rw] index_id
     #   The identifier of the index to add the documents to. You need to
-    #   create the index first using the CreateIndex operation.
+    #   create the index first using the `CreateIndex` operation.
     #   @return [String]
     #
     # @!attribute [rw] role_arn
@@ -624,6 +624,13 @@ module Aws::Kendra
     # @!attribute [rw] documents
     #   One or more documents to add to the index.
     #
+    #   Documents can include custom attributes. For example,
+    #   'DataSourceId' and 'DataSourceSyncJobId' are custom attributes
+    #   that provide information on the synchronization of documents running
+    #   on a data source. Note, 'DataSourceSyncJobId' could be an optional
+    #   custom attribute as Amazon Kendra will use the ID of a running sync
+    #   job.
+    #
     #   Documents have the following file size limits.
     #
     #   * 5 MB total size for inline documents
@@ -728,8 +735,28 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ClearQuerySuggestionsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_id: "IndexId", # required
+    #       }
+    #
+    # @!attribute [rw] index_id
+    #   The identifier of the index you want to clear query suggestions
+    #   from.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ClearQuerySuggestionsRequest AWS API Documentation
+    #
+    class ClearQuerySuggestionsRequest < Struct.new(
+      :index_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Gathers information about when a particular result was clicked by a
-    # user. Your application uses the SubmitFeedback operation to provide
+    # user. Your application uses the `SubmitFeedback` operation to provide
     # click information.
     #
     # @note When making an API call, you may pass ClickFeedback
@@ -792,7 +819,7 @@ module Aws::Kendra
     # @!attribute [rw] field_mappings
     #   An array of objects that map database column names to the
     #   corresponding fields in an index. You must first create the fields
-    #   in the index using the UpdateIndex operation.
+    #   in the index using the `UpdateIndex` operation.
     #   @return [Array<Types::DataSourceToIndexFieldMapping>]
     #
     # @!attribute [rw] change_detecting_columns
@@ -868,7 +895,8 @@ module Aws::Kendra
     # Defines the mapping between a field in the Confluence data source to a
     # Amazon Kendra index field.
     #
-    # You must first create the index field using the operation.
+    # You must first create the index field using the `UpdateIndex`
+    # operation.
     #
     # @note When making an API call, you may pass ConfluenceAttachmentToIndexFieldMapping
     #   data as a hash:
@@ -882,7 +910,8 @@ module Aws::Kendra
     # @!attribute [rw] data_source_field_name
     #   The name of the field in the data source.
     #
-    #   You must first create the index field using the operation.
+    #   You must first create the index field using the `UpdateIndex`
+    #   operation.
     #   @return [String]
     #
     # @!attribute [rw] date_field_format
@@ -909,7 +938,8 @@ module Aws::Kendra
 
     # Specifies the blog settings for the Confluence data source. Blogs are
     # always indexed unless filtered from the index by the
-    # `ExclusionPatterns` or `InclusionPatterns` fields in the data type.
+    # `ExclusionPatterns` or `InclusionPatterns` fields in the
+    # `ConfluenceConfiguration` type.
     #
     # @note When making an API call, you may pass ConfluenceBlogConfiguration
     #   data as a hash:
@@ -945,7 +975,8 @@ module Aws::Kendra
     # Defines the mapping between a blog field in the Confluence data source
     # to a Amazon Kendra index field.
     #
-    # You must first create the index field using the operation.
+    # You must first create the index field using the `UpdateIndex`
+    # operation.
     #
     # @note When making an API call, you may pass ConfluenceBlogToIndexFieldMapping
     #   data as a hash:
@@ -1158,7 +1189,8 @@ module Aws::Kendra
     # Defines the mapping between a field in the Confluence data source to a
     # Amazon Kendra index field.
     #
-    # You must first create the index field using the operation.
+    # You must first create the index field using the `UpdateIndex`
+    # operation.
     #
     # @note When making an API call, you may pass ConfluencePageToIndexFieldMapping
     #   data as a hash:
@@ -1271,7 +1303,8 @@ module Aws::Kendra
     # Defines the mapping between a field in the Confluence data source to a
     # Amazon Kendra index field.
     #
-    # You must first create the index field using the operation.
+    # You must first create the index field using the `UpdateIndex`
+    # operation.
     #
     # @note When making an API call, you may pass ConfluenceSpaceToIndexFieldMapping
     #   data as a hash:
@@ -1547,6 +1580,7 @@ module Aws::Kendra
     #                   index_field_name: "IndexFieldName", # required
     #                 },
     #               ],
+    #               filter_query: "ServiceNowKnowledgeArticleFilterQuery",
     #             },
     #             service_catalog_configuration: {
     #               crawl_attachments: false,
@@ -1562,6 +1596,7 @@ module Aws::Kendra
     #                 },
     #               ],
     #             },
+    #             authentication_type: "HTTP_BASIC", # accepts HTTP_BASIC, OAUTH2
     #           },
     #           confluence_configuration: {
     #             server_url: "Url", # required
@@ -1983,6 +2018,110 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass CreateQuerySuggestionsBlockListRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_id: "IndexId", # required
+    #         name: "QuerySuggestionsBlockListName", # required
+    #         description: "Description",
+    #         source_s3_path: { # required
+    #           bucket: "S3BucketName", # required
+    #           key: "S3ObjectKey", # required
+    #         },
+    #         client_token: "ClientTokenName",
+    #         role_arn: "RoleArn", # required
+    #         tags: [
+    #           {
+    #             key: "TagKey", # required
+    #             value: "TagValue", # required
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] index_id
+    #   The identifier of the index you want to create a query suggestions
+    #   block list for.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   A user friendly name for the block list.
+    #
+    #   For example, the block list named 'offensive-words' includes all
+    #   offensive words that could appear in user queries and need to be
+    #   blocked from suggestions.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   A user-friendly 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."
+    #   @return [String]
+    #
+    # @!attribute [rw] source_s3_path
+    #   The S3 path to your block list text file in your S3 bucket.
+    #
+    #   Each block word or phrase should be on a separate line in a text
+    #   file.
+    #
+    #   For information on the current quota limits for block lists, see
+    #   [Quotas for Amazon Kendra][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/quotas.html
+    #   @return [Types::S3Path]
+    #
+    # @!attribute [rw] client_token
+    #   A token that you provide to identify the request to create a query
+    #   suggestions block list.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @!attribute [rw] role_arn
+    #   The IAM (Identity and Access Management) role used by Amazon Kendra
+    #   to access the block list text file in your S3 bucket.
+    #
+    #   You need permissions to the role ARN (Amazon 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.
+    #   @return [String]
+    #
+    # @!attribute [rw] tags
+    #   A tag that you can assign to a block list that categorizes the block
+    #   list.
+    #   @return [Array<Types::Tag>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/CreateQuerySuggestionsBlockListRequest AWS API Documentation
+    #
+    class CreateQuerySuggestionsBlockListRequest < Struct.new(
+      :index_id,
+      :name,
+      :description,
+      :source_s3_path,
+      :client_token,
+      :role_arn,
+      :tags)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] id
+    #   The unique identifier of the created block list.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/CreateQuerySuggestionsBlockListResponse AWS API Documentation
+    #
+    class CreateQuerySuggestionsBlockListResponse < Struct.new(
+      :id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass CreateThesaurusRequest
     #   data as a hash:
     #
@@ -2249,6 +2388,7 @@ module Aws::Kendra
     #                 index_field_name: "IndexFieldName", # required
     #               },
     #             ],
+    #             filter_query: "ServiceNowKnowledgeArticleFilterQuery",
     #           },
     #           service_catalog_configuration: {
     #             crawl_attachments: false,
@@ -2264,6 +2404,7 @@ module Aws::Kendra
     #               },
     #             ],
     #           },
+    #           authentication_type: "HTTP_BASIC", # accepts HTTP_BASIC, OAUTH2
     #         },
     #         confluence_configuration: {
     #           server_url: "Url", # required
@@ -2390,7 +2531,7 @@ module Aws::Kendra
     end
 
     # Summary information for a Amazon Kendra data source. Returned in a
-    # call to .
+    # call to the `DescribeDataSource` operation.
     #
     # @!attribute [rw] name
     #   The name of the data source.
@@ -2413,7 +2554,7 @@ module Aws::Kendra
     #   @return [Time]
     #
     # @!attribute [rw] status
-    #   The status of the data source. When the status is `ATIVE` the data
+    #   The status of the data source. When the status is `ACTIVE` the data
     #   source is ready to use.
     #   @return [String]
     #
@@ -2496,7 +2637,7 @@ module Aws::Kendra
     #
     #       {
     #         data_source_id: "DataSourceId", # required
-    #         data_source_sync_job_id: "DataSourceSyncJobId", # required
+    #         data_source_sync_job_id: "DataSourceSyncJobId",
     #       }
     #
     # @!attribute [rw] data_source_id
@@ -2505,6 +2646,15 @@ module Aws::Kendra
     #
     # @!attribute [rw] data_source_sync_job_id
     #   The ID of the sync job that is running on the data source.
+    #
+    #   If the ID of a sync job is not provided and there is a sync job
+    #   running, then the ID of this sync job is used and metrics are
+    #   generated for this sync job.
+    #
+    #   If the ID of a sync job is not provided and there is no sync job
+    #   running, then no metrics are generated and documents are
+    #   indexed/deleted at the index level without sync job metrics
+    #   included.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DataSourceSyncJobMetricTarget AWS API Documentation
@@ -2558,7 +2708,7 @@ module Aws::Kendra
     end
 
     # Maps a column or attribute in the data source to an index field. You
-    # must first create the fields in the index using the UpdateIndex
+    # must first create the fields in the index using the `UpdateIndex`
     # operation.
     #
     # @note When making an API call, you may pass DataSourceToIndexFieldMapping
@@ -2771,6 +2921,31 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DeleteQuerySuggestionsBlockListRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_id: "IndexId", # required
+    #         id: "QuerySuggestionsBlockListId", # required
+    #       }
+    #
+    # @!attribute [rw] index_id
+    #   The identifier of the you want to delete a block list from.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   The unique identifier of the block list that needs to be deleted.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DeleteQuerySuggestionsBlockListRequest AWS API Documentation
+    #
+    class DeleteQuerySuggestionsBlockListRequest < Struct.new(
+      :index_id,
+      :id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DeleteThesaurusRequest
     #   data as a hash:
     #
@@ -3062,7 +3237,7 @@ module Aws::Kendra
     #   @return [String]
     #
     # @!attribute [rw] capacity_units
-    #   For enterprise edtion indexes, you can choose to use additional
+    #   For Enterprise edition indexes, you can choose to use additional
     #   capacity to meet the needs of your application. This contains the
     #   capacity units used for the index. A 0 for the query capacity or the
     #   storage capacity indicates that the index is using the default
@@ -3099,6 +3274,218 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribeQuerySuggestionsBlockListRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_id: "IndexId", # required
+    #         id: "QuerySuggestionsBlockListId", # required
+    #       }
+    #
+    # @!attribute [rw] index_id
+    #   The identifier of the index for the block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   The unique identifier of the block list.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeQuerySuggestionsBlockListRequest AWS API Documentation
+    #
+    class DescribeQuerySuggestionsBlockListRequest < Struct.new(
+      :index_id,
+      :id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] index_id
+    #   Shows the identifier of the index for the block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   Shows the unique identifier of the block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   Shows the name of the block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   Shows the description for the block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   Shows whether the current status of the block list is `ACTIVE` or
+    #   `INACTIVE`.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_message
+    #   Shows the error message with details when there are issues in
+    #   processing the block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] created_at
+    #   Shows the date-time a block list for query suggestions was last
+    #   created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] updated_at
+    #   Shows the date-time a block list for query suggestions was last
+    #   updated.
+    #   @return [Time]
+    #
+    # @!attribute [rw] source_s3_path
+    #   Shows the current S3 path to your block list text file in your S3
+    #   bucket.
+    #
+    #   Each block word or phrase should be on a separate line in a text
+    #   file.
+    #
+    #   For information on the current quota limits for block lists, see
+    #   [Quotas for Amazon Kendra][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/quotas.html
+    #   @return [Types::S3Path]
+    #
+    # @!attribute [rw] item_count
+    #   Shows the current number of valid, non-empty words or phrases in the
+    #   block list text file.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] file_size_bytes
+    #   Shows the current size of the block list text file in S3.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] role_arn
+    #   Shows the current IAM (Identity and Access Management) role used by
+    #   Amazon Kendra to access the block list text file in S3.
+    #
+    #   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.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeQuerySuggestionsBlockListResponse AWS API Documentation
+    #
+    class DescribeQuerySuggestionsBlockListResponse < Struct.new(
+      :index_id,
+      :id,
+      :name,
+      :description,
+      :status,
+      :error_message,
+      :created_at,
+      :updated_at,
+      :source_s3_path,
+      :item_count,
+      :file_size_bytes,
+      :role_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass DescribeQuerySuggestionsConfigRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_id: "IndexId", # required
+    #       }
+    #
+    # @!attribute [rw] index_id
+    #   The identifier of the index you want to describe query suggestions
+    #   settings for.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeQuerySuggestionsConfigRequest AWS API Documentation
+    #
+    class DescribeQuerySuggestionsConfigRequest < Struct.new(
+      :index_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] mode
+    #   Shows whether query suggestions are currently in `ENABLED` mode or
+    #   `LEARN_ONLY` mode.
+    #
+    #   By default, Amazon Kendra enables query suggestions.`LEARN_ONLY`
+    #   turns off query suggestions for your users. You can change the mode
+    #   using the [UpdateQuerySuggestionsConfig][1] operation.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_UpdateQuerySuggestionsConfig.html
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   Shows whether the status of query suggestions settings is currently
+    #   Active or Updating.
+    #
+    #   Active means the current settings apply and Updating means your
+    #   changed settings are in the process of applying.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_log_look_back_window_in_days
+    #   Shows how recent your queries are in your query log time window (in
+    #   days).
+    #   @return [Integer]
+    #
+    # @!attribute [rw] include_queries_without_user_information
+    #   Shows whether Amazon Kendra uses all queries or only uses queries
+    #   that include user information to generate query suggestions.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] minimum_number_of_querying_users
+    #   Shows the minimum number of unique users who must search a query in
+    #   order for the query to be eligible to suggest to your users.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] minimum_query_count
+    #   Shows the minimum number of times a query must be searched in order
+    #   for the query to be eligible to suggest to your users.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] last_suggestions_build_time
+    #   Shows the date-time query suggestions for an index was last updated.
+    #   @return [Time]
+    #
+    # @!attribute [rw] last_clear_time
+    #   Shows the date-time query suggestions for an index was last cleared.
+    #
+    #   After you clear suggestions, Amazon Kendra learns new suggestions
+    #   based on new queries added to the query log from the time you
+    #   cleared suggestions. Amazon Kendra only considers re-occurences of a
+    #   query from the time you cleared suggestions.
+    #   @return [Time]
+    #
+    # @!attribute [rw] total_suggestions_count
+    #   Shows the current total count of query suggestions for an index.
+    #
+    #   This count can change when you update your query suggestions
+    #   settings, if you filter out certain queries from suggestions using a
+    #   block list, and as the query log accumulates more queries for Amazon
+    #   Kendra to learn from.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeQuerySuggestionsConfigResponse AWS API Documentation
+    #
+    class DescribeQuerySuggestionsConfigResponse < Struct.new(
+      :mode,
+      :status,
+      :query_log_look_back_window_in_days,
+      :include_queries_without_user_information,
+      :minimum_number_of_querying_users,
+      :minimum_query_count,
+      :last_suggestions_build_time,
+      :last_clear_time,
+      :total_suggestions_count)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeThesaurusRequest
     #   data as a hash:
     #
@@ -3439,19 +3826,58 @@ module Aws::Kendra
       include Aws::Structure
     end
 
-    # Document metadata files that contain information such as the document
-    # access control information, source URI, document author, and custom
-    # attributes. Each metadata file contains metadata about a single
-    # document.
+    # Overrides the document relevance properties of a custom index field.
     #
-    # @note When making an API call, you may pass DocumentsMetadataConfiguration
+    # @note When making an API call, you may pass DocumentRelevanceConfiguration
     #   data as a hash:
     #
     #       {
-    #         s3_prefix: "S3ObjectKey",
+    #         name: "DocumentMetadataConfigurationName", # required
+    #         relevance: { # required
+    #           freshness: false,
+    #           importance: 1,
+    #           duration: "Duration",
+    #           rank_order: "ASCENDING", # accepts ASCENDING, DESCENDING
+    #           value_importance_map: {
+    #             "ValueImportanceMapKey" => 1,
+    #           },
+    #         },
     #       }
     #
-    # @!attribute [rw] s3_prefix
+    # @!attribute [rw] name
+    #   The name of the tuning configuration to override document relevance
+    #   at the index level.
+    #   @return [String]
+    #
+    # @!attribute [rw] relevance
+    #   Provides information for manually tuning the relevance of a field in
+    #   a search. When a query includes terms that match the field, the
+    #   results are given a boost in the response based on these tuning
+    #   parameters.
+    #   @return [Types::Relevance]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DocumentRelevanceConfiguration AWS API Documentation
+    #
+    class DocumentRelevanceConfiguration < Struct.new(
+      :name,
+      :relevance)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Document metadata files that contain information such as the document
+    # access control information, source URI, document author, and custom
+    # attributes. Each metadata file contains metadata about a single
+    # document.
+    #
+    # @note When making an API call, you may pass DocumentsMetadataConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         s3_prefix: "S3ObjectKey",
+    #       }
+    #
+    # @!attribute [rw] s3_prefix
     #   A prefix used to filter metadata configuration files in the AWS S3
     #   bucket. The S3 bucket might contain multiple metadata files. Use
     #   `S3Prefix` to include only the desired metadata files.
@@ -3572,6 +3998,63 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetQuerySuggestionsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_id: "IndexId", # required
+    #         query_text: "SuggestionQueryText", # required
+    #         max_suggestions_count: 1,
+    #       }
+    #
+    # @!attribute [rw] index_id
+    #   The identifier of the index you want to get query suggestions from.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_text
+    #   The text of a user's query to generate query suggestions.
+    #
+    #   A query is suggested if the query prefix matches what a user starts
+    #   to type as their query.
+    #
+    #   Amazon Kendra does not show any suggestions if a user types fewer
+    #   than two characters or more than 60 characters. A query must also
+    #   have at least one search result and contain at least one word of
+    #   more than four characters.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_suggestions_count
+    #   The maximum number of query suggestions you want to show to your
+    #   users.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/GetQuerySuggestionsRequest AWS API Documentation
+    #
+    class GetQuerySuggestionsRequest < Struct.new(
+      :index_id,
+      :query_text,
+      :max_suggestions_count)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] query_suggestions_id
+    #   The unique identifier for a list of query suggestions for an index.
+    #   @return [String]
+    #
+    # @!attribute [rw] suggestions
+    #   A list of query suggestions for an index.
+    #   @return [Array<Types::Suggestion>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/GetQuerySuggestionsResponse AWS API Documentation
+    #
+    class GetQuerySuggestionsResponse < Struct.new(
+      :query_suggestions_id,
+      :suggestions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides configuration information for data sources that connect to
     # Google Drive.
     #
@@ -3629,7 +4112,7 @@ module Aws::Kendra
     #
     #   If you are using the console, you can define index fields when
     #   creating the mapping. If you are using the API, you must first
-    #   create the field using the UpdateIndex operation.
+    #   create the field using the `UpdateIndex` operation.
     #   @return [Array<Types::DataSourceToIndexFieldMapping>]
     #
     # @!attribute [rw] exclude_mime_types
@@ -4096,6 +4579,78 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListQuerySuggestionsBlockListsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_id: "IndexId", # required
+    #         next_token: "NextToken",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] index_id
+    #   The identifier of the index for a list of all block lists that exist
+    #   for that index.
+    #
+    #   For information on the current quota limits for block lists, see
+    #   [Quotas for Amazon Kendra][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/quotas.html
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   If the previous response was incomplete (because there is more data
+    #   to retrieve), Amazon Kendra returns a pagination token in the
+    #   response. You can use this pagination token to retrieve the next set
+    #   of block lists (`BlockListSummaryItems`).
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of block lists to return.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ListQuerySuggestionsBlockListsRequest AWS API Documentation
+    #
+    class ListQuerySuggestionsBlockListsRequest < Struct.new(
+      :index_id,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] block_list_summary_items
+    #   Summary items for a block list.
+    #
+    #   This includes summary items on the block list ID, block list name,
+    #   when the block list was created, when the block list was last
+    #   updated, and the count of block words/phrases in the block list.
+    #
+    #   For information on the current quota limits for block lists, see
+    #   [Quotas for Amazon Kendra][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/quotas.html
+    #   @return [Array<Types::QuerySuggestionsBlockListSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   If the response is truncated, Amazon Kendra returns this token that
+    #   you can use in the subsequent request to retrieve the next set of
+    #   block lists.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ListQuerySuggestionsBlockListsResponse AWS API Documentation
+    #
+    class ListQuerySuggestionsBlockListsResponse < Struct.new(
+      :block_list_summary_items,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListTagsForResourceRequest
     #   data as a hash:
     #
@@ -4427,6 +4982,20 @@ module Aws::Kendra
     #         ],
     #         requested_document_attributes: ["DocumentAttributeKey"],
     #         query_result_type_filter: "DOCUMENT", # accepts DOCUMENT, QUESTION_ANSWER, ANSWER
+    #         document_relevance_override_configurations: [
+    #           {
+    #             name: "DocumentMetadataConfigurationName", # required
+    #             relevance: { # required
+    #               freshness: false,
+    #               importance: 1,
+    #               duration: "Duration",
+    #               rank_order: "ASCENDING", # accepts ASCENDING, DESCENDING
+    #               value_importance_map: {
+    #                 "ValueImportanceMapKey" => 1,
+    #               },
+    #             },
+    #           },
+    #         ],
     #         page_number: 1,
     #         page_size: 1,
     #         sorting_configuration: {
@@ -4441,7 +5010,7 @@ module Aws::Kendra
     #
     # @!attribute [rw] index_id
     #   The unique identifier of the index to search. The identifier is
-    #   returned in the response from the operation.
+    #   returned in the response from the `CreateIndex` operation.
     #   @return [String]
     #
     # @!attribute [rw] query_text
@@ -4476,6 +5045,25 @@ module Aws::Kendra
     #   are returned.
     #   @return [String]
     #
+    # @!attribute [rw] document_relevance_override_configurations
+    #   Overrides relevance tuning configurations of fields or attributes
+    #   set at the index level.
+    #
+    #   If you use this API to override the relevance tuning configured at
+    #   the index level, but there is no relevance tuning configured at the
+    #   index level, then Amazon Kendra does not apply any relevance tuning.
+    #
+    #   If there is relevance tuning configured at the index level, but you
+    #   do not use this API to override any relevance tuning in the index,
+    #   then Amazon Kendra uses the relevance tuning that is configured at
+    #   the index level.
+    #
+    #   If there is relevance tuning configured for fields at the index
+    #   level, but you use this API to override only some of these fields,
+    #   then for the fields you did not override, the importance is set to
+    #   1.
+    #   @return [Array<Types::DocumentRelevanceConfiguration>]
+    #
     # @!attribute [rw] page_number
     #   Query results are returned in pages the size of the `PageSize`
     #   parameter. By default, Amazon Kendra returns the first page of
@@ -4520,6 +5108,7 @@ module Aws::Kendra
       :facets,
       :requested_document_attributes,
       :query_result_type_filter,
+      :document_relevance_override_configurations,
       :page_number,
       :page_size,
       :sorting_configuration,
@@ -4643,6 +5232,57 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # Summary information on a query suggestions block list.
+    #
+    # This includes information on the block list ID, block list name, when
+    # the block list was created, when the block list was last updated, and
+    # the count of block words/phrases in the block list.
+    #
+    # For information on the current quota limits for block lists, see
+    # [Quotas for Amazon Kendra][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/kendra/latest/dg/quotas.html
+    #
+    # @!attribute [rw] id
+    #   The identifier of a block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The status of the block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] created_at
+    #   The date-time summary information for a query suggestions block list
+    #   was last created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] updated_at
+    #   The date-time the block list was last updated.
+    #   @return [Time]
+    #
+    # @!attribute [rw] item_count
+    #   The number of items in the block list file.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/QuerySuggestionsBlockListSummary AWS API Documentation
+    #
+    class QuerySuggestionsBlockListSummary < Struct.new(
+      :id,
+      :name,
+      :status,
+      :created_at,
+      :updated_at,
+      :item_count)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides information for manually tuning the relevance of a field in a
     # search. When a query includes terms that match the field, the results
     # are given a boost in the response based on these tuning parameters.
@@ -4727,7 +5367,7 @@ module Aws::Kendra
     end
 
     # Provides feedback on how relevant a document is to a search. Your
-    # application uses the SubmitFeedback operation to provide relevance
+    # application uses the `SubmitFeedback` operation to provide relevance
     # information.
     #
     # @note When making an API call, you may pass RelevanceFeedback
@@ -4833,12 +5473,21 @@ module Aws::Kendra
     #   document that matches an inclusion pattern also matches an exclusion
     #   pattern, the document is not indexed.
     #
-    #   For more information about glob patterns, see [glob
-    #   (programming)][1] in *Wikipedia*.
+    #   Some [examples][1] are:
     #
+    #   * **.txt* will include all text files in a directory (files with
+    #     the extension .txt).
     #
+    #   * ***/*.txt* will include all text files in a directory and its
+    #     subdirectories.
     #
-    #   [1]: https://en.wikipedia.org/wiki/Glob_(programming)
+    #   * **tax** will include all files in a directory that contain
+    #     'tax' in the file name, such as 'tax', 'taxes',
+    #     'income\_tax'.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/cli/latest/reference/s3/#use-of-exclude-and-include-filters
     #   @return [Array<String>]
     #
     # @!attribute [rw] exclusion_patterns
@@ -4846,12 +5495,21 @@ module Aws::Kendra
     #   a document that matches an inclusion prefix or inclusion pattern
     #   also matches an exclusion pattern, the document is not indexed.
     #
-    #   For more information about glob patterns, see [glob
-    #   (programming)][1] in *Wikipedia*.
+    #   Some [examples][1] are:
+    #
+    #   * **.png , *.jpg* will exclude all PNG and JPEG image files in a
+    #     directory (files with the extensions .png and .jpg).
+    #
+    #   * **internal** will exclude all files in a directory that contain
+    #     'internal' in the file name, such as 'internal',
+    #     'internal\_only', 'company\_internal'.
     #
+    #   * ***/*internal** will exclude all internal-related files in a
+    #     directory and its subdirectories.
     #
     #
-    #   [1]: https://en.wikipedia.org/wiki/Glob_(programming)
+    #
+    #   [1]: https://docs.aws.amazon.com/cli/latest/reference/s3/#use-of-exclude-and-include-filters
     #   @return [Array<String>]
     #
     # @!attribute [rw] documents_metadata_configuration
@@ -4938,7 +5596,7 @@ module Aws::Kendra
     # @!attribute [rw] document_title_field_name
     #   The name of the column in the Salesforce FeedItem table that
     #   contains the title of the document. This is typically the `Title`
-    #   collumn.
+    #   column.
     #   @return [String]
     #
     # @!attribute [rw] field_mappings
@@ -5078,7 +5736,7 @@ module Aws::Kendra
     #   @return [Array<Types::SalesforceStandardObjectConfiguration>]
     #
     # @!attribute [rw] knowledge_article_configuration
-    #   Specifies configuration information for the knowlege article types
+    #   Specifies configuration information for the knowledge article types
     #   that Amazon Kendra indexes. Amazon Kendra indexes standard knowledge
     #   articles and the standard fields of knowledge articles, or the
     #   custom fields of custom knowledge articles, but not both.
@@ -5183,7 +5841,7 @@ module Aws::Kendra
       include Aws::Structure
     end
 
-    # Specifies configuration information for the knowlege article types
+    # Specifies configuration information for the knowledge article types
     # that Amazon Kendra indexes. Amazon Kendra indexes standard knowledge
     # articles and the standard fields of knowledge articles, or the custom
     # fields of custom knowledge articles, but not both
@@ -5323,7 +5981,7 @@ module Aws::Kendra
       include Aws::Structure
     end
 
-    # Specifies confguration information for indexing a single standard
+    # Specifies configuration information for indexing a single standard
     # object.
     #
     # @note When making an API call, you may pass SalesforceStandardObjectConfiguration
@@ -5353,7 +6011,7 @@ module Aws::Kendra
     #
     # @!attribute [rw] document_title_field_name
     #   The name of the field in the standard object table that contains the
-    #   document titleB.
+    #   document title.
     #   @return [String]
     #
     # @!attribute [rw] field_mappings
@@ -5485,6 +6143,7 @@ module Aws::Kendra
     #               index_field_name: "IndexFieldName", # required
     #             },
     #           ],
+    #           filter_query: "ServiceNowKnowledgeArticleFilterQuery",
     #         },
     #         service_catalog_configuration: {
     #           crawl_attachments: false,
@@ -5500,6 +6159,7 @@ module Aws::Kendra
     #             },
     #           ],
     #         },
+    #         authentication_type: "HTTP_BASIC", # accepts HTTP_BASIC, OAUTH2
     #       }
     #
     # @!attribute [rw] host_url
@@ -5529,6 +6189,25 @@ module Aws::Kendra
     #   the ServiceNow site.
     #   @return [Types::ServiceNowServiceCatalogConfiguration]
     #
+    # @!attribute [rw] authentication_type
+    #   Determines the type of authentication used to connect to the
+    #   ServiceNow instance. If you choose `HTTP_BASIC`, Amazon Kendra is
+    #   authenticated using the user name and password provided in the AWS
+    #   Secrets Manager secret in the `SecretArn` field. When you choose
+    #   `OAUTH2`, Amazon Kendra is authenticated using the OAuth token and
+    #   secret provided in the Secrets Manager secret, and the user name and
+    #   password are used to determine which information Amazon Kendra has
+    #   access to.
+    #
+    #   When you use `OAUTH2` authentication, you must generate a token and
+    #   a client secret using the ServiceNow console. For more information,
+    #   see [Using a ServiceNow data source][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/data-source-servicenow.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ServiceNowConfiguration AWS API Documentation
     #
     class ServiceNowConfiguration < Struct.new(
@@ -5536,7 +6215,8 @@ module Aws::Kendra
       :secret_arn,
       :service_now_build_version,
       :knowledge_article_configuration,
-      :service_catalog_configuration)
+      :service_catalog_configuration,
+      :authentication_type)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5560,6 +6240,7 @@ module Aws::Kendra
     #             index_field_name: "IndexFieldName", # required
     #           },
     #         ],
+    #         filter_query: "ServiceNowKnowledgeArticleFilterQuery",
     #       }
     #
     # @!attribute [rw] crawl_attachments
@@ -5594,6 +6275,20 @@ module Aws::Kendra
     #   You must create the index field before you map the field.
     #   @return [Array<Types::DataSourceToIndexFieldMapping>]
     #
+    # @!attribute [rw] filter_query
+    #   A query that selects the knowledge articles to index. The query can
+    #   return articles from multiple knowledge bases, and the knowledge
+    #   bases can be public or private.
+    #
+    #   The query string must be one generated by the ServiceNow console.
+    #   For more information, see [Specifying documents to index with a
+    #   query][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/servicenow-query.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ServiceNowKnowledgeArticleConfiguration AWS API Documentation
     #
     class ServiceNowKnowledgeArticleConfiguration < Struct.new(
@@ -5602,7 +6297,8 @@ module Aws::Kendra
       :exclude_attachment_file_patterns,
       :document_data_field_name,
       :document_title_field_name,
-      :field_mappings)
+      :field_mappings,
+      :filter_query)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5634,13 +6330,23 @@ module Aws::Kendra
     #   @return [Boolean]
     #
     # @!attribute [rw] include_attachment_file_patterns
-    #   Determines the types of file attachments that are included in the
-    #   index.
+    #   A list of regular expression patterns. Documents that match the
+    #   patterns are included in the index. Documents that don't match the
+    #   patterns are excluded from the index. If a document matches both an
+    #   exclusion pattern and an inclusion pattern, the document is not
+    #   included in the index.
+    #
+    #   The regex is applied to the file name of the attachment.
     #   @return [Array<String>]
     #
     # @!attribute [rw] exclude_attachment_file_patterns
-    #   Determines the types of file attachments that are excluded from the
-    #   index.
+    #   A list of regular expression patterns. Documents that match the
+    #   patterns are excluded from the index. Documents that don't match
+    #   the patterns are included in the index. If a document matches both
+    #   an exclusion pattern and an inclusion pattern, the document is not
+    #   included in the index.
+    #
+    #   The regex is applied to the file name of the attachment.
     #   @return [Array<String>]
     #
     # @!attribute [rw] document_data_field_name
@@ -5775,9 +6481,9 @@ module Aws::Kendra
     # @!attribute [rw] field_mappings
     #   A list of `DataSourceToIndexFieldMapping` objects that map Microsoft
     #   SharePoint attributes to custom fields in the Amazon Kendra index.
-    #   You must first create the index fields using the operation before
-    #   you map SharePoint attributes. For more information, see [Mapping
-    #   Data Source Fields][1].
+    #   You must first create the index fields using the `UpdateIndex`
+    #   operation before you map SharePoint attributes. For more
+    #   information, see [Mapping Data Source Fields][1].
     #
     #
     #
@@ -5995,7 +6701,8 @@ module Aws::Kendra
     #
     # @!attribute [rw] query_id
     #   The identifier of the specific query for which you are submitting
-    #   feedback. The query ID is returned in the response to the operation.
+    #   feedback. The query ID is returned in the response to the `Query`
+    #   operation.
     #   @return [String]
     #
     # @!attribute [rw] click_feedback_items
@@ -6019,6 +6726,86 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # A single query suggestion.
+    #
+    # @!attribute [rw] id
+    #   The unique UUID (universally unique identifier) of a single query
+    #   suggestion.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   The value for the unique UUID (universally unique identifier) of a
+    #   single query suggestion.
+    #
+    #   The value is the text string of a suggestion.
+    #   @return [Types::SuggestionValue]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/Suggestion AWS API Documentation
+    #
+    class Suggestion < Struct.new(
+      :id,
+      :value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The text highlights for a single query suggestion.
+    #
+    # @!attribute [rw] begin_offset
+    #   The zero-based location in the response string where the highlight
+    #   starts.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] end_offset
+    #   The zero-based location in the response string where the highlight
+    #   ends.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/SuggestionHighlight AWS API Documentation
+    #
+    class SuggestionHighlight < Struct.new(
+      :begin_offset,
+      :end_offset)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Provides text and information about where to highlight the query
+    # suggestion text.
+    #
+    # @!attribute [rw] text
+    #   The query suggestion text to display to the user.
+    #   @return [String]
+    #
+    # @!attribute [rw] highlights
+    #   The beginning and end of the query suggestion text that should be
+    #   highlighted.
+    #   @return [Array<Types::SuggestionHighlight>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/SuggestionTextWithHighlights AWS API Documentation
+    #
+    class SuggestionTextWithHighlights < Struct.new(
+      :text,
+      :highlights)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The `SuggestionTextWithHighlights` structure information.
+    #
+    # @!attribute [rw] text
+    #   The `SuggestionTextWithHighlights` structure that contains the query
+    #   suggestion text and highlights.
+    #   @return [Types::SuggestionTextWithHighlights]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/SuggestionValue AWS API Documentation
+    #
+    class SuggestionValue < Struct.new(
+      :text)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A list of key/value pairs that identify an index, FAQ, or data source.
     # Tag keys and values can consist of Unicode letters, digits, white
     # space, and any of the following symbols: \_ . : / = + - @.
@@ -6412,6 +7199,7 @@ module Aws::Kendra
     #                   index_field_name: "IndexFieldName", # required
     #                 },
     #               ],
+    #               filter_query: "ServiceNowKnowledgeArticleFilterQuery",
     #             },
     #             service_catalog_configuration: {
     #               crawl_attachments: false,
@@ -6427,6 +7215,7 @@ module Aws::Kendra
     #                 },
     #               ],
     #             },
+    #             authentication_type: "HTTP_BASIC", # accepts HTTP_BASIC, OAUTH2
     #           },
     #           confluence_configuration: {
     #             server_url: "Url", # required
@@ -6621,7 +7410,7 @@ module Aws::Kendra
     #   @return [Array<Types::DocumentMetadataConfiguration>]
     #
     # @!attribute [rw] capacity_units
-    #   Sets the number of addtional storage and query capacity units that
+    #   Sets the number of additional storage and query capacity units that
     #   should be used by the index. You can change the capacity of the
     #   index up to 5 times per day.
     #
@@ -6653,6 +7442,158 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass UpdateQuerySuggestionsBlockListRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_id: "IndexId", # required
+    #         id: "QuerySuggestionsBlockListId", # required
+    #         name: "QuerySuggestionsBlockListName",
+    #         description: "Description",
+    #         source_s3_path: {
+    #           bucket: "S3BucketName", # required
+    #           key: "S3ObjectKey", # required
+    #         },
+    #         role_arn: "RoleArn",
+    #       }
+    #
+    # @!attribute [rw] index_id
+    #   The identifier of the index for a block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   The unique identifier of a block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of a block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The description for a block list.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_s3_path
+    #   The S3 path where your block list text file sits in S3.
+    #
+    #   If you update your block list and provide the same path to the block
+    #   list text file in S3, then Amazon Kendra reloads the file to refresh
+    #   the block list. Amazon Kendra does not automatically refresh your
+    #   block list. You need to call the `UpdateQuerySuggestionsBlockList`
+    #   API to refresh you block list.
+    #
+    #   If you update your block list, then Amazon Kendra asynchronously
+    #   refreshes all query suggestions with the latest content in the S3
+    #   file. This means changes might not take effect immediately.
+    #   @return [Types::S3Path]
+    #
+    # @!attribute [rw] role_arn
+    #   The IAM (Identity and Access Management) role used to access the
+    #   block list text file in S3.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/UpdateQuerySuggestionsBlockListRequest AWS API Documentation
+    #
+    class UpdateQuerySuggestionsBlockListRequest < Struct.new(
+      :index_id,
+      :id,
+      :name,
+      :description,
+      :source_s3_path,
+      :role_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass UpdateQuerySuggestionsConfigRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_id: "IndexId", # required
+    #         mode: "ENABLED", # accepts ENABLED, LEARN_ONLY
+    #         query_log_look_back_window_in_days: 1,
+    #         include_queries_without_user_information: false,
+    #         minimum_number_of_querying_users: 1,
+    #         minimum_query_count: 1,
+    #       }
+    #
+    # @!attribute [rw] index_id
+    #   The identifier of the index you want to update query suggestions
+    #   settings for.
+    #   @return [String]
+    #
+    # @!attribute [rw] mode
+    #   Set the mode to `ENABLED` or `LEARN_ONLY`.
+    #
+    #   By default, Amazon Kendra enables query suggestions. `LEARN_ONLY`
+    #   mode allows you to turn off query suggestions. You can to update
+    #   this at any time.
+    #
+    #   In `LEARN_ONLY` mode, Amazon Kendra continues to learn from new
+    #   queries to keep suggestions up to date for when you are ready to
+    #   switch to ENABLED mode again.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_log_look_back_window_in_days
+    #   How recent your queries are in your query log time window.
+    #
+    #   The time window is the number of days from current day to past days.
+    #
+    #   By default, Amazon Kendra sets this to 180.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] include_queries_without_user_information
+    #   `TRUE` to include queries without user information (i.e. all
+    #   queries, irrespective of the user), otherwise `FALSE` to only
+    #   include queries with user information.
+    #
+    #   If you pass user information to Amazon Kendra along with the
+    #   queries, you can set this flag to `FALSE` and instruct Amazon Kendra
+    #   to only consider queries with user information.
+    #
+    #   If you set to `FALSE`, Amazon Kendra only considers queries searched
+    #   at least `MinimumQueryCount` times across
+    #   `MinimumNumberOfQueryingUsers` unique users for suggestions.
+    #
+    #   If you set to `TRUE`, Amazon Kendra ignores all user information and
+    #   learns from all queries.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] minimum_number_of_querying_users
+    #   The minimum number of unique users who must search a query in order
+    #   for the query to be eligible to suggest to your users.
+    #
+    #   Increasing this number might decrease the number of suggestions.
+    #   However, this ensures a query is searched by many users and is truly
+    #   popular to suggest to users.
+    #
+    #   How you tune this setting depends on your specific needs.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] minimum_query_count
+    #   The the minimum number of times a query must be searched in order to
+    #   be eligible to suggest to your users.
+    #
+    #   Decreasing this number increases the number of suggestions. However,
+    #   this affects the quality of suggestions as it sets a low bar for a
+    #   query to be considered popular to suggest to users.
+    #
+    #   How you tune this setting depends on your specific needs.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/UpdateQuerySuggestionsConfigRequest AWS API Documentation
+    #
+    class UpdateQuerySuggestionsConfigRequest < Struct.new(
+      :index_id,
+      :mode,
+      :query_log_look_back_window_in_days,
+      :include_queries_without_user_information,
+      :minimum_number_of_querying_users,
+      :minimum_query_count)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass UpdateThesaurusRequest
     #   data as a hash:
     #