aws-sdk-kendra 1.27.0 → 1.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18f9a0673af8278a3066d865646525130986d0d6fce53f4a84fc8b10efb26e21
-  data.tar.gz: 1b782bf81e35136fc3b2fd540bcc97821f38707b6159977a0e6243bc51b33253
+  metadata.gz: 7038aaa06fb793e9d6e31cc0c4703220832b7a9c2cdd6e7fae73df18c3dc3fc8
+  data.tar.gz: 1a109408574701029f28633b7c9332130103c3ceee3a197ca37ed1b3790d81d4
 SHA512:
-  metadata.gz: e91319bbb2301cbf8c9fb6900922854688faf4fac89b62c2ce9c5e1f5f36265e33cc3e5faa5dbfb581128c06ea406acc49be1b6c168c9920707b87aa28dffd72
-  data.tar.gz: ab38e61328b8e4b91f9354a2f23e74b98040d4477742ad86219cfc5de2c79e3ca36423574a13dbe2c6de1b5d45e1a36de594a36d8d9e29cd464a08a760986408
+  metadata.gz: 6c422c77076d0b647630c3daf4972454c8980cf62af30974ae3328b28aff8dba8168b73aadad3873dfe11ea97c23f8e1daa99da0acdc4800124fffbe83236413
+  data.tar.gz: 7798a38719c6685f28e746c99faf0d95996928d5c6ba63e67635fdd78b1370115279f8183eee9a6a95c77ba3ccdff3465ae0948cfe16081a8f35645a455a5b42

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.31.0 (2021-07-21)
+------------------
+
+* Feature - Amazon Kendra now provides a data source connector for Amazon WorkDocs. For more information, see https://docs.aws.amazon.com/kendra/latest/dg/data-source-workdocs.html
+
+1.30.0 (2021-07-12)
+------------------
+
+* Feature - Amazon Kendra now supports Principal Store
+
+1.29.0 (2021-06-30)
+------------------
+
+* Feature - Amazon Kendra Enterprise Edition now offered in smaller more granular units to enable customers with smaller workloads. Virtual Storage Capacity units now offer scaling in increments of 100,000 documents (up to 30GB) per unit and Virtual Query Units offer scaling increments of 8,000 queries per day.
+
+1.28.0 (2021-06-24)
+------------------
+
+* Feature - Amazon Kendra now supports SharePoint 2013 and SharePoint 2016 when using a SharePoint data source.
+
 1.27.0 (2021-06-17)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.27.0
+1.31.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.27.0'
+  GEM_VERSION = '1.31.0'
 
 end

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

@@ -341,8 +341,9 @@ module Aws::Kendra
     # 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 related to
-    # the processing of the batch are sent to you CloudWatch log.
+    # the deletion by using Amazon Web Services CloudWatch. Any error
+    # messages related to the processing of the batch are sent to you
+    # CloudWatch log.
     #
     # @option params [required, String] :index_id
     #   The identifier of the index that contains the documents to delete.
@@ -472,8 +473,9 @@ module Aws::Kendra
     # control list to the documents added to the index.
     #
     # The documents are indexed asynchronously. You can see the progress of
-    # the batch using AWS CloudWatch. Any error messages related to
-    # processing the batch are sent to your AWS CloudWatch log.
+    # the batch using Amazon Web Services CloudWatch. Any error messages
+    # related to processing the batch are sent to your Amazon Web Services
+    # CloudWatch log.
     #
     # @option params [required, String] :index_id
     #   The identifier of the index to add the documents to. You need to
@@ -546,6 +548,19 @@ module Aws::Kendra
     #             name: "PrincipalName", # required
     #             type: "USER", # required, accepts USER, GROUP
     #             access: "ALLOW", # required, accepts ALLOW, DENY
+    #             data_source_id: "DataSourceId",
+    #           },
+    #         ],
+    #         hierarchical_access_control_list: [
+    #           {
+    #             principal_list: [ # required
+    #               {
+    #                 name: "PrincipalName", # required
+    #                 type: "USER", # required, accepts USER, GROUP
+    #                 access: "ALLOW", # required, accepts ALLOW, DENY
+    #                 data_source_id: "DataSourceId",
+    #               },
+    #             ],
     #           },
     #         ],
     #         content_type: "PDF", # accepts PDF, HTML, MS_WORD, PLAIN_TEXT, PPT
