aws-sdk-kendra 1.34.0 → 1.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76a45b5806dd8ba18c8fa286dae0c38a5e3b54ce1e66cedcbfa1d8ea6f166090
-  data.tar.gz: 351c1c015562f8162c91de839b4e3850a999d4bb61410bd8cef81aae04041c89
+  metadata.gz: 2282d58d249eb1630518c7deac1d5f932458723afba5b268e132e9b82935639f
+  data.tar.gz: 5083d471bbd04847ebca1f68975f21c07ac6e863fa8a9dbe712d4d32a3597a4e
 SHA512:
-  metadata.gz: f8d31a4e0c0c42898d6447b06f7f5a34d3eadc72a2e73b5391e45a55c437cf35984295d7f94b5cdfcb56ef0e6b24a6e0b1d6a0fad7ac8aaade9555be9ba92225
-  data.tar.gz: 29cadbfaf760596a4eccc580962661e0ed1e117efc6e65dc221235e11c76df6fe04b3799cc1751465a332989261c671066a6cafee48d3211d395ecf59970f66b
+  metadata.gz: c28ca33d5d70844f0ec81120878b9c15fe4e518566162000014c101f8e3e106c960d2f027fba735fc450922435406d0fa985fb2fd28e4ad3fa99a951f6e2abee
+  data.tar.gz: 67e7157071675757df19b2eed929d09be883a07a7f66a28accf54a7cc492719851fbb08852f1a39fa51253ab457f21a76e59c48e273a6c87cad70b08f9d74be6

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.35.0 (2021-10-06)
+------------------
+
+* Feature - Amazon Kendra now supports integration with AWS SSO
+
 1.34.0 (2021-09-01)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.34.0
+1.35.0

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

@@ -612,12 +612,12 @@ module Aws::Kendra
       req.send_request(options)
     end
 
-    # Creates a data source that you use to with an Amazon Kendra index.
+    # Creates a data source that you want to use with an Amazon Kendra
+    # index.
     #
     # You specify a name, data source connector type and description for
-    # your data source. You also specify configuration information such as
-    # document metadata (author, source URI, and so on) and user context
-    # information.
+    # your data source. You also specify configuration information for the
+    # data source connector.
     #
     # `CreateDataSource` is a synchronous operation. The operation returns
     # 200 if the data source was successfully created. Otherwise, an
@@ -1186,14 +1186,24 @@ module Aws::Kendra
     #   ATTRIBUTE\_FILTER
     #
     #   : All indexed content is searchable and displayable for all users. If
-    #     there is an access control list, it is ignored. You can filter on
-    #     user and group attributes.
+    #     you want to filter search results on user context, you can use the
+    #     attribute filters of `_user_id` and `_group_ids` or you can provide
+    #     user and group information in `UserContext`.
     #
     #   USER\_TOKEN
     #
-    #   : Enables SSO and token-based user access control. All documents with
-    #     no access control and all documents accessible to the user will be
-    #     searchable and displayable.
+    #   : Enables token-based user access control to filter search results on
+    #     user context. All documents with no access control and all documents
+    #     accessible to the user will be searchable and displayable.
+    #
+    # @option params [Types::UserGroupResolutionConfiguration] :user_group_resolution_configuration
+    #   Enables fetching access levels of groups and users from an AWS Single
+    #   Sign-On identity source. To configure this, see
+    #   [UserGroupResolutionConfiguration][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html
     #
     # @return [Types::CreateIndexResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1234,6 +1244,9 @@ module Aws::Kendra
     #       },
     #     ],
     #     user_context_policy: "ATTRIBUTE_FILTER", # accepts ATTRIBUTE_FILTER, USER_TOKEN
+    #     user_group_resolution_configuration: {
+    #       user_group_resolution_mode: "AWS_SSO", # required, accepts AWS_SSO, NONE
+    #     },
     #   })
     #
     # @example Response structure
@@ -1378,7 +1391,7 @@ module Aws::Kendra
     # @option params [String] :client_token
     #   A token that you provide to identify the request to create a
     #   thesaurus. Multiple calls to the `CreateThesaurus` operation with the
