aws-sdk-kendra 1.22.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a5b1f6f700a2e9457090c9fa3be05fa5d10d03b625362a763e92753103541a1a
-  data.tar.gz: 76b827d689a96cd3dc80034fd6aa8f64769528f296635ff1c9d3ec3e9c0ae665
+  metadata.gz: 18f9a0673af8278a3066d865646525130986d0d6fce53f4a84fc8b10efb26e21
+  data.tar.gz: 1b782bf81e35136fc3b2fd540bcc97821f38707b6159977a0e6243bc51b33253
 SHA512:
-  metadata.gz: c85b240608c91f2212faf2ce73460d686a779196751df375bb72e1094d603c9ff4947106744af7f45af010dc7831ca2d125911ae1be9dcd29fa5324c87014682
-  data.tar.gz: eb1adc711d6a4d8b3c3436b79b79652b75fea2dfa1da0632e36d0941a146f6b2c09ae7145b2cbea80c3a21fddc3ea68be697624d7d0139fae3f9b99874d656ef
+  metadata.gz: e91319bbb2301cbf8c9fb6900922854688faf4fac89b62c2ce9c5e1f5f36265e33cc3e5faa5dbfb581128c06ea406acc49be1b6c168c9920707b87aa28dffd72
+  data.tar.gz: ab38e61328b8e4b91f9354a2f23e74b98040d4477742ad86219cfc5de2c79e3ca36423574a13dbe2c6de1b5d45e1a36de594a36d8d9e29cd464a08a760986408

data/CHANGELOG.md

@@ -1,6 +1,31 @@
 Unreleased Changes
 ------------------
 
+1.27.0 (2021-06-17)
+------------------
+
+* Feature - Amazon Kendra now supports the indexing of web documents for search through the web crawler.
+
+1.26.0 (2021-06-09)
+------------------
+
+* Feature - AWS Kendra now supports checking document status.
+
+1.25.0 (2021-05-27)
+------------------
+
+* Feature - Amazon Kendra now suggests popular queries in order to help guide query typing and help overall accuracy.
+
+1.24.0 (2021-04-21)
+------------------
+
+* Feature - Amazon Kendra now enables users to override index-level boosting configurations for each query.
+
+1.23.0 (2021-04-01)
+------------------
+
+* Feature - AWS Kendra's ServiceNow data source now supports OAuth 2.0 authentication and knowledge article filtering via a ServiceNow query.
+
 1.22.0 (2021-03-10)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.22.0
+1.27.0

data/lib/aws-sdk-kendra.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-kendra/customizations'
 # @!group service
 module Aws::Kendra
 
-  GEM_VERSION = '1.22.0'
+  GEM_VERSION = '1.27.0'
 
 end

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

@@ -338,10 +338,10 @@ module Aws::Kendra
     # @!group API Operations
 
     # Removes one or more documents from an index. The documents must have
-    # been added with the BatchPutDocument operation.
+    # been added with the `BatchPutDocument` operation.
     #
     # The documents are deleted asynchronously. You can see the progress of
-    # the deletion by using AWS CloudWatch. Any error messages releated to
+    # the deletion by using AWS CloudWatch. Any error messages related to
     # the processing of the batch are sent to you CloudWatch log.
     #
     # @option params [required, String] :index_id
@@ -364,7 +364,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",
     #     },
     #   })
     #
@@ -384,6 +384,85 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Returns the indexing status for one or more documents submitted with
+    # the [ BatchPutDocument][1] operation.
+    #
+    # When you use the `BatchPutDocument` operation, documents are indexed
+    # asynchronously. You can use the `BatchGetDocumentStatus` operation to
+    # get the current status of a list of documents so that you can
+    # determine if they have been successfully indexed.
+    #
+    # You can also use the `BatchGetDocumentStatus` operation to check the
+    # status of the [ BatchDeleteDocument][2] operation. When a document is
+    # deleted from the index, Amazon Kendra returns `NOT_FOUND` as the
+    # status.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_BatchPutDocument.html
+    # [2]: https://docs.aws.amazon.com/kendra/latest/dg/API_BatchDeleteDocument.html
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index to add documents to. The index ID is
+    #   returned by the [ CreateIndex ][1] operation.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_CreateIndex.html
+    #
+    # @option params [required, Array<Types::DocumentInfo>] :document_info_list
+    #   A list of `DocumentInfo` objects that identify the documents for which
+    #   to get the status. You identify the documents by their document ID and
+    #   optional attributes.
+    #
+    # @return [Types::BatchGetDocumentStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::BatchGetDocumentStatusResponse#errors #errors} => Array&lt;Types::BatchGetDocumentStatusResponseError&gt;
+    #   * {Types::BatchGetDocumentStatusResponse#document_status_list #document_status_list} => Array&lt;Types::Status&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.batch_get_document_status({
+    #     index_id: "IndexId", # required
+    #     document_info_list: [ # required
+    #       {
+    #         document_id: "DocumentId", # required
+    #         attributes: [
+    #           {
+    #             key: "DocumentAttributeKey", # required
+    #             value: { # required
+    #               string_value: "DocumentAttributeStringValue",
+    #               string_list_value: ["String"],
+    #               long_value: 1,
+    #               date_value: Time.now,
+    #             },
+    #           },
+    #         ],
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.errors #=> Array
+    #   resp.errors[0].document_id #=> String
+    #   resp.errors[0].error_code #=> String, one of "InternalError", "InvalidRequest"
+    #   resp.errors[0].error_message #=> String
+    #   resp.document_status_list #=> Array
+    #   resp.document_status_list[0].document_id #=> String
+    #   resp.document_status_list[0].document_status #=> String, one of "NOT_FOUND", "PROCESSING", "INDEXED", "UPDATED", "FAILED", "UPDATE_FAILED"
+    #   resp.document_status_list[0].failure_code #=> String
+    #   resp.document_status_list[0].failure_reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/BatchGetDocumentStatus AWS API Documentation
+    #
+    # @overload batch_get_document_status(params = {})
+    # @param [Hash] params ({})
+    def batch_get_document_status(params = {}, options = {})
+      req = build_request(:batch_get_document_status, params)
+      req.send_request(options)
+    end
+
     # Adds one or more documents to an index.
     #
     # The `BatchPutDocument` operation enables you to ingest inline
@@ -398,7 +477,7 @@ module Aws::Kendra
     #
     # @option params [required, String] :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.
     #
     # @option params [String] :role_arn
     #   The Amazon Resource Name (ARN) of a role that is allowed to run the
@@ -412,6 +491,12 @@ module Aws::Kendra
     # @option params [required, Array<Types::Document>] :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
@@ -484,6 +569,34 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Clears existing query suggestions from an index.
+    #
+    # This deletes existing suggestions only, not the queries in the query
+    # log. After you clear suggestions, Amazon Kendra learns new suggestions
+    # based on new queries added to the query log from the time you cleared
+    # suggestions. If you do not see any new suggestions, then please allow
+    # Amazon Kendra to collect enough queries to learn new suggestions.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index you want to clear query suggestions from.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.clear_query_suggestions({
+    #     index_id: "IndexId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ClearQuerySuggestions AWS API Documentation
+    #
+    # @overload clear_query_suggestions(params = {})
+    # @param [Hash] params ({})
+    def clear_query_suggestions(params = {}, options = {})
+      req = build_request(:clear_query_suggestions, params)
+      req.send_request(options)
+    end
+
     # Creates a data source that you use to with an Amazon Kendra index.
     #
     # You specify a name, data source connector type and description for
@@ -566,7 +679,7 @@ module Aws::Kendra
     #   resp = client.create_data_source({
     #     name: "DataSourceName", # required
     #     index_id: "IndexId", # required
-    #     type: "S3", # required, accepts S3, SHAREPOINT, DATABASE, SALESFORCE, ONEDRIVE, SERVICENOW, CUSTOM, CONFLUENCE, GOOGLEDRIVE
+    #     type: "S3", # required, accepts S3, SHAREPOINT, DATABASE, SALESFORCE, ONEDRIVE, SERVICENOW, CUSTOM, CONFLUENCE, GOOGLEDRIVE, WEBCRAWLER
     #     configuration: {
     #       s3_configuration: {
     #         bucket_name: "S3BucketName", # required