@@ -679,7 +694,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, WEBCRAWLER
+    #     type: "S3", # required, accepts S3, SHAREPOINT, DATABASE, SALESFORCE, ONEDRIVE, SERVICENOW, CUSTOM, CONFLUENCE, GOOGLEDRIVE, WEBCRAWLER, WORKDOCS
     #     configuration: {
     #       s3_configuration: {
     #         bucket_name: "S3BucketName", # required
@@ -694,7 +709,7 @@ module Aws::Kendra
     #         },
     #       },
     #       share_point_configuration: {
-    #         share_point_version: "SHAREPOINT_ONLINE", # required, accepts SHAREPOINT_ONLINE
+    #         share_point_version: "SHAREPOINT_2013", # required, accepts SHAREPOINT_2013, SHAREPOINT_2016, SHAREPOINT_ONLINE
     #         urls: ["Url"], # required
     #         secret_arn: "SecretArn", # required
     #         crawl_attachments: false,
@@ -714,6 +729,10 @@ module Aws::Kendra
     #         ],
     #         document_title_field_name: "DataSourceFieldName",
     #         disable_local_groups: false,
+    #         ssl_certificate_s3_path: {
+    #           bucket: "S3BucketName", # required
+    #           key: "S3ObjectKey", # required
+    #         },
     #       },
     #       database_configuration: {
     #         database_engine_type: "RDS_AURORA_MYSQL", # required, accepts RDS_AURORA_MYSQL, RDS_AURORA_POSTGRESQL, RDS_MYSQL, RDS_POSTGRESQL
@@ -973,6 +992,20 @@ module Aws::Kendra
     #           ],
     #         },
     #       },
+    #       work_docs_configuration: {
+    #         organization_id: "OrganizationId", # required
+    #         crawl_comments: false,
+    #         use_change_log: false,
+    #         inclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
+    #         exclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
+    #         field_mappings: [
+    #           {
+    #             data_source_field_name: "DataSourceFieldName", # required
+    #             date_field_format: "DataSourceDateFieldFormat",
+    #             index_field_name: "IndexFieldName", # required
+    #           },
+    #         ],
+    #       },
     #     },
     #     description: "Description",
     #     schedule: "ScanSchedule",
@@ -1110,15 +1143,22 @@ module Aws::Kendra
     #   The `Edition` parameter is optional. If you don't supply a value, the
     #   default is `ENTERPRISE_EDITION`.
     #
+    #   For more information on quota limits for enterprise and developer
+    #   editions, see [Quotas][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/quotas.html
+    #
     # @option params [required, String] :role_arn
-    #   An AWS Identity and Access Management (IAM) role that gives Amazon
-    #   Kendra permissions to access your Amazon CloudWatch logs and metrics.
-    #   This is also the role used when you use the `BatchPutDocument`
-    #   operation to index documents from an Amazon S3 bucket.
+    #   An Identity and Access Management(IAM) role that gives Amazon Kendra
+    #   permissions to access your Amazon CloudWatch logs and metrics. This is
+    #   also the role used when you use the `BatchPutDocument` operation to
+    #   index documents from an Amazon S3 bucket.
     #
     # @option params [Types::ServerSideEncryptionConfiguration] :server_side_encryption_configuration
-    #   The identifier of the AWS KMS customer managed key (CMK) to use to
-    #   encrypt data indexed by Amazon Kendra. Amazon Kendra doesn't support
+    #   The identifier of the KMScustomer managed key (CMK) to use to encrypt
+    #   data indexed by Amazon Kendra. Amazon Kendra doesn't support
     #   asymmetric CMKs.
     #
     # @option params [String] :description
@@ -1465,6 +1505,78 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Deletes a group so that all users and sub groups that belong to the
+    # group can no longer access documents only available to that group.
+    #
+    # For example, after deleting the group "Summer Interns", all interns
+    # who belonged to that group no longer see intern-only documents in
+    # their search results.
+    #
+    # If you want to delete or replace users or sub groups of a group, you
+    # need to use the `PutPrincipalMapping` operation. For example, if a
+    # user in the group "Engineering" leaves the engineering team and
+    # another user takes their place, you provide an updated list of users
+    # or sub groups that belong to the "Engineering" group when calling
+    # `PutPrincipalMapping`. You can update your internal list of users or
+    # sub groups and input this list when calling `PutPrincipalMapping`.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index you want to delete a group from.
+    #
+    # @option params [String] :data_source_id
+    #   The identifier of the data source you want to delete a group from.
+    #
+    #   This is useful if a group is tied to multiple data sources and you
+    #   want to delete a group from accessing documents in a certain data
+    #   source. For example, the groups "Research", "Engineering", and
+    #   "Sales and Marketing" are all tied to the company's documents
+    #   stored in the data sources Confluence and Salesforce. You want to
+    #   delete "Research" and "Engineering" groups from Salesforce, so
+    #   that these groups cannot access customer-related documents stored in
+    #   Salesforce. Only "Sales and Marketing" should access documents in
+    #   the Salesforce data source.
+    #
+    # @option params [required, String] :group_id
+    #   The identifier of the group you want to delete.
+    #
+    # @option params [Integer] :ordering_id
+    #   The timestamp identifier you specify to ensure Amazon Kendra does not
+    #   override the latest `DELETE` action with previous actions. The highest
+    #   number ID, which is the ordering ID, is the latest action you want to
+    #   process and apply on top of other actions with lower number IDs. This
+    #   prevents previous actions with lower number IDs from possibly
+    #   overriding the latest action.
+    #
+    #   The ordering ID can be the UNIX time of the last update you made to a
+    #   group members list. You would then provide this list when calling
+    #   `PutPrincipalMapping`. This ensures your `DELETE` action for that
+    #   updated group with the latest members list doesn't get overwritten by
+    #   earlier `DELETE` actions for the same group which are yet to be
+    #   processed.
+    #
+    #   The default ordering ID is the current UNIX time in milliseconds that
+    #   the action was received by Amazon Kendra.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_principal_mapping({
+    #     index_id: "IndexId", # required
+    #     data_source_id: "DataSourceId",
+    #     group_id: "GroupId", # required
+    #     ordering_id: 1,
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DeletePrincipalMapping AWS API Documentation
+    #
+    # @overload delete_principal_mapping(params = {})
+    # @param [Hash] params ({})
+    def delete_principal_mapping(params = {}, options = {})
+      req = build_request(:delete_principal_mapping, params)
+      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
@@ -1556,7 +1668,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", "WEBCRAWLER"
+    #   resp.type #=> String, one of "S3", "SHAREPOINT", "DATABASE", "SALESFORCE", "ONEDRIVE", "SERVICENOW", "CUSTOM", "CONFLUENCE", "GOOGLEDRIVE", "WEBCRAWLER", "WORKDOCS"
     #   resp.configuration.s3_configuration.bucket_name #=> String
     #   resp.configuration.s3_configuration.inclusion_prefixes #=> Array
     #   resp.configuration.s3_configuration.inclusion_prefixes[0] #=> String
@@ -1566,7 +1678,7 @@ module Aws::Kendra
     #   resp.configuration.s3_configuration.exclusion_patterns[0] #=> String
     #   resp.configuration.s3_configuration.documents_metadata_configuration.s3_prefix #=> String
     #   resp.configuration.s3_configuration.access_control_list_configuration.key_path #=> String
-    #   resp.configuration.share_point_configuration.share_point_version #=> String, one of "SHAREPOINT_ONLINE"
+    #   resp.configuration.share_point_configuration.share_point_version #=> String, one of "SHAREPOINT_2013", "SHAREPOINT_2016", "SHAREPOINT_ONLINE"
     #   resp.configuration.share_point_configuration.urls #=> Array
     #   resp.configuration.share_point_configuration.urls[0] #=> String
     #   resp.configuration.share_point_configuration.secret_arn #=> String
@@ -1586,6 +1698,8 @@ module Aws::Kendra
     #   resp.configuration.share_point_configuration.field_mappings[0].index_field_name #=> String
     #   resp.configuration.share_point_configuration.document_title_field_name #=> String
     #   resp.configuration.share_point_configuration.disable_local_groups #=> Boolean