-    #   same client token will create only one index.
+    #   same client token will create only one thesaurus.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
@@ -1979,6 +1992,7 @@ module Aws::Kendra
     #   * {Types::DescribeIndexResponse#capacity_units #capacity_units} => Types::CapacityUnitsConfiguration
     #   * {Types::DescribeIndexResponse#user_token_configurations #user_token_configurations} => Array<Types::UserTokenConfiguration>
     #   * {Types::DescribeIndexResponse#user_context_policy #user_context_policy} => String
+    #   * {Types::DescribeIndexResponse#user_group_resolution_configuration #user_group_resolution_configuration} => Types::UserGroupResolutionConfiguration
     #
     # @example Request syntax with placeholder values
     #
@@ -2027,6 +2041,7 @@ module Aws::Kendra
     #   resp.user_token_configurations[0].json_token_type_configuration.user_name_attribute_field #=> String
     #   resp.user_token_configurations[0].json_token_type_configuration.group_attribute_field #=> String
     #   resp.user_context_policy #=> String, one of "ATTRIBUTE_FILTER", "USER_TOKEN"
+    #   resp.user_group_resolution_configuration.user_group_resolution_mode #=> String, one of "AWS_SSO", "NONE"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeIndex AWS API Documentation
     #
@@ -2316,8 +2331,9 @@ module Aws::Kendra
     #   The identifier of the index that contains the data source.
     #
     # @option params [String] :next_token
-    #   If the result of the previous request to `GetDataSourceSyncJobHistory`
-    #   was truncated, include the `NextToken` to fetch the next set of jobs.
+    #   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 jobs.
     #
     # @option params [Integer] :max_results
     #   The maximum number of synchronization jobs to return in the response.
@@ -2434,8 +2450,9 @@ module Aws::Kendra
     #   The index that contains the FAQ lists.
     #
     # @option params [String] :next_token
-    #   If the result of the previous request to `ListFaqs` was truncated,
-    #   include the `NextToken` to fetch the next set of FAQs.
+    #   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 FAQs.
     #
     # @option params [Integer] :max_results
     #   The maximum number of FAQs to return in the response. If there are
@@ -2491,11 +2508,15 @@ module Aws::Kendra
     #   for mapping users to their groups.
     #
     # @option params [String] :next_token
-    #   The next items in the list of groups that go beyond the maximum.
+    #   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 groups
+    #   that are mapped to users before a given ordering or timestamp
+    #   identifier.
     #
     # @option params [Integer] :max_results
-    #   The maximum results shown for a list of groups that are mapped to
-    #   users before a given ordering or timestamp identifier.
+    #   The maximum number of returned groups that are mapped to users before
+    #   a given ordering or timestamp identifier.
     #
     # @return [Types::ListGroupsOlderThanOrderingIdResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2713,13 +2734,16 @@ module Aws::Kendra
       req.send_request(options)
     end
 
-    # Maps users to their groups. You can also map sub groups to groups. For
-    # example, the group "Company Intellectual Property Teams" includes
-    # sub groups "Research" and "Engineering". These sub groups include
-    # their own list of users or people who work in these teams. Only users
-    # who work in research and engineering, and therefore belong in the
-    # intellectual property group, can see top-secret company documents in
-    # their search results.
+    # Maps users to their groups so that you only need to provide the user
+    # ID when you issue the query.
+    #
+    # You can also map sub groups to groups. For example, the group
+    # "Company Intellectual Property Teams" includes sub groups
+    # "Research" and "Engineering". These sub groups include their own
+    # list of users or people who work in these teams. Only users who work
+    # in research and engineering, and therefore belong in the intellectual
+    # property group, can see top-secret company documents in their search
+    # results.
     #
     # You map users to their groups when you want to filter search results
     # for different users based on their group’s access to documents. For
@@ -2921,7 +2945,7 @@ module Aws::Kendra
     #   the relevance that Amazon Kendra determines for the result.
     #
     # @option params [Types::UserContext] :user_context
-    #   The user context token.
+    #   The user context token or user and group information.
     #
     # @option params [String] :visitor_id
     #   Provides an identifier for a specific user. The `VisitorId` should be
@@ -3683,7 +3707,16 @@ module Aws::Kendra
     #   The user token configuration.
     #
     # @option params [String] :user_context_policy