@@ -744,6 +857,7 @@ module Aws::Kendra
     #               index_field_name: "IndexFieldName", # required
     #             },
     #           ],
+    #           filter_query: "ServiceNowKnowledgeArticleFilterQuery",
     #         },
     #         service_catalog_configuration: {
     #           crawl_attachments: false,
@@ -759,6 +873,7 @@ module Aws::Kendra
     #             },
     #           ],
     #         },
+    #         authentication_type: "HTTP_BASIC", # accepts HTTP_BASIC, OAUTH2
     #       },
     #       confluence_configuration: {
     #         server_url: "Url", # required
@@ -827,6 +942,37 @@ module Aws::Kendra
     #         exclude_user_accounts: ["UserAccount"],
     #         exclude_shared_drives: ["SharedDriveId"],
     #       },
+    #       web_crawler_configuration: {
+    #         urls: { # required
+    #           seed_url_configuration: {
+    #             seed_urls: ["SeedUrl"], # required
+    #             web_crawler_mode: "HOST_ONLY", # accepts HOST_ONLY, SUBDOMAINS, EVERYTHING
+    #           },
+    #           site_maps_configuration: {
+    #             site_maps: ["SiteMap"], # required
+    #           },
+    #         },
+    #         crawl_depth: 1,
+    #         max_links_per_page: 1,
+    #         max_content_size_per_page_in_mega_bytes: 1.0,
+    #         max_urls_per_minute_crawl_rate: 1,
+    #         url_inclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
+    #         url_exclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
+    #         proxy_configuration: {
+    #           host: "Host", # required
+    #           port: 1, # required
+    #           credentials: "SecretArn",
+    #         },
+    #         authentication_configuration: {
+    #           basic_authentication: [
+    #             {
+    #               host: "Host", # required
+    #               port: 1, # required
+    #               credentials: "SecretArn", # required
+    #             },
+    #           ],
+    #         },
+    #       },
     #     },
     #     description: "Description",
     #     schedule: "ScanSchedule",
@@ -944,11 +1090,12 @@ module Aws::Kendra
 
     # Creates a new Amazon Kendra index. Index creation is an asynchronous
     # operation. To determine if index creation has completed, check the
-    # `Status` field returned from a call to . The `Status` field is set to
-    # `ACTIVE` when the index is ready to use.
+    # `Status` field returned from a call to `DescribeIndex`. The `Status`
+    # field is set to `ACTIVE` when the index is ready to use.
     #
     # Once the index is active you can index your documents using the
-    # operation or using one of the supported data sources.
+    # `BatchPutDocument` operation or using one of the supported data
+    # sources.
     #
     # @option params [required, String] :name
     #   The name for the new index.
@@ -1062,6 +1209,107 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Creates a block list to exlcude certain queries from suggestions.
+    #
+    # Any query that contains words or phrases specified in the block list
+    # is blocked or filtered out from being shown as a suggestion.
+    #
+    # You need to provide the file location of your block list text file in
+    # your S3 bucket. In your text file, enter each block word or phrase on
+    # a separate line.
+    #
+    # 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
+    #
+    # @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.
+    #
+    #   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.
+    #
+    # @option params [String] :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."
+    #
+    # @option params [required, Types::S3Path] :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
+    #
+    # @option params [String] :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.**
+    #
+    # @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.
+    #
+    #   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.
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   A tag that you can assign to a block list that categorizes the block
+    #   list.
+    #
+    # @return [Types::CreateQuerySuggestionsBlockListResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateQuerySuggestionsBlockListResponse#id #id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_query_suggestions_block_list({
+    #     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
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/CreateQuerySuggestionsBlockList AWS API Documentation
+    #
+    # @overload create_query_suggestions_block_list(params = {})
+    # @param [Hash] params ({})
+    def create_query_suggestions_block_list(params = {}, options = {})
+      req = build_request(:create_query_suggestions_block_list, params)
+      req.send_request(options)
+    end
+
     # Creates a thesaurus for an index. The thesaurus contains a list of
     # synonyms in Solr format.
     #
@@ -1134,9 +1382,9 @@ module Aws::Kendra
 
     # Deletes an Amazon Kendra data source. An exception is not thrown if
     # the data source is already being deleted. While the data source is