+    #   resp.configuration.share_point_configuration.ssl_certificate_s3_path.bucket #=> String
+    #   resp.configuration.share_point_configuration.ssl_certificate_s3_path.key #=> String
     #   resp.configuration.database_configuration.database_engine_type #=> String, one of "RDS_AURORA_MYSQL", "RDS_AURORA_POSTGRESQL", "RDS_MYSQL", "RDS_POSTGRESQL"
     #   resp.configuration.database_configuration.connection_configuration.database_host #=> String
     #   resp.configuration.database_configuration.connection_configuration.database_port #=> Integer
@@ -1762,6 +1876,17 @@ module Aws::Kendra
     #   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.configuration.work_docs_configuration.organization_id #=> String
+    #   resp.configuration.work_docs_configuration.crawl_comments #=> Boolean
+    #   resp.configuration.work_docs_configuration.use_change_log #=> Boolean
+    #   resp.configuration.work_docs_configuration.inclusion_patterns #=> Array
+    #   resp.configuration.work_docs_configuration.inclusion_patterns[0] #=> String
+    #   resp.configuration.work_docs_configuration.exclusion_patterns #=> Array
+    #   resp.configuration.work_docs_configuration.exclusion_patterns[0] #=> String
+    #   resp.configuration.work_docs_configuration.field_mappings #=> Array
+    #   resp.configuration.work_docs_configuration.field_mappings[0].data_source_field_name #=> String
+    #   resp.configuration.work_docs_configuration.field_mappings[0].date_field_format #=> String
+    #   resp.configuration.work_docs_configuration.field_mappings[0].index_field_name #=> String
     #   resp.created_at #=> Time
     #   resp.updated_at #=> Time
     #   resp.description #=> String
@@ -1912,6 +2037,61 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Describes the processing of `PUT` and `DELETE` actions for mapping
+    # users to their groups. This includes information on the status of
+    # actions currently processing or yet to be processed, when actions were
+    # last updated, when actions were received by Amazon Kendra, the latest
+    # action that should process and apply after other actions, and useful
+    # error messages if an action could not be processed.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index required to check the processing of `PUT`
+    #   and `DELETE` actions for mapping users to their groups.
+    #
+    # @option params [String] :data_source_id
+    #   The identifier of the data source to check the processing of `PUT` and
+    #   `DELETE` actions for mapping users to their groups.
+    #
+    # @option params [required, String] :group_id
+    #   The identifier of the group required to check the processing of `PUT`
+    #   and `DELETE` actions for mapping users to their groups.
+    #
+    # @return [Types::DescribePrincipalMappingResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribePrincipalMappingResponse#index_id #index_id} => String
+    #   * {Types::DescribePrincipalMappingResponse#data_source_id #data_source_id} => String
+    #   * {Types::DescribePrincipalMappingResponse#group_id #group_id} => String
+    #   * {Types::DescribePrincipalMappingResponse#group_ordering_id_summaries #group_ordering_id_summaries} => Array<Types::GroupOrderingIdSummary>
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_principal_mapping({
+    #     index_id: "IndexId", # required
+    #     data_source_id: "DataSourceId",
+    #     group_id: "GroupId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.index_id #=> String
+    #   resp.data_source_id #=> String
+    #   resp.group_id #=> String
+    #   resp.group_ordering_id_summaries #=> Array
+    #   resp.group_ordering_id_summaries[0].status #=> String, one of "FAILED", "SUCCEEDED", "PROCESSING", "DELETING", "DELETED"
+    #   resp.group_ordering_id_summaries[0].last_updated_at #=> Time
+    #   resp.group_ordering_id_summaries[0].received_at #=> Time
+    #   resp.group_ordering_id_summaries[0].ordering_id #=> Integer
+    #   resp.group_ordering_id_summaries[0].failure_reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DescribePrincipalMapping AWS API Documentation
+    #
+    # @overload describe_principal_mapping(params = {})
+    # @param [Hash] params ({})
+    def describe_principal_mapping(params = {}, options = {})
+      req = build_request(:describe_principal_mapping, params)
+      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
@@ -2233,7 +2413,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", "WEBCRAWLER"
+    #   resp.summary_items[0].type #=> String, one of "S3", "SHAREPOINT", "DATABASE", "SALESFORCE", "ONEDRIVE", "SERVICENOW", "CUSTOM", "CONFLUENCE", "GOOGLEDRIVE", "WEBCRAWLER", "WORKDOCS"
     #   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"
@@ -2295,6 +2475,59 @@ module Aws::Kendra
       req.send_request(options)
     end
 
+    # Provides a list of groups that are mapped to users before a given
+    # ordering or timestamp identifier.
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index for getting a list of groups mapped to
+    #   users before a given ordering or timestamp identifier.
+    #
+    # @option params [String] :data_source_id
+    #   The identifier of the data source for getting a list of groups mapped
+    #   to users before a given ordering timestamp identifier.
+    #
+    # @option params [required, Integer] :ordering_id
+    #   The timestamp identifier used for the latest `PUT` or `DELETE` action
+    #   for mapping users to their groups.
+    #
+    # @option params [String] :next_token
+    #   The next items in the list of groups that go beyond the maximum.
+    #
+    # @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.
+    #
+    # @return [Types::ListGroupsOlderThanOrderingIdResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListGroupsOlderThanOrderingIdResponse#groups_summaries #groups_summaries} => Array<Types::GroupSummary>
+    #   * {Types::ListGroupsOlderThanOrderingIdResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_groups_older_than_ordering_id({
+    #     index_id: "IndexId", # required
+    #     data_source_id: "DataSourceId",
+    #     ordering_id: 1, # required
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.groups_summaries #=> Array
+    #   resp.groups_summaries[0].group_id #=> String
+    #   resp.groups_summaries[0].ordering_id #=> Integer
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ListGroupsOlderThanOrderingId AWS API Documentation
+    #
+    # @overload list_groups_older_than_ordering_id(params = {})
+    # @param [Hash] params ({})
+    def list_groups_older_than_ordering_id(params = {}, options = {})
+      req = build_request(:list_groups_older_than_ordering_id, params)
+      req.send_request(options)
+    end
+
     # Lists the Amazon Kendra indexes that you have created.
     #
     # @option params [String] :next_token
@@ -2480,6 +2713,123 @@ 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.
+    #
+    # 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
+    # more information on filtering search results for different users, see
+    # [Filtering on user context][1].
+    #
+    # If more than five `PUT` actions for a group are currently processing,
+    # a validation exception is thrown.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html
+    #
+    # @option params [required, String] :index_id
+    #   The identifier of the index you want to map users to their groups.
+    #
+    # @option params [String] :data_source_id
+    #   The identifier of the data source you want to map users to their
+    #   groups.
+    #
+    #   This is useful if a group is tied to multiple data sources, but you
+    #   only want the group to access documents of a certain data source. For
+    #   example, the groups "Research", "Engineering", and "Sales and
+    #   Marketing" are all tied to the company's documents stored in the
+    #   data sources Confluence and Salesforce. However, "Sales and
+    #   Marketing" team only needs access to customer-related documents
+    #   stored in Salesforce.
+    #
+    # @option params [required, String] :group_id
+    #   The identifier of the group you want to map its users to.
+    #
+    # @option params [required, Types::GroupMembers] :group_members
+    #   The list that contains your users or sub groups that belong the same
+    #   group.
+    #
+    #   For example, the group "Company" includes the user "CEO" and the
+    #   sub groups "Research", "Engineering", and "Sales and Marketing".
+    #
+    #   If you have more than 1000 users and/or sub groups for a single group,
+    #   you need to provide the path to the S3 file that lists your 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.
+    #
+    # @option params [Integer] :ordering_id
+    #   The timestamp identifier you specify to ensure Amazon Kendra does not
+    #   override the latest `PUT` action with previous actions. The highest
+    #   number ID, which is the ordering ID, is the latest action you want to
+    #   process and apply on top of other actions with lower number IDs. This
+    #   prevents previous actions with lower number IDs from possibly
+    #   overriding the latest action.
+    #
+    #   The ordering ID can be the UNIX time of the last update you made to a
+    #   group members list. You would then provide this list when calling
+    #   `PutPrincipalMapping`. This ensures your `PUT` action for that updated
+    #   group with the latest members list doesn't get overwritten by earlier
+    #   `PUT` actions for the same group which are yet to be processed.
+    #
+    #   The default ordering ID is the current UNIX time in milliseconds that
+    #   the action was received by Amazon Kendra.
+    #
+    # @option params [String] :role_arn
+    #   The Amazon Resource Name (ARN) of a role that has access to the S3
+    #   file that contains your list of users or sub groups that belong to a
+    #   group.
+    #
+    #   For more information, see [IAM roles for Amazon Kendra][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_principal_mapping({
+    #     index_id: "IndexId", # required
+    #     data_source_id: "DataSourceId",
+    #     group_id: "GroupId", # required
+    #     group_members: { # required
+    #       member_groups: [
+    #         {
+    #           group_id: "GroupId", # required
+    #           data_source_id: "DataSourceId",
+    #         },
+    #       ],
+    #       member_users: [
+    #         {
+    #           user_id: "UserId", # required
+    #         },
+    #       ],
+    #       s3_pathfor_group_members: {
+    #         bucket: "S3BucketName", # required
+    #         key: "S3ObjectKey", # required
+    #       },
+    #     },
+    #     ordering_id: 1,
+    #     role_arn: "RoleArn",
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/PutPrincipalMapping AWS API Documentation
+    #
+    # @overload put_principal_mapping(params = {})
+    # @param [Hash] params ({})
+    def put_principal_mapping(params = {}, options = {})
+      req = build_request(:put_principal_mapping, params)
+      req.send_request(options)
+    end
+
     # Searches an active index. Use this API to search your documents using
     # query. The `Query` operation enables to do faceted search and to
     # filter results based on document attributes.
@@ -2698,6 +3048,14 @@ module Aws::Kendra
     #     },
     #     user_context: {
     #       token: "Token",
+    #       user_id: "PrincipalName",
+    #       groups: ["PrincipalName"],
+    #       data_source_groups: [
+    #         {
+    #           group_id: "PrincipalName", # required
+    #           data_source_id: "DataSourceId", # required
+    #         },
+    #       ],
     #     },
     #     visitor_id: "VisitorId",
     #   })
@@ -2824,7 +3182,7 @@ module Aws::Kendra
     end
 
     # Enables you to provide feedback to Amazon Kendra to improve the
-    # performance of the service.
+    # performance of your index.
     #
     # @option params [required, String] :index_id
     #   The identifier of the index that was queried.
@@ -2983,7 +3341,7 @@ module Aws::Kendra
     #         },
     #       },
     #       share_point_configuration: {
-    #         share_point_version: "SHAREPOINT_ONLINE", # required, accepts SHAREPOINT_ONLINE
+    #         share_point_version: "SHAREPOINT_2013", # required, accepts SHAREPOINT_2013, SHAREPOINT_2016, SHAREPOINT_ONLINE
     #         urls: ["Url"], # required
     #         secret_arn: "SecretArn", # required
     #         crawl_attachments: false,
@@ -3003,6 +3361,10 @@ module Aws::Kendra
     #         ],
     #         document_title_field_name: "DataSourceFieldName",
     #         disable_local_groups: false,
+    #         ssl_certificate_s3_path: {
+    #           bucket: "S3BucketName", # required
+    #           key: "S3ObjectKey", # required
+    #         },
     #       },
     #       database_configuration: {
     #         database_engine_type: "RDS_AURORA_MYSQL", # required, accepts RDS_AURORA_MYSQL, RDS_AURORA_POSTGRESQL, RDS_MYSQL, RDS_POSTGRESQL
@@ -3262,6 +3624,20 @@ module Aws::Kendra
     #           ],
     #         },
     #       },
+    #       work_docs_configuration: {
+    #         organization_id: "OrganizationId", # required
+    #         crawl_comments: false,
+    #         use_change_log: false,
+    #         inclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
+    #         exclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
+    #         field_mappings: [
+    #           {
+    #             data_source_field_name: "DataSourceFieldName", # required
+    #             date_field_format: "DataSourceDateFieldFormat",
+    #             index_field_name: "IndexFieldName", # required
+    #           },
+    #         ],
+    #       },
     #     },
     #     description: "Description",
     #     schedule: "ScanSchedule",
@@ -3591,7 +3967,7 @@ module Aws::Kendra
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kendra'
-      context[:gem_version] = '1.27.0'
+      context[:gem_version] = '1.31.0'
       Seahorse::Client::Request.new(handlers, context)
     end