-    #   The user user token context policy.
+    #   The user context policy.
+    #
+    # @option params [Types::UserGroupResolutionConfiguration] :user_group_resolution_configuration
+    #   Enables fetching access levels of groups and users from an AWS Single
+    #   Sign-On identity source. To configure this, see
+    #   [UserGroupResolutionConfiguration][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -3737,6 +3770,9 @@ module Aws::Kendra
     #       },
     #     ],
     #     user_context_policy: "ATTRIBUTE_FILTER", # accepts ATTRIBUTE_FILTER, USER_TOKEN
+    #     user_group_resolution_configuration: {
+    #       user_group_resolution_mode: "AWS_SSO", # required, accepts AWS_SSO, NONE
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/UpdateIndex AWS API Documentation
@@ -3967,7 +4003,7 @@ module Aws::Kendra
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kendra'
-      context[:gem_version] = '1.34.0'
+      context[:gem_version] = '1.35.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -387,6 +387,8 @@ module Aws::Kendra
     UserAccount = Shapes::StringShape.new(name: 'UserAccount')
     UserContext = Shapes::StructureShape.new(name: 'UserContext')
     UserContextPolicy = Shapes::StringShape.new(name: 'UserContextPolicy')
+    UserGroupResolutionConfiguration = Shapes::StructureShape.new(name: 'UserGroupResolutionConfiguration')
+    UserGroupResolutionMode = Shapes::StringShape.new(name: 'UserGroupResolutionMode')
     UserId = Shapes::StringShape.new(name: 'UserId')
     UserNameAttributeField = Shapes::StringShape.new(name: 'UserNameAttributeField')
     UserTokenConfiguration = Shapes::StructureShape.new(name: 'UserTokenConfiguration')
@@ -615,6 +617,7 @@ module Aws::Kendra
     CreateIndexRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     CreateIndexRequest.add_member(:user_token_configurations, Shapes::ShapeRef.new(shape: UserTokenConfigurationList, location_name: "UserTokenConfigurations"))
     CreateIndexRequest.add_member(:user_context_policy, Shapes::ShapeRef.new(shape: UserContextPolicy, location_name: "UserContextPolicy"))
+    CreateIndexRequest.add_member(:user_group_resolution_configuration, Shapes::ShapeRef.new(shape: UserGroupResolutionConfiguration, location_name: "UserGroupResolutionConfiguration"))
     CreateIndexRequest.struct_class = Types::CreateIndexRequest
 
     CreateIndexResponse.add_member(:id, Shapes::ShapeRef.new(shape: IndexId, location_name: "Id"))
@@ -794,6 +797,7 @@ module Aws::Kendra
     DescribeIndexResponse.add_member(:capacity_units, Shapes::ShapeRef.new(shape: CapacityUnitsConfiguration, location_name: "CapacityUnits"))
     DescribeIndexResponse.add_member(:user_token_configurations, Shapes::ShapeRef.new(shape: UserTokenConfigurationList, location_name: "UserTokenConfigurations"))
     DescribeIndexResponse.add_member(:user_context_policy, Shapes::ShapeRef.new(shape: UserContextPolicy, location_name: "UserContextPolicy"))
+    DescribeIndexResponse.add_member(:user_group_resolution_configuration, Shapes::ShapeRef.new(shape: UserGroupResolutionConfiguration, location_name: "UserGroupResolutionConfiguration"))
     DescribeIndexResponse.struct_class = Types::DescribeIndexResponse
 
     DescribePrincipalMappingRequest.add_member(:index_id, Shapes::ShapeRef.new(shape: IndexId, required: true, location_name: "IndexId"))
@@ -1466,6 +1470,7 @@ module Aws::Kendra
     UpdateIndexRequest.add_member(:capacity_units, Shapes::ShapeRef.new(shape: CapacityUnitsConfiguration, location_name: "CapacityUnits"))
     UpdateIndexRequest.add_member(:user_token_configurations, Shapes::ShapeRef.new(shape: UserTokenConfigurationList, location_name: "UserTokenConfigurations"))
     UpdateIndexRequest.add_member(:user_context_policy, Shapes::ShapeRef.new(shape: UserContextPolicy, location_name: "UserContextPolicy"))
+    UpdateIndexRequest.add_member(:user_group_resolution_configuration, Shapes::ShapeRef.new(shape: UserGroupResolutionConfiguration, location_name: "UserGroupResolutionConfiguration"))
     UpdateIndexRequest.struct_class = Types::UpdateIndexRequest
 
     UpdateQuerySuggestionsBlockListRequest.add_member(:index_id, Shapes::ShapeRef.new(shape: IndexId, required: true, location_name: "IndexId"))
@@ -1502,6 +1507,9 @@ module Aws::Kendra
     UserContext.add_member(:data_source_groups, Shapes::ShapeRef.new(shape: DataSourceGroups, location_name: "DataSourceGroups"))
     UserContext.struct_class = Types::UserContext
 
+    UserGroupResolutionConfiguration.add_member(:user_group_resolution_mode, Shapes::ShapeRef.new(shape: UserGroupResolutionMode, required: true, location_name: "UserGroupResolutionMode"))
+    UserGroupResolutionConfiguration.struct_class = Types::UserGroupResolutionConfiguration
+
     UserTokenConfiguration.add_member(:jwt_token_type_configuration, Shapes::ShapeRef.new(shape: JwtTokenTypeConfiguration, location_name: "JwtTokenTypeConfiguration"))
     UserTokenConfiguration.add_member(:json_token_type_configuration, Shapes::ShapeRef.new(shape: JsonTokenTypeConfiguration, location_name: "JsonTokenTypeConfiguration"))
     UserTokenConfiguration.struct_class = Types::UserTokenConfiguration

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

@@ -128,9 +128,10 @@ module Aws::Kendra
     # exception with the message "`AttributeFilter` cannot have a depth of
     # more than 2."
     #
-    # If you use more than 10 attribute filters, you receive a
-    # `ValidationException` exception with the message "`AttributeFilter`
-    # cannot have a length of more than 10".
+    # If you use more than 10 attribute filters in a given list for
+    # `AndAllFilters` or `OrAllFilters`, you receive a `ValidationException`
+    # with the message "`AttributeFilter` cannot have a length of more than
+    # 10".
     #
     # @note When making an API call, you may pass AttributeFilter
     #   data as a hash:
@@ -461,23 +462,22 @@ module Aws::Kendra
     #
     # @!attribute [rw] greater_than
     #   Performs a greater than operation on two document attributes. Use
-    #   with a document attribute of type `Integer` or `Long`.
+    #   with a document attribute of type `Date` or `Long`.
     #   @return [Types::DocumentAttribute]
     #
     # @!attribute [rw] greater_than_or_equals
     #   Performs a greater or equals than operation on two document
-    #   attributes. Use with a document attribute of type `Integer` or
-    #   `Long`.
+    #   attributes. Use with a document attribute of type `Date` or `Long`.
     #   @return [Types::DocumentAttribute]
     #
     # @!attribute [rw] less_than
     #   Performs a less than operation on two document attributes. Use with
-    #   a document attribute of type `Integer` or `Long`.
+    #   a document attribute of type `Date` or `Long`.
     #   @return [Types::DocumentAttribute]
     #
     # @!attribute [rw] less_than_or_equals
     #   Performs a less than or equals operation on two document attributes.
-    #   Use with a document attribute of type `Integer` or `Long`.
+    #   Use with a document attribute of type `Date` or `Long`.
     #   @return [Types::DocumentAttribute]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/AttributeFilter AWS API Documentation
@@ -2182,6 +2182,9 @@ module Aws::Kendra
     #           },
     #         ],
     #         user_context_policy: "ATTRIBUTE_FILTER", # accepts ATTRIBUTE_FILTER, USER_TOKEN
+    #         user_group_resolution_configuration: {
+    #           user_group_resolution_mode: "AWS_SSO", # required, accepts AWS_SSO, NONE
+    #         },
     #       }
     #
     # @!attribute [rw] name
@@ -2248,16 +2251,28 @@ module Aws::Kendra
     #   ATTRIBUTE\_FILTER
     #
     #   : All indexed content is searchable and displayable for all users.
-    #     If there is an access control list, it is ignored. You can filter
-    #     on user and group attributes.
+    #     If you want to filter search results on user context, you can use
+    #     the attribute filters of `_user_id` and `_group_ids` or you can
+    #     provide user and group information in `UserContext`.
     #
     #   USER\_TOKEN
     #
-    #   : Enables SSO and token-based user access control. All documents
-    #     with no access control and all documents accessible to the user
-    #     will be searchable and displayable.
+    #   : Enables token-based user access control to filter search results
+    #     on user context. All documents with no access control and all
+    #     documents accessible to the user will be searchable and
+    #     displayable.
     #   @return [String]
     #
+    # @!attribute [rw] user_group_resolution_configuration
+    #   Enables fetching access levels of groups and users from an AWS
+    #   Single Sign-On identity source. To configure this, see
+    #   [UserGroupResolutionConfiguration][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html
+    #   @return [Types::UserGroupResolutionConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/CreateIndexRequest AWS API Documentation
     #
     class CreateIndexRequest < Struct.new(
@@ -2269,7 +2284,8 @@ module Aws::Kendra
       :client_token,
       :tags,
       :user_token_configurations,
-      :user_context_policy)
+      :user_context_policy,
+      :user_group_resolution_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2443,7 +2459,7 @@ module Aws::Kendra
     # @!attribute [rw] client_token
     #   A token that you provide to identify the request to create a
     #   thesaurus. Multiple calls to the `CreateThesaurus` operation with
-    #   the same client token will create only one index.
+    #   the same client token will create only one thesaurus.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
@@ -3675,6 +3691,12 @@ module Aws::Kendra
     #   The user context policy for the Amazon Kendra index.
     #   @return [String]
     #
+    # @!attribute [rw] user_group_resolution_configuration
+    #   Shows whether you have enabled the configuration for fetching access
+    #   levels of groups and users from an AWS Single Sign-On identity
+    #   source.
+    #   @return [Types::UserGroupResolutionConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribeIndexResponse AWS API Documentation
     #
     class DescribeIndexResponse < Struct.new(
@@ -3692,7 +3714,8 @@ module Aws::Kendra
       :error_message,
       :capacity_units,
       :user_token_configurations,
-      :user_context_policy)
+      :user_context_policy,
+      :user_group_resolution_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3829,8 +3852,7 @@ module Aws::Kendra
     #   @return [String]
     #
     # @!attribute [rw] created_at
-    #   Shows the date-time a block list for query suggestions was last
-    #   created.
+    #   Shows the date-time a block list for query suggestions was created.
     #   @return [Time]
     #
     # @!attribute [rw] updated_at
@@ -4782,6 +4804,15 @@ module Aws::Kendra
     #   users and sub groups for a group. Your sub groups can contain more
     #   than 1000 users, but the list of sub groups that belong to a group
     #   (and/or users) must be no more than 1000.
+    #
+    #   You can download this [example S3 file][1] that uses the correct
+    #   format for listing group members. Note, `dataSourceId` is optional.
+    #   The value of `type` for a group is always `GROUP` and for a user it
+    #   is always `USER`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/samples/group_members.zip
     #   @return [Types::S3Path]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/GroupMembers AWS API Documentation
@@ -5107,9 +5138,10 @@ module Aws::Kendra
     #   @return [String]
     #
     # @!attribute [rw] next_token
-    #   If the result of the previous request to
-    #   `GetDataSourceSyncJobHistory` was truncated, include the `NextToken`
-    #   to fetch the next set of jobs.
+    #   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 jobs.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -5146,12 +5178,9 @@ module Aws::Kendra
     #   @return [Array<Types::DataSourceSyncJob>]
     #
     # @!attribute [rw] next_token
-    #   The `GetDataSourceSyncJobHistory` operation returns a page of
-    #   vocabularies at a time. The maximum size of the page is set by the
-    #   `MaxResults` parameter. If there are more jobs in the list than the
-    #   page size, Amazon Kendra returns the NextPage token. Include the
-    #   token in the next request to the `GetDataSourceSyncJobHistory`
-    #   operation to return in the next page of jobs.
+    #   If the response is truncated, Amazon Kendra returns this token that
+    #   you can use in the subsequent request to retrieve the next set of
+    #   jobs.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ListDataSourceSyncJobsResponse AWS API Documentation
@@ -5230,8 +5259,10 @@ module Aws::Kendra
     #   @return [String]
     #
     # @!attribute [rw] next_token
