aws-sdk-kendra 1.77.0 → 1.79.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a2b91c1fb4ff425aa163833db0f8e56751f7600b95c39f8a47abae66039ad33
-  data.tar.gz: c2551d513a55a5929e60be4bac5f574b1bef6327e224cbf24a6b2d76a5f8816d
+  metadata.gz: 1008bfe50cafae87ebe36c5fc8bd34ad8d30bebc420cbdb03e15969894e58c40
+  data.tar.gz: c5f8e621a545426dc5c5533b7f1c5aca55173f509524ec3a4f4ed2d39a12de86
 SHA512:
-  metadata.gz: f127dfbdfc31fbc0d6c281c175a55af445345a94a6be6d5a3fbaac48906c57701b921d458f699e2cf74b36be022b258ae069b1039873dfcf644980a115ee6125
-  data.tar.gz: b21070e8e3af900d379331dcf07d8915a12cd1b4f36cc50b80bbf5c5258bbb938762ab0294d24ab2a4a6b654e599b5fb8b0ae5a2fe0c471ddb2c12d253397c71
+  metadata.gz: 7e0674110e6ce363e69dfd5ba31234dcd92010d66ee1360ac96c13cdb88c168dce16b9cae6fa7a1fa4a99a84e6402cc5de1a51a7059819c91dedef3093d3d800
+  data.tar.gz: 6abe2ce028eac4fb02f11720c4609ec4ec88645895c143bb6b4d459439343e60d91e2ba9b15d5b8774c41523bb6a304c5055489159aeb45ad728262acaf60e1c

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.79.0 (2024-04-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.78.0 (2024-03-22)
+------------------
+
+* Feature - Documentation update, March 2024. Corrects some docs for Amazon Kendra.
+
 1.77.0 (2024-01-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.77.0
+1.79.0

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

@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -72,6 +73,7 @@ module Aws::Kendra
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -196,10 +198,17 @@ module Aws::Kendra
     #     When set to 'true' the request body will not be compressed
     #     for supported operations.
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
+    #
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -347,50 +356,65 @@ module Aws::Kendra
     #   @option options [Aws::Kendra::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::Kendra::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @option options [Float] :http_read_timeout (60) The default
-    #     number of seconds to wait for response data.  This value can
-    #     safely be set per-request on the session.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     disables this behaviour.  This value can safely be set per
-    #     request on the session.
-    #
-    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
-    #     in seconds.
-    #
-    #   @option options [Boolean] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @option options [Float] :http_read_timeout (60)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -2251,7 +2275,9 @@ module Aws::Kendra
     #
     # @option params [Types::UserGroupResolutionConfiguration] :user_group_resolution_configuration
     #   Gets users and groups from IAM Identity Center identity source. To
-    #   configure this, see [UserGroupResolutionConfiguration][1].
+    #   configure this, see [UserGroupResolutionConfiguration][1]. This is
+    #   useful for user context filtering, where search results are filtered
+    #   based on the user or their group access to documents.
     #
     #
     #
@@ -2632,10 +2658,10 @@ module Aws::Kendra
       req.send_request(options)
     end
 
-    # 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` API is
-    # set to `DELETING`.
+    # Deletes an 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` API is set to
+    # `DELETING`.
     #
     # @option params [required, String] :id
     #   The identifier of the index you want to delete.
@@ -2764,7 +2790,7 @@ module Aws::Kendra
       req.send_request(options)
     end
 
-    # Deletes an existing Amazon Kendra thesaurus.
+    # Deletes an Amazon Kendra thesaurus.
     #
     # @option params [required, String] :id
     #   The identifier of the thesaurus you want to delete.
@@ -3575,7 +3601,7 @@ module Aws::Kendra
       req.send_request(options)
     end
 
-    # Gets information about an existing Amazon Kendra index.
+    # Gets information about an Amazon Kendra index.
     #
     # @option params [required, String] :id
     #   The identifier of the index you want to get information on.
@@ -3833,7 +3859,7 @@ module Aws::Kendra
       req.send_request(options)
     end
 
-    # Gets information about an existing Amazon Kendra thesaurus.
+    # Gets information about an Amazon Kendra thesaurus.
     #
     # @option params [required, String] :id
     #   The identifier of the thesaurus you want to get information on.
@@ -5109,7 +5135,14 @@ module Aws::Kendra
     #   The input query text for the search. Amazon Kendra truncates queries
     #   at 30 token words, which excludes punctuation and stop words.
     #   Truncation still applies if you use Boolean or more advanced, complex
-    #   queries.
+    #   queries. For example, `Timeoff AND October AND Category:HR` is counted
+    #   as 3 tokens: `timeoff`, `october`, `hr`. For more information, see
+    #   [Searching with advanced query syntax][1] in the Amazon Kendra
+    #   Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax
     #
     # @option params [Types::AttributeFilter] :attribute_filter
     #   Filters search results by document fields/attributes. You can only
@@ -5552,7 +5585,14 @@ module Aws::Kendra
     #   The input query text to retrieve relevant passages for the search.
     #   Amazon Kendra truncates queries at 30 token words, which excludes
     #   punctuation and stop words. Truncation still applies if you use
-    #   Boolean or more advanced, complex queries.
+    #   Boolean or more advanced, complex queries. For example, `Timeoff AND
+    #   October AND Category:HR` is counted as 3 tokens: `timeoff`, `october`,
+    #   `hr`. For more information, see [Searching with advanced query
+    #   syntax][1] in the Amazon Kendra Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax
     #
     # @option params [Types::AttributeFilter] :attribute_filter
     #   Filters search results by document fields/attributes. You can only
@@ -6017,7 +6057,7 @@ module Aws::Kendra
       req.send_request(options)
     end
 
-    # Updates an existing Amazon Kendra data source connector.
+    # Updates an Amazon Kendra data source connector.
     #
     # @option params [required, String] :id
     #   The identifier of the data source connector you want to update.
@@ -6942,13 +6982,13 @@ module Aws::Kendra
       req.send_request(options)
     end
 
-    # Updates an existing Amazon Kendra index.
+    # Updates an Amazon Kendra index.
     #
     # @option params [required, String] :id
     #   The identifier of the index you want to update.
     #
     # @option params [String] :name
-    #   The name of the index you want to update.
+    #   A new name for the index.
     #
     # @option params [String] :role_arn
     #   An Identity and Access Management (IAM) role that gives Amazon Kendra
@@ -6979,9 +7019,10 @@ module Aws::Kendra
     #   The user context policy.
     #
     # @option params [Types::UserGroupResolutionConfiguration] :user_group_resolution_configuration
-    #   Enables fetching access levels of groups and users from an IAM
-    #   Identity Center identity source. To configure this, see
-    #   [UserGroupResolutionConfiguration][1].
+    #   Gets users and groups from IAM Identity Center identity source. To
+    #   configure this, see [UserGroupResolutionConfiguration][1]. This is
+    #   useful for user context filtering, where search results are filtered
+    #   based on the user or their group access to documents.
     #
     #
     #
@@ -7291,7 +7332,7 @@ module Aws::Kendra
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kendra'
-      context[:gem_version] = '1.77.0'
+      context[:gem_version] = '1.79.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -2413,7 +2413,9 @@ module Aws::Kendra
     #
     # @!attribute [rw] user_group_resolution_configuration
     #   Gets users and groups from IAM Identity Center identity source. To
-    #   configure this, see [UserGroupResolutionConfiguration][1].
+    #   configure this, see [UserGroupResolutionConfiguration][1]. This is
+    #   useful for user context filtering, where search results are filtered
+    #   based on the user or their group access to documents.
     #
     #
     #
@@ -2670,6 +2672,26 @@ module Aws::Kendra
     # @!attribute [rw] s3_configuration
     #   Provides the configuration information to connect to an Amazon S3
     #   bucket as your data source.
+    #
+    #   <note markdown="1"> Amazon Kendra now supports an upgraded Amazon S3 connector.
+    #
+    #    You must now use the [TemplateConfiguration][1] object instead of
+    #   the `S3DataSourceConfiguration` object to configure your connector.
+    #
+    #    Connectors configured using the older console and API architecture
+    #   will continue to function as configured. However, you won't be able
+    #   to edit or update them. If you want to edit or update your connector
+    #   configuration, you must create a new connector.
+    #
+    #    We recommended migrating your connector workflow to the upgraded
+    #   version. Support for connectors configured using the older
+    #   architecture is scheduled to end by June 2024.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html
     #   @return [Types::S3DataSourceConfiguration]
     #
     # @!attribute [rw] share_point_configuration
@@ -2720,11 +2742,51 @@ module Aws::Kendra
     # @!attribute [rw] fsx_configuration
     #   Provides the configuration information to connect to Amazon FSx as
     #   your data source.
+    #
+    #   <note markdown="1"> Amazon Kendra now supports an upgraded Amazon FSx Windows connector.
+    #
+    #    You must now use the [TemplateConfiguration][1] object instead of
+    #   the `FsxConfiguration` object to configure your connector.
+    #
+    #    Connectors configured using the older console and API architecture
+    #   will continue to function as configured. However, you won't be able
+    #   to edit or update them. If you want to edit or update your connector
+    #   configuration, you must create a new connector.
+    #
+    #    We recommended migrating your connector workflow to the upgraded
+    #   version. Support for connectors configured using the older
+    #   architecture is scheduled to end by June 2024.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html
     #   @return [Types::FsxConfiguration]
     #
     # @!attribute [rw] slack_configuration
     #   Provides the configuration information to connect to Slack as your
     #   data source.
+    #
+    #   <note markdown="1"> Amazon Kendra now supports an upgraded Slack connector.
+    #
+    #    You must now use the [TemplateConfiguration][1] object instead of
+    #   the `SlackConfiguration` object to configure your connector.
+    #
+    #    Connectors configured using the older console and API architecture
+    #   will continue to function as configured. However, you won't be able
+    #   to edit or update them. If you want to edit or update your connector
+    #   configuration, you must create a new connector.
+    #
+    #    We recommended migrating your connector workflow to the upgraded
+    #   version. Support for connectors configured using the older
+    #   architecture is scheduled to end by June 2024.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html
     #   @return [Types::SlackConfiguration]
     #
     # @!attribute [rw] box_configuration
@@ -2745,16 +2807,38 @@ module Aws::Kendra
     # @!attribute [rw] git_hub_configuration
     #   Provides the configuration information to connect to GitHub as your
     #   data source.
+    #
+    #   <note markdown="1"> Amazon Kendra now supports an upgraded GitHub connector.
+    #
+    #    You must now use the [TemplateConfiguration][1] object instead of
+    #   the `GitHubConfiguration` object to configure your connector.
+    #
+    #    Connectors configured using the older console and API architecture
+    #   will continue to function as configured. However, you won’t be able
+    #   to edit or update them. If you want to edit or update your connector
+    #   configuration, you must create a new connector.
+    #
+    #    We recommended migrating your connector workflow to the upgraded
+    #   version. Support for connectors configured using the older
+    #   architecture is scheduled to end by June 2024.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html
     #   @return [Types::GitHubConfiguration]
     #
     # @!attribute [rw] alfresco_configuration
     #   Provides the configuration information to connect to Alfresco as
     #   your data source.
     #
-    #   Support for `AlfrescoConfiguration` ended May 2023. We recommend
+    #   <note markdown="1"> Support for `AlfrescoConfiguration` ended May 2023. We recommend
     #   migrating to or using the Alfresco data source template schema /
     #   [TemplateConfiguration][1] API.
     #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html
@@ -3780,11 +3864,11 @@ module Aws::Kendra
     #
     # @!attribute [rw] role_arn
     #   The Amazon Resource Name (ARN) of the IAM role that gives Amazon
-    #   Kendra permission to write to your Amazon Cloudwatch logs.
+    #   Kendra permission to write to your Amazon CloudWatch logs.
     #   @return [String]
     #
     # @!attribute [rw] server_side_encryption_configuration
-    #   The identifier of the KMScustomer master key (CMK) that is used to
+    #   The identifier of the KMS customer master key (CMK) that is used to
     #   encrypt your data. Amazon Kendra doesn't support asymmetric CMKs.
     #   @return [Types::ServerSideEncryptionConfiguration]
     #
@@ -3803,7 +3887,7 @@ module Aws::Kendra
     #   @return [Time]
     #
     # @!attribute [rw] updated_at
-    #   The Unix when the index was last updated.
+    #   The Unix timestamp when the index was last updated.
     #   @return [Time]
     #
     # @!attribute [rw] document_metadata_configurations
@@ -3845,9 +3929,10 @@ module Aws::Kendra
     #   @return [String]
     #
     # @!attribute [rw] user_group_resolution_configuration
-    #   Whether you have enabled the configuration for fetching access
-    #   levels of groups and users from an IAM Identity Center identity
-    #   source.
+    #   Whether you have enabled IAM Identity Center identity source for
+    #   your users and groups. This is useful for user context filtering,
+    #   where search results are filtered based on the user or their group
+    #   access to documents.
     #   @return [Types::UserGroupResolutionConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeIndexResponse AWS API Documentation
@@ -5513,6 +5598,26 @@ module Aws::Kendra
     # Provides the configuration information to connect to Amazon FSx as
     # your data source.
     #
+    # <note markdown="1"> Amazon Kendra now supports an upgraded Amazon FSx Windows connector.
+    #
+    #  You must now use the [TemplateConfiguration][1] object instead of the
+    # `FsxConfiguration` object to configure your connector.
+    #
+    #  Connectors configured using the older console and API architecture
+    # will continue to function as configured. However, you won't be able
+    # to edit or update them. If you want to edit or update your connector
+    # configuration, you must create a new connector.
+    #
+    #  We recommended migrating your connector workflow to the upgraded
+    # version. Support for connectors configured using the older
+    # architecture is scheduled to end by June 2024.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html
+    #
     # @!attribute [rw] file_system_id
     #   The identifier of the Amazon FSx file system.
     #
@@ -5764,6 +5869,26 @@ module Aws::Kendra
     # Provides the configuration information to connect to GitHub as your
     # data source.
     #
+    # <note markdown="1"> Amazon Kendra now supports an upgraded GitHub connector.
+    #
+    #  You must now use the [TemplateConfiguration][1] object instead of the
+    # `GitHubConfiguration` object to configure your connector.
+    #
+    #  Connectors configured using the older console and API architecture
+    # will continue to function as configured. However, you won’t be able to
+    # edit or update them. If you want to edit or update your connector
+    # configuration, you must create a new connector.
+    #
+    #  We recommended migrating your connector workflow to the upgraded
+    # version. Support for connectors configured using the older
+    # architecture is scheduled to end by June 2024.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html
+    #
     # @!attribute [rw] saa_s_configuration
     #   Configuration information to connect to GitHub Enterprise Cloud
     #   (SaaS).
@@ -7378,7 +7503,7 @@ module Aws::Kendra
     #
     # @!attribute [rw] organization_name
     #   The name of the organization of the GitHub Enterprise Server
-    #   (in-premise) account you want to connect to. You can find your
+    #   (on-premises) account you want to connect to. You can find your
     #   organization name by logging into GitHub desktop and selecting
     #   **Your organizations** under your profile picture dropdown.
     #   @return [String]
@@ -7714,7 +7839,14 @@ module Aws::Kendra
     #   The input query text for the search. Amazon Kendra truncates queries
     #   at 30 token words, which excludes punctuation and stop words.
     #   Truncation still applies if you use Boolean or more advanced,
-    #   complex queries.
+    #   complex queries. For example, `Timeoff AND October AND Category:HR`
+    #   is counted as 3 tokens: `timeoff`, `october`, `hr`. For more
+    #   information, see [Searching with advanced query syntax][1] in the
+    #   Amazon Kendra Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax
     #   @return [String]
     #
     # @!attribute [rw] attribute_filter
@@ -7912,7 +8044,10 @@ module Aws::Kendra
     # document that satisfies the query.
     #
     # @!attribute [rw] id
-    #   The identifier for the query result.
+    #   The unique identifier for the query result item id (`Id`) and the
+    #   query result item document id (`DocumentId`) combined. The value of
+    #   this field changes with every request, even when you have the same
+    #   documents.
     #   @return [String]
     #
     # @!attribute [rw] type
@@ -8195,8 +8330,7 @@ module Aws::Kendra
     #   Indicates that this field determines how "fresh" a document is.
     #   For example, if document 1 was created on November 5, and document 2
     #   was created on October 31, document 1 is "fresher" than document
-    #   2. You can only set the `Freshness` field on one `DATE` type field.
-    #   Only applies to `DATE` fields.
+    #   2. Only applies to `DATE` fields.
     #   @return [Boolean]
     #
     # @!attribute [rw] importance
@@ -8228,13 +8362,13 @@ module Aws::Kendra
     #   better. For example, in a task tracking application, a priority 1
     #   task is more important than a priority 5 task.
     #
-    #   Only applies to `LONG` and `DOUBLE` fields.
+    #   Only applies to `LONG` fields.
     #   @return [String]
     #
     # @!attribute [rw] value_importance_map
     #   A list of values that should be given a different boost when they
     #   appear in the result list. For example, if you are boosting a field
-    #   called "department," query terms that match the department field
+    #   called "department", query terms that match the department field
     #   are boosted in the result. However, you can add entries from the
     #   department field to boost documents with those values higher.
     #
@@ -8344,7 +8478,14 @@ module Aws::Kendra
     #   The input query text to retrieve relevant passages for the search.
     #   Amazon Kendra truncates queries at 30 token words, which excludes
     #   punctuation and stop words. Truncation still applies if you use
-    #   Boolean or more advanced, complex queries.
+    #   Boolean or more advanced, complex queries. For example, `Timeoff AND
+    #   October AND Category:HR` is counted as 3 tokens: `timeoff`,
+    #   `october`, `hr`. For more information, see [Searching with advanced
+    #   query syntax][1] in the Amazon Kendra Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax
     #   @return [String]
     #
     # @!attribute [rw] attribute_filter
@@ -8485,6 +8626,26 @@ module Aws::Kendra
     # Provides the configuration information to connect to an Amazon S3
     # bucket.
     #
+    # <note markdown="1"> Amazon Kendra now supports an upgraded Amazon S3 connector.
+    #
+    #  You must now use the [TemplateConfiguration][1] object instead of the
+    # `S3DataSourceConfiguration` object to configure your connector.
+    #
+    #  Connectors configured using the older console and API architecture
+    # will continue to function as configured. However, you won't be able
+    # to edit or update them. If you want to edit or update your connector
+    # configuration, you must create a new connector.
+    #
+    #  We recommended migrating your connector workflow to the upgraded
+    # version. Support for connectors configured using the older
+    # architecture is scheduled to end by June 2024.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html
+    #
     # @!attribute [rw] bucket_name
     #   The name of the bucket that contains the documents.
     #   @return [String]
@@ -8495,21 +8656,37 @@ module Aws::Kendra
     #   @return [Array<String>]
     #
     # @!attribute [rw] inclusion_patterns
-    #   A list of glob patterns for documents that should be indexed. If a
-    #   document that matches an inclusion pattern also matches an exclusion
-    #   pattern, the document is not indexed.
+    #   A list of glob patterns (patterns that can expand a wildcard pattern
+    #   into a list of path names that match the given pattern) for certain
+    #   file names and file types to include in your index. If a document
+    #   matches both an inclusion and exclusion prefix or pattern, the
+    #   exclusion prefix takes precendence and the document is not indexed.
+    #   Examples of glob patterns include:
+    #
+    #   * */myapp/config/**—All files inside config directory.
+    #
+    #   * ***/*.png*—All .png files in all directories.
+    #
+    #   * ***/*.\\\{png, ico, md\\}*—All .png, .ico or .md files in all
+    #     directories.
     #
-    #   Some [examples][1] are:
+    #   * */myapp/src/**/*.ts*—All .ts files inside src directory (and
+    #     all its subdirectories).
     #
-    #   * **.txt* will include all text files in a directory (files with
-    #     the extension .txt).
+    #   * ***/!(*.module).ts*—All .ts files but not .module.ts
     #
-    #   * ***/*.txt* will include all text files in a directory and its
-    #     subdirectories.
+    #   * **.png , *.jpg*—All PNG and JPEG image files in a directory
+    #     (files with the extensions .png and .jpg).
     #
-    #   * **tax** will include all files in a directory that contain
-    #     'tax' in the file name, such as 'tax', 'taxes',
-    #     'income\_tax'.
+    #   * **internal**—All files in a directory that contain 'internal'
+    #     in the file name, such as 'internal', 'internal\_only',
+    #     'company\_internal'.
+    #
+    #   * ***/*internal**—All internal-related files in a directory and
+    #     its subdirectories.
+    #
+    #   For more examples, see [Use of Exclude and Include Filters][1] in
+    #   the Amazon Web Services CLI Command Reference.
     #
     #
     #
@@ -8517,21 +8694,37 @@ module Aws::Kendra
     #   @return [Array<String>]
     #
     # @!attribute [rw] exclusion_patterns
-    #   A list of glob patterns for documents that should not be indexed. If
-    #   a document that matches an inclusion prefix or inclusion pattern
-    #   also matches an exclusion pattern, the document is not indexed.
+    #   A list of glob patterns (patterns that can expand a wildcard pattern
+    #   into a list of path names that match the given pattern) for certain
+    #   file names and file types to exclude from your index. If a document
+    #   matches both an inclusion and exclusion prefix or pattern, the
+    #   exclusion prefix takes precendence and the document is not indexed.
+    #   Examples of glob patterns include:
+    #
+    #   * */myapp/config/**—All files inside config directory.
+    #
+    #   * ***/*.png*—All .png files in all directories.
+    #
+    #   * ***/*.\\\{png, ico, md\\}*—All .png, .ico or .md files in all
+    #     directories.
+    #
+    #   * */myapp/src/**/*.ts*—All .ts files inside src directory (and
+    #     all its subdirectories).
     #
-    #   Some [examples][1] are:
+    #   * ***/!(*.module).ts*—All .ts files but not .module.ts
     #
-    #   * **.png , *.jpg* will exclude all PNG and JPEG image files in a
-    #     directory (files with the extensions .png and .jpg).
+    #   * **.png , *.jpg*—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**—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.
+    #   * ***/*internal**—All internal-related files in a directory and
+    #     its subdirectories.
+    #
+    #   For more examples, see [Use of Exclude and Include Filters][1] in
+    #   the Amazon Web Services CLI Command Reference.
     #
     #
     #
@@ -9435,6 +9628,26 @@ module Aws::Kendra
     # Provides the configuration information to connect to Slack as your
     # data source.
     #
+    # <note markdown="1"> Amazon Kendra now supports an upgraded Slack connector.
+    #
+    #  You must now use the [TemplateConfiguration][1] object instead of the
+    # `SlackConfiguration` object to configure your connector.
+    #
+    #  Connectors configured using the older console and API architecture
+    # will continue to function as configured. However, you won’t be able to
+    # edit or update them. If you want to edit or update your connector
+    # configuration, you must create a new connector.
+    #
+    #  We recommended migrating your connector workflow to the upgraded
+    # version. Support for connectors configured using the older
+    # architecture is scheduled to end by June 2024.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html
+    #
     # @!attribute [rw] team_id
     #   The identifier of the team in the Slack workspace. For example,
     #   *T0123456789*.
@@ -10481,7 +10694,7 @@ module Aws::Kendra
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The name of the index you want to update.
+    #   A new name for the index.
     #   @return [String]
     #
     # @!attribute [rw] role_arn
@@ -10519,9 +10732,10 @@ module Aws::Kendra
     #   @return [String]
     #
     # @!attribute [rw] user_group_resolution_configuration
-    #   Enables fetching access levels of groups and users from an IAM
-    #   Identity Center identity source. To configure this, see
-    #   [UserGroupResolutionConfiguration][1].
+    #   Gets users and groups from IAM Identity Center identity source. To
+    #   configure this, see [UserGroupResolutionConfiguration][1]. This is
+    #   useful for user context filtering, where search results are filtered
+    #   based on the user or their group access to documents.
     #
     #
     #

data/lib/aws-sdk-kendra.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-kendra/customizations'
 # @!group service
 module Aws::Kendra
 
-  GEM_VERSION = '1.77.0'
+  GEM_VERSION = '1.79.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-kendra
 version: !ruby/object:Gem::Version
-  version: 1.77.0
+  version: 1.79.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.191.0
+        version: 3.193.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.191.0
+        version: 3.193.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement