aws-sdk-kendra 1.41.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69a9fd7cbe4b1ffd86d1ec01871a98783cd3203fa3ea3eb103632dddb1d974b3
-  data.tar.gz: 31694a3177a6644c8201d020ca625f708208b022df8ee2c8b191561b647133b9
+  metadata.gz: 34b195b939363a4d9ab4281bbab5fda30476fd89ef587f69b843d64eae31fe99
+  data.tar.gz: 913e2608207629ea75392386994ff6f83fc8ce85fce0c7ed86f30a042f821c18
 SHA512:
-  metadata.gz: 667e30da502f821bc1e689f3a652aa0bb7a67d46fa52a96945e37a3198046c7edd963850dd86664ddee35b8e2e9053e6c7a396bfc2e4c0688e9d61df2244cfbd
-  data.tar.gz: bc6b4f1beba0c6282271e93c5d3508738353742db87c3a7a10a31a86044cf6f573828e87fc1bfa186e2fac2edd74de3981b80368da3b1ca41266c0366afa32f6
+  metadata.gz: 3aa92e253a6d0bf3c680733ea040506bfcb2809958164360d67e48589c791599c185d88d6ea0fdeaad82fdc5b7dd263c8f14281a2618f09d599065795cad7c4b
+  data.tar.gz: e1324182a10d542171bb12c0152131cbb36ef2aa0ef0e3dac5c704def3056ffabc5fd7fb3646f425c94c8fe91fec6e1fb1ba5d462e7d40de3a32b5fe610ef78d

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.42.0 (2022-01-11)
+------------------
+
+* Feature - Amazon Kendra now supports advanced query language and query-less search.
+
 1.41.0 (2021-12-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.41.0
+1.42.0

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

@@ -1406,6 +1406,8 @@ module Aws::Kendra
     # Creates an new set of frequently asked question (FAQ) questions and
     # answers.
     #
+    # Adding FAQs to an index is an asynchronous operation.
+    #
     # @option params [required, String] :index_id
     #   The identifier of the index that contains the FAQ.
     #
@@ -3020,6 +3022,8 @@ module Aws::Kendra
     #   * {Types::GetSnapshotsResponse#snapshots_data #snapshots_data} => Array<Array<String>>
     #   * {Types::GetSnapshotsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_snapshots({
@@ -3786,7 +3790,7 @@ module Aws::Kendra
     #   The unique identifier of the index to search. The identifier is
     #   returned in the response from the `CreateIndex` operation.
     #
-    # @option params [required, String] :query_text
+    # @option params [String] :query_text
     #   The text to search for.
     #
     # @option params [Types::AttributeFilter] :attribute_filter
@@ -3865,12 +3869,13 @@ module Aws::Kendra
     #   * {Types::QueryResult#result_items #result_items} => Array<Types::QueryResultItem>
     #   * {Types::QueryResult#facet_results #facet_results} => Array<Types::FacetResult>
     #   * {Types::QueryResult#total_number_of_results #total_number_of_results} => Integer
+    #   * {Types::QueryResult#warnings #warnings} => Array<Types::Warning>
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.query({
     #     index_id: "IndexId", # required
-    #     query_text: "QueryText", # required
+    #     query_text: "QueryText",
     #     attribute_filter: {
     #       and_all_filters: [
     #         {
@@ -4039,6 +4044,9 @@ module Aws::Kendra
     #   resp.facet_results[0].document_attribute_value_count_pairs[0].document_attribute_value.date_value #=> Time
     #   resp.facet_results[0].document_attribute_value_count_pairs[0].count #=> Integer
     #   resp.total_number_of_results #=> Integer
+    #   resp.warnings #=> Array
+    #   resp.warnings[0].message #=> String
+    #   resp.warnings[0].code #=> String, one of "QUERY_LANGUAGE_INVALID_SYNTAX"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/Query AWS API Documentation
     #
@@ -5066,7 +5074,7 @@ module Aws::Kendra
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kendra'
-      context[:gem_version] = '1.41.0'
+      context[:gem_version] = '1.42.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -471,6 +471,10 @@ module Aws::Kendra
     ValueImportanceMapKey = Shapes::StringShape.new(name: 'ValueImportanceMapKey')
     VisitorId = Shapes::StringShape.new(name: 'VisitorId')
     VpcSecurityGroupId = Shapes::StringShape.new(name: 'VpcSecurityGroupId')
+    Warning = Shapes::StructureShape.new(name: 'Warning')
+    WarningCode = Shapes::StringShape.new(name: 'WarningCode')
+    WarningList = Shapes::ListShape.new(name: 'WarningList')
+    WarningMessage = Shapes::StringShape.new(name: 'WarningMessage')
     WebCrawlerConfiguration = Shapes::StructureShape.new(name: 'WebCrawlerConfiguration')
     WebCrawlerMode = Shapes::StringShape.new(name: 'WebCrawlerMode')
     WorkDocsConfiguration = Shapes::StructureShape.new(name: 'WorkDocsConfiguration')
@@ -1452,7 +1456,7 @@ module Aws::Kendra
     PutPrincipalMappingRequest.struct_class = Types::PutPrincipalMappingRequest
 
     QueryRequest.add_member(:index_id, Shapes::ShapeRef.new(shape: IndexId, required: true, location_name: "IndexId"))
-    QueryRequest.add_member(:query_text, Shapes::ShapeRef.new(shape: QueryText, required: true, location_name: "QueryText"))
+    QueryRequest.add_member(:query_text, Shapes::ShapeRef.new(shape: QueryText, location_name: "QueryText"))
     QueryRequest.add_member(:attribute_filter, Shapes::ShapeRef.new(shape: AttributeFilter, location_name: "AttributeFilter"))
     QueryRequest.add_member(:facets, Shapes::ShapeRef.new(shape: FacetList, location_name: "Facets"))
     QueryRequest.add_member(:requested_document_attributes, Shapes::ShapeRef.new(shape: DocumentAttributeKeyList, location_name: "RequestedDocumentAttributes"))
@@ -1469,6 +1473,7 @@ module Aws::Kendra
     QueryResult.add_member(:result_items, Shapes::ShapeRef.new(shape: QueryResultItemList, location_name: "ResultItems"))
     QueryResult.add_member(:facet_results, Shapes::ShapeRef.new(shape: FacetResultList, location_name: "FacetResults"))
     QueryResult.add_member(:total_number_of_results, Shapes::ShapeRef.new(shape: Integer, location_name: "TotalNumberOfResults"))
+    QueryResult.add_member(:warnings, Shapes::ShapeRef.new(shape: WarningList, location_name: "Warnings"))
     QueryResult.struct_class = Types::QueryResult
 
     QueryResultItem.add_member(:id, Shapes::ShapeRef.new(shape: ResultId, location_name: "Id"))
@@ -1835,6 +1840,12 @@ module Aws::Kendra
     ValueImportanceMap.key = Shapes::ShapeRef.new(shape: ValueImportanceMapKey)
     ValueImportanceMap.value = Shapes::ShapeRef.new(shape: Importance)
 
+    Warning.add_member(:message, Shapes::ShapeRef.new(shape: WarningMessage, location_name: "Message"))
+    Warning.add_member(:code, Shapes::ShapeRef.new(shape: WarningCode, location_name: "Code"))
+    Warning.struct_class = Types::Warning
+
+    WarningList.member = Shapes::ShapeRef.new(shape: Warning)
+
     WebCrawlerConfiguration.add_member(:urls, Shapes::ShapeRef.new(shape: Urls, required: true, location_name: "Urls"))
     WebCrawlerConfiguration.add_member(:crawl_depth, Shapes::ShapeRef.new(shape: CrawlDepth, location_name: "CrawlDepth"))
     WebCrawlerConfiguration.add_member(:max_links_per_page, Shapes::ShapeRef.new(shape: MaxLinksPerPage, location_name: "MaxLinksPerPage"))
@@ -2303,6 +2314,12 @@ module Aws::Kendra
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:list_data_source_sync_jobs, Seahorse::Model::Operation.new.tap do |o|

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

@@ -5038,6 +5038,13 @@ module Aws::Kendra
 
     # A custom attribute value assigned to a document.
     #
+    # For more information on how to create custom document attributes, see
+    # [Custom Attributes][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html
+    #
     # @note When making an API call, you may pass DocumentAttribute
     #   data as a hash:
     #
@@ -5235,9 +5242,9 @@ module Aws::Kendra
     #   A date expressed as an ISO 8601 string.
     #
     #   It is important for the time zone to be included in the ISO 8601
-    #   date-time format. For example, 20120325T123010+01:00 is the ISO 8601
-    #   date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in
-    #   Central European Time.
+    #   date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO
+    #   8601 date-time format for March 25th 2012 at 12:30PM (plus 10
+    #   seconds) in Central European Time.
     #   @return [Time]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DocumentAttributeValue AWS API Documentation
@@ -6289,18 +6296,17 @@ module Aws::Kendra
     # advanced alterations on the original or raw documents. If you want to
     # apply advanced alterations on the Amazon Kendra structured documents,
     # you must configure your Lambda function using
-    # [PostExtractionHookConfiguration][2]. You can only invoke one Lambda
+    # [PostExtractionHookConfiguration][1]. You can only invoke one Lambda
     # function. However, this function can invoke other functions it
     # requires.
     #
     # For more information, see [Customizing document metadata during the
-    # ingestion process][3].
+    # ingestion process][2].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_PreExtractionHookConfiguration.html
-    # [2]: https://docs.aws.amazon.com/kendra/latest/dg/API_PostExtractionHookConfiguration.html
-    # [3]: https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html
+    # [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_CustomDocumentEnrichmentConfiguration.html
+    # [2]: https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html
     #
     # @note When making an API call, you may pass HookConfiguration
     #   data as a hash:
@@ -7649,7 +7655,7 @@ module Aws::Kendra
     #
     #       {
     #         index_id: "IndexId", # required
-    #         query_text: "QueryText", # required
+    #         query_text: "QueryText",
     #         attribute_filter: {
     #           and_all_filters: [
     #             {
@@ -7900,13 +7906,27 @@ module Aws::Kendra
     #   items, you can only retrieve the first 100 of the items.
     #   @return [Integer]
     #
+    # @!attribute [rw] warnings
+    #   A list of warning codes and their messages on problems with your
+    #   query.
+    #
+    #   Amazon Kendra currently only supports one type of warning, which is
+    #   a warning on invalid syntax used in the query. For examples of
+    #   invalid query syntax, see [Searching with advanced query syntax][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax
+    #   @return [Array<Types::Warning>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/QueryResult AWS API Documentation
     #
     class QueryResult < Struct.new(
       :query_id,
       :result_items,
       :facet_results,
-      :total_number_of_results)
+      :total_number_of_results,
+      :warnings)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -10887,6 +10907,12 @@ module Aws::Kendra
     # permissions to use Amazon Web Services SSO with Amazon Kendra. For
     # more information, see [IAM roles for Amazon Web Services SSO][3].
     #
+    # Amazon Kendra currently does not support using
+    # `UserGroupResolutionConfiguration` with an Amazon Web Services
+    # organization member account for your Amazon Web Services SSO identify
+    # source. You must create your index in the parent account for the
+    # organization in order to use `UserGroupResolutionConfiguration`.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html
@@ -10998,6 +11024,25 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # The warning code and message that explains a problem with a query.
+    #
+    # @!attribute [rw] message
+    #   The message that explains the problem with the query.
+    #   @return [String]
+    #
+    # @!attribute [rw] code
+    #   The code used to show the type of warning for the query.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/Warning AWS API Documentation
+    #
+    class Warning < Struct.new(
+      :message,
+      :code)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides the configuration information required for Amazon Kendra Web
     # Crawler.
     #

data/lib/aws-sdk-kendra.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-kendra
 version: !ruby/object:Gem::Version
-  version: 1.41.0
+  version: 1.42.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-21 00:00:00.000000000 Z
+date: 2022-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core