-    # being deleted, the `Status` field returned by a call to the operation
-    # is set to `DELETING`. For more information, see [Deleting Data
-    # Sources][1].
+    # being deleted, the `Status` field returned by a call to the
+    # `DescribeDataSource` operation is set to `DELETING`. For more
+    # information, see [Deleting Data Sources][1].
     #
     #
     #
@@ -1194,7 +1442,7 @@ module Aws::Kendra
 
     # Deletes an existing Amazon Kendra index. An exception is not thrown if
     # the index is already being deleted. While the index is being deleted,
-    # the `Status` field returned by a call to the DescribeIndex operation
+    # the `Status` field returned by a call to the `DescribeIndex` operation
     # is set to `DELETING`.
     #
     # @option params [required, String] :id
@@ -1217,6 +1465,36 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Deletes a block list used for query suggestions for an index.
+    #
+    # A deleted block list might not take effect right away. Amazon Kendra
+    # needs to refresh the entire suggestions list to add back the queries
+    # that were previously blocked.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the you want to delete a block list from.
+    #
+    # @option params [required, String] :id
+    #   The unique identifier of the block list that needs to be deleted.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_query_suggestions_block_list({
+    #     index_id: "IndexId", # required
+    #     id: "QuerySuggestionsBlockListId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DeleteQuerySuggestionsBlockList AWS API Documentation
+    #
+    # @overload delete_query_suggestions_block_list(params = {})
+    # @param [Hash] params ({})
+    def delete_query_suggestions_block_list(params = {}, options = {})
+      req = build_request(:delete_query_suggestions_block_list, params)
+      req.send_request(options)
+    end
+
     # Deletes an existing Amazon Kendra thesaurus.
     #
     # @option params [required, String] :id
@@ -1278,7 +1556,7 @@ module Aws::Kendra
     #   resp.id #=> String
     #   resp.index_id #=> String
     #   resp.name #=> String
-    #   resp.type #=> String, one of "S3", "SHAREPOINT", "DATABASE", "SALESFORCE", "ONEDRIVE", "SERVICENOW", "CUSTOM", "CONFLUENCE", "GOOGLEDRIVE"
+    #   resp.type #=> String, one of "S3", "SHAREPOINT", "DATABASE", "SALESFORCE", "ONEDRIVE", "SERVICENOW", "CUSTOM", "CONFLUENCE", "GOOGLEDRIVE", "WEBCRAWLER"
     #   resp.configuration.s3_configuration.bucket_name #=> String
     #   resp.configuration.s3_configuration.inclusion_prefixes #=> Array
     #   resp.configuration.s3_configuration.inclusion_prefixes[0] #=> String
@@ -1402,6 +1680,7 @@ module Aws::Kendra
     #   resp.configuration.service_now_configuration.knowledge_article_configuration.field_mappings[0].data_source_field_name #=> String
     #   resp.configuration.service_now_configuration.knowledge_article_configuration.field_mappings[0].date_field_format #=> String
     #   resp.configuration.service_now_configuration.knowledge_article_configuration.field_mappings[0].index_field_name #=> String
+    #   resp.configuration.service_now_configuration.knowledge_article_configuration.filter_query #=> String
     #   resp.configuration.service_now_configuration.service_catalog_configuration.crawl_attachments #=> Boolean
     #   resp.configuration.service_now_configuration.service_catalog_configuration.include_attachment_file_patterns #=> Array
     #   resp.configuration.service_now_configuration.service_catalog_configuration.include_attachment_file_patterns[0] #=> String
@@ -1413,6 +1692,7 @@ module Aws::Kendra
     #   resp.configuration.service_now_configuration.service_catalog_configuration.field_mappings[0].data_source_field_name #=> String
     #   resp.configuration.service_now_configuration.service_catalog_configuration.field_mappings[0].date_field_format #=> String
     #   resp.configuration.service_now_configuration.service_catalog_configuration.field_mappings[0].index_field_name #=> String