-    #   If the result of the previous request to `ListFaqs` was truncated,
-    #   include the `NextToken` to fetch the next set of FAQs.
+    #   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 FAQs.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -5251,11 +5282,9 @@ module Aws::Kendra
     end
 
     # @!attribute [rw] next_token
-    #   The `ListFaqs` operation returns a page of FAQs at a time. The
-    #   maximum size of the page is set by the `MaxResults` parameter. If
-    #   there are more jobs in the list than the page size, Amazon Kendra
-    #   returns the `NextPage` token. Include the token in the next request
-    #   to the `ListFaqs` operation to return the next page of FAQs.
+    #   If the response is truncated, Amazon Kendra returns this token that
+    #   you can use in the subsequent request to retrieve the next set of
+    #   FAQs.
     #   @return [String]
     #
     # @!attribute [rw] faq_summary_items
@@ -5298,12 +5327,16 @@ module Aws::Kendra
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
-    #   The next items in the list of groups that go beyond the maximum.
+    #   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 groups that are mapped to users before a given ordering or
+    #   timestamp identifier.
     #   @return [String]
     #
     # @!attribute [rw] max_results
-    #   The maximum results shown for a list of groups that are mapped to
-    #   users before a given ordering or timestamp identifier.
+    #   The maximum number of returned groups that are mapped to users
+    #   before a given ordering or timestamp identifier.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ListGroupsOlderThanOrderingIdRequest AWS API Documentation
@@ -5324,7 +5357,10 @@ module Aws::Kendra
     #   @return [Array<Types::GroupSummary>]
     #
     # @!attribute [rw] next_token
-    #   The next items in the list of groups that go beyond the maximum.
+    #   If the response is truncated, Amazon Kendra returns this token that
+    #   you can use in the subsequent request to retrieve the next set of
+    #   groups that are mapped to users before a given ordering or timestamp
+    #   identifier.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ListGroupsOlderThanOrderingIdResponse AWS API Documentation
@@ -5528,7 +5564,8 @@ module Aws::Kendra
     #   @return [String]
     #
     # @!attribute [rw] thesaurus_summary_items
-    #   An array of summary information for one or more thesauruses.
+    #   An array of summary information for a thesaurus or multiple
+    #   thesauri.
     #   @return [Array<Types::ThesaurusSummary>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ListThesauriResponse AWS API Documentation
@@ -6116,7 +6153,7 @@ module Aws::Kendra
     #   @return [Types::SortingConfiguration]
     #
     # @!attribute [rw] user_context
-    #   The user context token.
+    #   The user context token or user and group information.
     #   @return [Types::UserContext]
     #
     # @!attribute [rw] visitor_id
@@ -8070,7 +8107,7 @@ module Aws::Kendra
       include Aws::Structure
     end
 
-    # An array of summary information for one or more thesauruses.
+    # An array of summary information for a thesaurus or multiple thesauri.
     #
     # @!attribute [rw] id
     #   The identifier of the thesaurus.
@@ -8593,6 +8630,9 @@ module Aws::Kendra
     #           },
     #         ],
     #         user_context_policy: "ATTRIBUTE_FILTER", # accepts ATTRIBUTE_FILTER, USER_TOKEN
+    #         user_group_resolution_configuration: {
+    #           user_group_resolution_mode: "AWS_SSO", # required, accepts AWS_SSO, NONE
+    #         },
     #       }
     #
     # @!attribute [rw] id
@@ -8631,9 +8671,19 @@ module Aws::Kendra
     #   @return [Array<Types::UserTokenConfiguration>]
     #
     # @!attribute [rw] user_context_policy
-    #   The user user token context policy.
+    #   The user context policy.
     #   @return [String]
     #