+    #   resp.configuration.service_now_configuration.authentication_type #=> String, one of "HTTP_BASIC", "OAUTH2"
     #   resp.configuration.confluence_configuration.server_url #=> String
     #   resp.configuration.confluence_configuration.secret_arn #=> String
     #   resp.configuration.confluence_configuration.version #=> String, one of "CLOUD", "SERVER"
@@ -1462,6 +1742,26 @@ module Aws::Kendra
     #   resp.configuration.google_drive_configuration.exclude_user_accounts[0] #=> String
     #   resp.configuration.google_drive_configuration.exclude_shared_drives #=> Array
     #   resp.configuration.google_drive_configuration.exclude_shared_drives[0] #=> String
+    #   resp.configuration.web_crawler_configuration.urls.seed_url_configuration.seed_urls #=> Array
+    #   resp.configuration.web_crawler_configuration.urls.seed_url_configuration.seed_urls[0] #=> String
+    #   resp.configuration.web_crawler_configuration.urls.seed_url_configuration.web_crawler_mode #=> String, one of "HOST_ONLY", "SUBDOMAINS", "EVERYTHING"
+    #   resp.configuration.web_crawler_configuration.urls.site_maps_configuration.site_maps #=> Array
+    #   resp.configuration.web_crawler_configuration.urls.site_maps_configuration.site_maps[0] #=> String
+    #   resp.configuration.web_crawler_configuration.crawl_depth #=> Integer
+    #   resp.configuration.web_crawler_configuration.max_links_per_page #=> Integer
+    #   resp.configuration.web_crawler_configuration.max_content_size_per_page_in_mega_bytes #=> Float
+    #   resp.configuration.web_crawler_configuration.max_urls_per_minute_crawl_rate #=> Integer
+    #   resp.configuration.web_crawler_configuration.url_inclusion_patterns #=> Array
+    #   resp.configuration.web_crawler_configuration.url_inclusion_patterns[0] #=> String
+    #   resp.configuration.web_crawler_configuration.url_exclusion_patterns #=> Array
+    #   resp.configuration.web_crawler_configuration.url_exclusion_patterns[0] #=> String
+    #   resp.configuration.web_crawler_configuration.proxy_configuration.host #=> String
+    #   resp.configuration.web_crawler_configuration.proxy_configuration.port #=> Integer
+    #   resp.configuration.web_crawler_configuration.proxy_configuration.credentials #=> String
+    #   resp.configuration.web_crawler_configuration.authentication_configuration.basic_authentication #=> Array
+    #   resp.configuration.web_crawler_configuration.authentication_configuration.basic_authentication[0].host #=> String
+    #   resp.configuration.web_crawler_configuration.authentication_configuration.basic_authentication[0].port #=> Integer
+    #   resp.configuration.web_crawler_configuration.authentication_configuration.basic_authentication[0].credentials #=> String
     #   resp.created_at #=> Time
     #   resp.updated_at #=> Time
     #   resp.description #=> String
@@ -1612,6 +1912,112 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Describes a block list used for query suggestions for an index.
+    #
+    # This is used to check the current settings that are applied to a block
+    # list.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index for the block list.
+    #
+    # @option params [required, String] :id
+    #   The unique identifier of the block list.
+    #
+    # @return [Types::DescribeQuerySuggestionsBlockListResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#index_id #index_id} => String
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#id #id} => String
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#name #name} => String
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#description #description} => String
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#status #status} => String
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#error_message #error_message} => String
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#created_at #created_at} => Time
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#updated_at #updated_at} => Time
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#source_s3_path #source_s3_path} => Types::S3Path
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#item_count #item_count} => Integer
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#file_size_bytes #file_size_bytes} => Integer
+    #   * {Types::DescribeQuerySuggestionsBlockListResponse#role_arn #role_arn} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_query_suggestions_block_list({
+    #     index_id: "IndexId", # required
+    #     id: "QuerySuggestionsBlockListId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.index_id #=> String
+    #   resp.id #=> String
+    #   resp.name #=> String
+    #   resp.description #=> String
+    #   resp.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "UPDATING", "ACTIVE_BUT_UPDATE_FAILED", "FAILED"
+    #   resp.error_message #=> String
+    #   resp.created_at #=> Time
+    #   resp.updated_at #=> Time
+    #   resp.source_s3_path.bucket #=> String
+    #   resp.source_s3_path.key #=> String
+    #   resp.item_count #=> Integer
+    #   resp.file_size_bytes #=> Integer
+    #   resp.role_arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeQuerySuggestionsBlockList AWS API Documentation
+    #
+    # @overload describe_query_suggestions_block_list(params = {})
+    # @param [Hash] params ({})
+    def describe_query_suggestions_block_list(params = {}, options = {})
+      req = build_request(:describe_query_suggestions_block_list, params)
+      req.send_request(options)
+    end
+
+    # Describes the settings of query suggestions for an index.
+    #
+    # This is used to check the current settings applied to query
+    # suggestions.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index you want to describe query suggestions
+    #   settings for.
+    #
+    # @return [Types::DescribeQuerySuggestionsConfigResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeQuerySuggestionsConfigResponse#mode #mode} => String
+    #   * {Types::DescribeQuerySuggestionsConfigResponse#status #status} => String
+    #   * {Types::DescribeQuerySuggestionsConfigResponse#query_log_look_back_window_in_days #query_log_look_back_window_in_days} => Integer
+    #   * {Types::DescribeQuerySuggestionsConfigResponse#include_queries_without_user_information #include_queries_without_user_information} => Boolean
+    #   * {Types::DescribeQuerySuggestionsConfigResponse#minimum_number_of_querying_users #minimum_number_of_querying_users} => Integer
+    #   * {Types::DescribeQuerySuggestionsConfigResponse#minimum_query_count #minimum_query_count} => Integer
+    #   * {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
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_query_suggestions_config({
+    #     index_id: "IndexId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.mode #=> String, one of "ENABLED", "LEARN_ONLY"
+    #   resp.status #=> String, one of "ACTIVE", "UPDATING"
+    #   resp.query_log_look_back_window_in_days #=> Integer
+    #   resp.include_queries_without_user_information #=> Boolean
+    #   resp.minimum_number_of_querying_users #=> Integer
+    #   resp.minimum_query_count #=> Integer
+    #   resp.last_suggestions_build_time #=> Time
+    #   resp.last_clear_time #=> Time
+    #   resp.total_suggestions_count #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeQuerySuggestionsConfig AWS API Documentation
+    #
+    # @overload describe_query_suggestions_config(params = {})
+    # @param [Hash] params ({})
+    def describe_query_suggestions_config(params = {}, options = {})
+      req = build_request(:describe_query_suggestions_config, params)
+      req.send_request(options)
+    end
+
     # Describes an existing Amazon Kendra thesaurus.
     #
     # @option params [required, String] :id
@@ -1669,6 +2075,58 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Fetches the queries that are suggested to your users.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index you want to get query suggestions from.
+    #
+    # @option params [required, String] :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.
+    #
+    # @option params [Integer] :max_suggestions_count
+    #   The maximum number of query suggestions you want to show to your
+    #   users.
+    #
+    # @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
+    #   * {Types::GetQuerySuggestionsResponse#suggestions #suggestions} => Array&lt;Types::Suggestion&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_query_suggestions({
+    #     index_id: "IndexId", # required
+    #     query_text: "SuggestionQueryText", # required
+    #     max_suggestions_count: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.query_suggestions_id #=> String
+    #   resp.suggestions #=> Array
+    #   resp.suggestions[0].id #=> String
+    #   resp.suggestions[0].value.text.text #=> String
+    #   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
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/GetQuerySuggestions AWS API Documentation
+    #
+    # @overload get_query_suggestions(params = {})
+    # @param [Hash] params ({})
+    def get_query_suggestions(params = {}, options = {})
+      req = build_request(:get_query_suggestions, params)
+      req.send_request(options)
+    end
+
     # Gets statistics about synchronizing Amazon Kendra with a data source.
     #
     # @option params [required, String] :id
@@ -1775,7 +2233,7 @@ module Aws::Kendra
     #   resp.summary_items #=> Array
     #   resp.summary_items[0].name #=> String
     #   resp.summary_items[0].id #=> String
-    #   resp.summary_items[0].type #=> String, one of "S3", "SHAREPOINT", "DATABASE", "SALESFORCE", "ONEDRIVE", "SERVICENOW", "CUSTOM", "CONFLUENCE", "GOOGLEDRIVE"
+    #   resp.summary_items[0].type #=> String, one of "S3", "SHAREPOINT", "DATABASE", "SALESFORCE", "ONEDRIVE", "SERVICENOW", "CUSTOM", "CONFLUENCE", "GOOGLEDRIVE", "WEBCRAWLER"
     #   resp.summary_items[0].created_at #=> Time
     #   resp.summary_items[0].updated_at #=> Time
     #   resp.summary_items[0].status #=> String, one of "CREATING", "DELETING", "FAILED", "UPDATING", "ACTIVE"
@@ -1882,6 +2340,68 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Lists the block lists used for query suggestions for an 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
+    #
+    # @option params [required, String] :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
+    #
+    # @option params [String] :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`).
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of block lists to return.
+    #
+    # @return [Types::ListQuerySuggestionsBlockListsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListQuerySuggestionsBlockListsResponse#block_list_summary_items #block_list_summary_items} => Array&lt;Types::QuerySuggestionsBlockListSummary&gt;
+    #   * {Types::ListQuerySuggestionsBlockListsResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_query_suggestions_block_lists({
+    #     index_id: "IndexId", # required
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.block_list_summary_items #=> Array
+    #   resp.block_list_summary_items[0].id #=> String
+    #   resp.block_list_summary_items[0].name #=> String
+    #   resp.block_list_summary_items[0].status #=> String, one of "ACTIVE", "CREATING", "DELETING", "UPDATING", "ACTIVE_BUT_UPDATE_FAILED", "FAILED"
+    #   resp.block_list_summary_items[0].created_at #=> Time
+    #   resp.block_list_summary_items[0].updated_at #=> Time
+    #   resp.block_list_summary_items[0].item_count #=> Integer
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ListQuerySuggestionsBlockLists AWS API Documentation
+    #
+    # @overload list_query_suggestions_block_lists(params = {})
+    # @param [Hash] params ({})
+    def list_query_suggestions_block_lists(params = {}, options = {})
+      req = build_request(:list_query_suggestions_block_lists, params)
+      req.send_request(options)
+    end
+
     # Gets a list of tags associated with a specified resource. Indexes,
     # FAQs, and data sources can have tags associated with them.
     #
@@ -1984,7 +2504,7 @@ module Aws::Kendra
     #
     # @option params [required, String] :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.
     #
     # @option params [required, String] :query_text
     #   The text to search for.
@@ -2013,6 +2533,23 @@ module Aws::Kendra
     #   Sets the type of query. Only results for the specified query type are
     #   returned.
     #
+    # @option params [Array<Types::DocumentRelevanceConfiguration>] :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.
+    #
     # @option params [Integer] :page_number
     #   Query results are returned in pages the size of the `PageSize`
     #   parameter. By default, Amazon Kendra returns the first page of
@@ -2139,6 +2676,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: {
@@ -2280,7 +2831,8 @@ module Aws::Kendra
     #
     # @option params [required, String] :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.
     #
     # @option params [Array<Types::ClickFeedback>] :click_feedback_items
     #   Tells Amazon Kendra that a particular search result link was chosen by
@@ -2594,6 +3146,7 @@ module Aws::Kendra
     #               index_field_name: "IndexFieldName", # required
     #             },
     #           ],
+    #           filter_query: "ServiceNowKnowledgeArticleFilterQuery",
     #         },
     #         service_catalog_configuration: {
     #           crawl_attachments: false,
@@ -2609,6 +3162,7 @@ module Aws::Kendra
     #             },
     #           ],
     #         },
+    #         authentication_type: "HTTP_BASIC", # accepts HTTP_BASIC, OAUTH2
     #       },
     #       confluence_configuration: {
     #         server_url: "Url", # required
@@ -2677,6 +3231,37 @@ module Aws::Kendra
     #         exclude_user_accounts: ["UserAccount"],
     #         exclude_shared_drives: ["SharedDriveId"],
     #       },
+    #       web_crawler_configuration: {
+    #         urls: { # required
+    #           seed_url_configuration: {
+    #             seed_urls: ["SeedUrl"], # required
+    #             web_crawler_mode: "HOST_ONLY", # accepts HOST_ONLY, SUBDOMAINS, EVERYTHING
+    #           },
+    #           site_maps_configuration: {
+    #             site_maps: ["SiteMap"], # required
+    #           },
+    #         },
+    #         crawl_depth: 1,
+    #         max_links_per_page: 1,
+    #         max_content_size_per_page_in_mega_bytes: 1.0,
+    #         max_urls_per_minute_crawl_rate: 1,
+    #         url_inclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
+    #         url_exclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
+    #         proxy_configuration: {
+    #           host: "Host", # required
+    #           port: 1, # required
+    #           credentials: "SecretArn",
+    #         },
+    #         authentication_configuration: {
+    #           basic_authentication: [
+    #             {
+    #               host: "Host", # required
+    #               port: 1, # required
+    #               credentials: "SecretArn", # required
+    #             },
+    #           ],
+    #         },
+    #       },
     #     },
     #     description: "Description",
     #     schedule: "ScanSchedule",
@@ -2711,7 +3296,7 @@ module Aws::Kendra
     #   The document metadata to update.
     #
     # @option params [Types::CapacityUnitsConfiguration] :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.
     #
@@ -2787,6 +3372,167 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Updates a block list used for query suggestions for an index.
+    #
+    # Updates to a block list might not take effect right away. Amazon
+    # Kendra needs to refresh the entire suggestions list to apply any
+    # updates to the block list. Other changes not related to the block list
+    # apply immediately.
+    #
+    # If a block list is updating, then you need to wait for the first
+    # update to finish before submitting another update.
+    #
+    # Amazon Kendra supports partial updates, so you only need to provide
+    # the fields you want to update.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index for a block list.
+    #
+    # @option params [required, String] :id
+    #   The unique identifier of a block list.
+    #
+    # @option params [String] :name
+    #   The name of a block list.
+    #
+    # @option params [String] :description
+    #   The description for a block list.
+    #
+    # @option params [Types::S3Path] :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.
+    #
+    # @option params [String] :role_arn
+    #   The IAM (Identity and Access Management) role used to access the block
+    #   list text file in S3.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_query_suggestions_block_list({
+    #     index_id: "IndexId", # required
+    #     id: "QuerySuggestionsBlockListId", # required
+    #     name: "QuerySuggestionsBlockListName",
+    #     description: "Description",
+    #     source_s3_path: {
+    #       bucket: "S3BucketName", # required
+    #       key: "S3ObjectKey", # required
+    #     },
+    #     role_arn: "RoleArn",
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/UpdateQuerySuggestionsBlockList AWS API Documentation
+    #
+    # @overload update_query_suggestions_block_list(params = {})
+    # @param [Hash] params ({})
+    def update_query_suggestions_block_list(params = {}, options = {})
+      req = build_request(:update_query_suggestions_block_list, params)
+      req.send_request(options)
+    end
+
+    # Updates the settings of query suggestions for an index.
+    #
+    # 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.
+    #
+    # Updates to query suggestions settings might not take effect right
+    # away. The time for your updated settings to take effect depends on the
+    # updates made and the number of search queries in your index.
+    #
+    # You can still enable/disable query suggestions at any time.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index you want to update query suggestions
+    #   settings for.
+    #
+    # @option params [String] :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.
+    #
+    # @option params [Integer] :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.
+    #
+    # @option params [Boolean] :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.
+    #
+    # @option params [Integer] :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.
+    #
+    # @option params [Integer] :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 [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_query_suggestions_config({
+    #     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,
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/UpdateQuerySuggestionsConfig AWS API Documentation
+    #
+    # @overload update_query_suggestions_config(params = {})
+    # @param [Hash] params ({})
+    def update_query_suggestions_config(params = {}, options = {})
+      req = build_request(:update_query_suggestions_config, params)
+      req.send_request(options)
+    end
+
     # Updates a thesaurus file associated with an index.
     #
     # @option params [required, String] :id
@@ -2845,7 +3591,7 @@ module Aws::Kendra
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kendra'
-      context[:gem_version] = '1.22.0'
+      context[:gem_version] = '1.27.0'
       Seahorse::Client::Request.new(handlers, context)
     end