+    # @!attribute [rw] user_group_resolution_configuration
+    #   Enables fetching access levels of groups and users from an AWS
+    #   Single Sign-On identity source. To configure this, see
+    #   [UserGroupResolutionConfiguration][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html
+    #   @return [Types::UserGroupResolutionConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/UpdateIndexRequest AWS API Documentation
     #
     class UpdateIndexRequest < Struct.new(
@@ -8644,7 +8694,8 @@ module Aws::Kendra
       :document_metadata_configuration_updates,
       :capacity_units,
       :user_token_configurations,
-      :user_context_policy)
+      :user_context_policy,
+      :user_group_resolution_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -8855,6 +8906,11 @@ module Aws::Kendra
 
     # Provides the configuration information of the URLs to crawl.
     #
+    # You can only crawl websites that use the secure communication
+    # protocol, Hypertext Transfer Protocol Secure (HTTPS). If you receive
+    # an error when crawling a website, it could be that the website is
+    # blocked from crawling.
+    #
     # *When selecting websites to index, you must adhere to the [Amazon
     # Acceptable Use Policy][1] and all other Amazon terms. Remember that
     # you must only use the Amazon Kendra web crawler to index your own
@@ -8905,7 +8961,8 @@ module Aws::Kendra
       include Aws::Structure
     end
 
-    # Provides information about the user context for a Amazon Kendra index.
+    # Provides information about the user context for an Amazon Kendra
+    # index.
     #
     # This is used for filtering search results for different users based on
     # their access to documents.
@@ -8914,8 +8971,8 @@ module Aws::Kendra
     #
     # * User token
     #
-    # * User ID, the groups the user belongs to, and the data sources the
-    #   groups can access
+    # * User ID, the groups the user belongs to, and any data sources the
+    #   groups can access.
     #
     # If you provide both, an exception is thrown.
     #
@@ -8965,6 +9022,47 @@ module Aws::Kendra
       include Aws::Structure
     end
 
+    # Provides the configuration information to fetch access levels of
+    # groups and users from an AWS Single Sign-On identity source. This is
+    # useful for setting up user context filtering, where Amazon Kendra
+    # filters search results for different users based on their group's
+    # access to documents. You can also map your users to their groups for
+    # user context filtering using the [PutPrincipalMapping operation][1].
+    #
+    # To set up an AWS SSO identity source in the console to use with Amazon
+    # Kendra, see [Getting started with an AWS SSO identity source][2]. You
+    # must also grant the required permissions to use AWS SSO with Amazon
+    # Kendra. For more information, see [IAM roles for AWS Single
+    # Sign-On][3].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/latest/dg/API_PutPrincipalMapping.html
+    # [2]: https://docs.aws.amazon.com/kendra/latest/dg/getting-started-aws-sso.html
+    # [3]: https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-aws-sso
+    #
+    # @note When making an API call, you may pass UserGroupResolutionConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         user_group_resolution_mode: "AWS_SSO", # required, accepts AWS_SSO, NONE
+    #       }
+    #
+    # @!attribute [rw] user_group_resolution_mode
+    #   The identity store provider (mode) you want to use to fetch access
+    #   levels of groups and users. AWS Single Sign-On is currently the only
+    #   available mode. Your users and groups must exist in an AWS SSO
+    #   identity source in order to use this mode.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/UserGroupResolutionConfiguration AWS API Documentation
+    #
+    class UserGroupResolutionConfiguration < Struct.new(
+      :user_group_resolution_mode)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides configuration information for a token configuration.
     #
     # @note When making an API call, you may pass UserTokenConfiguration
@@ -9059,6 +9157,11 @@ module Aws::Kendra
     #   You can include website subdomains. You can list up to 100 seed URLs
     #   and up to three sitemap URLs.
     #
+    #   You can only crawl websites that use the secure communication
+    #   protocol, Hypertext Transfer Protocol Secure (HTTPS). If you receive
+    #   an error when crawling a website, it could be that the website is
+    #   blocked from crawling.
+    #
     #   *When selecting websites to index, you must adhere to the [Amazon
     #   Acceptable Use Policy][1] and all other Amazon terms. Remember that
     #   you must only use the Amazon Kendra web crawler to index your own

data/lib/aws-sdk-kendra.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-kendra
 version: !ruby/object:Gem::Version
-  version: 1.34.0
+  version: 1.35.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-01 00:00:00.000000000 Z
+date: 2021-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core