aws-sdk-kendra 1.40.0 → 1.44.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -62,7 +62,7 @@ module Aws::Kendra
62
62
  # A list of groups, separated by semi-colons, that filters a query
63
63
  # response based on user context. The document is only returned to
64
64
  # users that are in one of the groups specified in the `UserContext`
65
- # field of the `Query` operation.
65
+ # field of the `Query` API.
66
66
  # @return [String]
67
67
  #
68
68
  # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/AclConfiguration AWS API Documentation
@@ -736,7 +736,7 @@ module Aws::Kendra
736
736
  end
737
737
 
738
738
  # Provides information about documents that could not be removed from an
739
- # index by the `BatchDeleteDocument` operation.
739
+ # index by the `BatchDeleteDocument` API.
740
740
  #
741
741
  # @!attribute [rw] id
742
742
  # The identifier of the document that couldn't be removed from the
@@ -788,7 +788,7 @@ module Aws::Kendra
788
788
  #
789
789
  # @!attribute [rw] index_id
790
790
  # The identifier of the index to add documents to. The index ID is
791
- # returned by the [ CreateIndex ][1] operation.
791
+ # returned by the [CreateIndex ][1] API.
792
792
  #
793
793
  #
794
794
  #
@@ -969,13 +969,13 @@ module Aws::Kendra
969
969
  #
970
970
  # @!attribute [rw] index_id
971
971
  # The identifier of the index to add the documents to. You need to
972
- # create the index first using the `CreateIndex` operation.
972
+ # create the index first using the `CreateIndex` API.
973
973
  # @return [String]
974
974
  #
975
975
  # @!attribute [rw] role_arn
976
976
  # The Amazon Resource Name (ARN) of a role that is allowed to run the
977
- # `BatchPutDocument` operation. For more information, see [IAM Roles
978
- # for Amazon Kendra][1].
977
+ # `BatchPutDocument` API. For more information, see [IAM Roles for
978
+ # Amazon Kendra][1].
979
979
  #
980
980
  #
981
981
  #
@@ -985,13 +985,6 @@ module Aws::Kendra
985
985
  # @!attribute [rw] documents
986
986
  # One or more documents to add to the index.
987
987
  #
988
- # Documents can include custom attributes. For example,
989
- # 'DataSourceId' and 'DataSourceSyncJobId' are custom attributes
990
- # that provide information on the synchronization of documents running
991
- # on a data source. Note, 'DataSourceSyncJobId' could be an optional
992
- # custom attribute as Amazon Kendra will use the ID of a running sync
993
- # job.
994
- #
995
988
  # Documents have the following file size limits.
996
989
  #
997
990
  # * 5 MB total size for inline documents
@@ -1011,7 +1004,7 @@ module Aws::Kendra
1011
1004
  # @!attribute [rw] custom_document_enrichment_configuration
1012
1005
  # Configuration information for altering your document metadata and
1013
1006
  # content during the document ingestion process when you use the
1014
- # `BatchPutDocument` operation.
1007
+ # `BatchPutDocument` API.
1015
1008
  #
1016
1009
  # For more information on how to create, modify and delete document
1017
1010
  # metadata, or make other content alterations when you ingest
@@ -1151,8 +1144,8 @@ module Aws::Kendra
1151
1144
  end
1152
1145
 
1153
1146
  # Gathers information about when a particular result was clicked by a
1154
- # user. Your application uses the `SubmitFeedback` operation to provide
1155
- # click information.
1147
+ # user. Your application uses the `SubmitFeedback` API to provide click
1148
+ # information.
1156
1149
  #
1157
1150
  # @note When making an API call, you may pass ClickFeedback
1158
1151
  # data as a hash:
@@ -1214,7 +1207,7 @@ module Aws::Kendra
1214
1207
  # @!attribute [rw] field_mappings
1215
1208
  # An array of objects that map database column names to the
1216
1209
  # corresponding fields in an index. You must first create the fields
1217
- # in the index using the `UpdateIndex` operation.
1210
+ # in the index using the `UpdateIndex` API.
1218
1211
  # @return [Array<Types::DataSourceToIndexFieldMapping>]
1219
1212
  #
1220
1213
  # @!attribute [rw] change_detecting_columns
@@ -1272,7 +1265,7 @@ module Aws::Kendra
1272
1265
  # Defines how attachment metadata fields should be mapped to index
1273
1266
  # fields. Before you can map a field, you must first create an index
1274
1267
  # field with a matching type using the console or the `UpdateIndex`
1275
- # operation.
1268
+ # API.
1276
1269
  #
1277
1270
  # If you specify the `AttachentFieldMappings` parameter, you must
1278
1271
  # specify at least one field mapping.
@@ -1290,8 +1283,7 @@ module Aws::Kendra
1290
1283
  # Defines the mapping between a field in the Confluence data source to a
1291
1284
  # Amazon Kendra index field.
1292
1285
  #
1293
- # You must first create the index field using the `UpdateIndex`
1294
- # operation.
1286
+ # You must first create the index field using the `UpdateIndex` API.
1295
1287
  #
1296
1288
  # @note When making an API call, you may pass ConfluenceAttachmentToIndexFieldMapping
1297
1289
  # data as a hash:
@@ -1305,8 +1297,7 @@ module Aws::Kendra
1305
1297
  # @!attribute [rw] data_source_field_name
1306
1298
  # The name of the field in the data source.
1307
1299
  #
1308
- # You must first create the index field using the `UpdateIndex`
1309
- # operation.
1300
+ # You must first create the index field using the `UpdateIndex` API.
1310
1301
  # @return [String]
1311
1302
  #
1312
1303
  # @!attribute [rw] date_field_format
@@ -1334,7 +1325,7 @@ module Aws::Kendra
1334
1325
  # Specifies the blog settings for the Confluence data source. Blogs are
1335
1326
  # always indexed unless filtered from the index by the
1336
1327
  # `ExclusionPatterns` or `InclusionPatterns` fields in the
1337
- # `ConfluenceConfiguration` type.
1328
+ # `ConfluenceConfiguration` object.
1338
1329
  #
1339
1330
  # @note When making an API call, you may pass ConfluenceBlogConfiguration
1340
1331
  # data as a hash:
@@ -1352,8 +1343,7 @@ module Aws::Kendra
1352
1343
  # @!attribute [rw] blog_field_mappings
1353
1344
  # Defines how blog metadata fields should be mapped to index fields.
1354
1345
  # Before you can map a field, you must first create an index field
1355
- # with a matching type using the console or the `UpdateIndex`
1356
- # operation.
1346
+ # with a matching type using the console or the `UpdateIndex` API.
1357
1347
  #
1358
1348
  # If you specify the `BlogFieldMappings` parameter, you must specify
1359
1349
  # at least one field mapping.
@@ -1370,8 +1360,7 @@ module Aws::Kendra
1370
1360
  # Defines the mapping between a blog field in the Confluence data source
1371
1361
  # to a Amazon Kendra index field.
1372
1362
  #
1373
- # You must first create the index field using the `UpdateIndex`
1374
- # operation.
1363
+ # You must first create the index field using the `UpdateIndex` API.
1375
1364
  #
1376
1365
  # @note When making an API call, you may pass ConfluenceBlogToIndexFieldMapping
1377
1366
  # data as a hash:
@@ -1566,8 +1555,7 @@ module Aws::Kendra
1566
1555
  # @!attribute [rw] page_field_mappings
1567
1556
  # Defines how page metadata fields should be mapped to index fields.
1568
1557
  # Before you can map a field, you must first create an index field
1569
- # with a matching type using the console or the `UpdateIndex`
1570
- # operation.
1558
+ # with a matching type using the console or the `UpdateIndex` API.
1571
1559
  #
1572
1560
  # If you specify the `PageFieldMappings` parameter, you must specify
1573
1561
  # at least one field mapping.
@@ -1584,8 +1572,7 @@ module Aws::Kendra
1584
1572
  # Defines the mapping between a field in the Confluence data source to a
1585
1573
  # Amazon Kendra index field.
1586
1574
  #
1587
- # You must first create the index field using the `UpdateIndex`
1588
- # operation.
1575
+ # You must first create the index field using the `UpdateIndex` API.
1589
1576
  #
1590
1577
  # @note When making an API call, you may pass ConfluencePageToIndexFieldMapping
1591
1578
  # data as a hash:
@@ -1676,8 +1663,7 @@ module Aws::Kendra
1676
1663
  # @!attribute [rw] space_field_mappings
1677
1664
  # Defines how space metadata fields should be mapped to index fields.
1678
1665
  # Before you can map a field, you must first create an index field
1679
- # with a matching type using the console or the `UpdateIndex`
1680
- # operation.
1666
+ # with a matching type using the console or the `UpdateIndex` API.
1681
1667
  #
1682
1668
  # If you specify the `SpaceFieldMappings` parameter, you must specify
1683
1669
  # at least one field mapping.
@@ -1695,11 +1681,10 @@ module Aws::Kendra
1695
1681
  include Aws::Structure
1696
1682
  end
1697
1683
 
1698
- # Defines the mapping between a field in the Confluence data source to a
1699
- # Amazon Kendra index field.
1684
+ # Defines the mapping between a field in the Confluence data source to
1685
+ # an Amazon Kendra index field.
1700
1686
  #
1701
- # You must first create the index field using the `UpdateIndex`
1702
- # operation.
1687
+ # You must first create the index field using the `UpdateIndex` API.
1703
1688
  #
1704
1689
  # @note When making an API call, you may pass ConfluenceSpaceToIndexFieldMapping
1705
1690
  # data as a hash:
@@ -1819,7 +1804,7 @@ module Aws::Kendra
1819
1804
  #
1820
1805
  # @!attribute [rw] direct_put_content
1821
1806
  # `TRUE` to use documents you indexed directly using the
1822
- # `BatchPutDocument` operation.
1807
+ # `BatchPutDocument` API.
1823
1808
  # @return [Boolean]
1824
1809
  #
1825
1810
  # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/ContentSourceConfiguration AWS API Documentation
@@ -1838,7 +1823,7 @@ module Aws::Kendra
1838
1823
  # {
1839
1824
  # name: "DataSourceName", # required
1840
1825
  # index_id: "IndexId", # required
1841
- # type: "S3", # required, accepts S3, SHAREPOINT, DATABASE, SALESFORCE, ONEDRIVE, SERVICENOW, CUSTOM, CONFLUENCE, GOOGLEDRIVE, WEBCRAWLER, WORKDOCS
1826
+ # type: "S3", # required, accepts S3, SHAREPOINT, DATABASE, SALESFORCE, ONEDRIVE, SERVICENOW, CUSTOM, CONFLUENCE, GOOGLEDRIVE, WEBCRAWLER, WORKDOCS, FSX
1842
1827
  # configuration: {
1843
1828
  # s3_configuration: {
1844
1829
  # bucket_name: "S3BucketName", # required
@@ -2150,6 +2135,24 @@ module Aws::Kendra
2150
2135
  # },
2151
2136
  # ],
2152
2137
  # },
2138
+ # fsx_configuration: {
2139
+ # file_system_id: "FileSystemId", # required
2140
+ # file_system_type: "WINDOWS", # required, accepts WINDOWS
2141
+ # vpc_configuration: { # required
2142
+ # subnet_ids: ["SubnetId"], # required
2143
+ # security_group_ids: ["VpcSecurityGroupId"], # required
2144
+ # },
2145
+ # secret_arn: "SecretArn",
2146
+ # inclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
2147
+ # exclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
2148
+ # field_mappings: [
2149
+ # {
2150
+ # data_source_field_name: "DataSourceFieldName", # required
2151
+ # date_field_format: "DataSourceDateFieldFormat",
2152
+ # index_field_name: "IndexFieldName", # required
2153
+ # },
2154
+ # ],
2155
+ # },
2153
2156
  # },
2154
2157
  # description: "Description",
2155
2158
  # schedule: "ScanSchedule",
@@ -2251,10 +2254,10 @@ module Aws::Kendra
2251
2254
  # @return [String]
2252
2255
  #
2253
2256
  # @!attribute [rw] schedule
2254
- # Sets the frequency that Amazon Kendra will check the documents in
2255
- # your repository and update the index. If you don't set a schedule
2256
- # Amazon Kendra will not periodically update the index. You can call
2257
- # the `StartDataSourceSyncJob` operation to update the index.
2257
+ # Sets the frequency for Amazon Kendra to check the documents in your
2258
+ # repository and update the index. If you don't set a schedule Amazon
2259
+ # Kendra will not periodically update the index. You can call the
2260
+ # `StartDataSourceSyncJob` API to update the index.
2258
2261
  #
2259
2262
  # You can't specify the `Schedule` parameter when the `Type`
2260
2263
  # parameter is set to `CUSTOM`. If you do, you receive a
@@ -2285,8 +2288,8 @@ module Aws::Kendra
2285
2288
  #
2286
2289
  # @!attribute [rw] client_token
2287
2290
  # A token that you provide to identify the request to create a data
2288
- # source. Multiple calls to the `CreateDataSource` operation with the
2289
- # same client token will create only one data source.
2291
+ # source. Multiple calls to the `CreateDataSource` API with the same
2292
+ # client token will create only one data source.
2290
2293
  #
2291
2294
  # **A suitable default value is auto-generated.** You should normally
2292
2295
  # not need to pass this option.
@@ -2379,10 +2382,9 @@ module Aws::Kendra
2379
2382
  #
2380
2383
  # @!attribute [rw] role_arn
2381
2384
  # The Amazon Resource Name (ARN) of a role with permission to access
2382
- # `Query` operations, `QuerySuggestions` operations, `SubmitFeedback`
2383
- # operations, and Amazon Web Services SSO that stores your user and
2384
- # group information. For more information, see [IAM roles for Amazon
2385
- # Kendra][1].
2385
+ # `Query` API, `QuerySuggestions` API, `SubmitFeedback` API, and
2386
+ # Amazon Web Services SSO that stores your user and group information.
2387
+ # For more information, see [IAM roles for Amazon Kendra][1].
2386
2388
  #
2387
2389
  #
2388
2390
  #
@@ -2404,7 +2406,7 @@ module Aws::Kendra
2404
2406
  # @!attribute [rw] client_token
2405
2407
  # A token that you provide to identify the request to create your
2406
2408
  # Amazon Kendra experience. Multiple calls to the `CreateExperience`
2407
- # operation with the same client token creates only one Amazon Kendra
2409
+ # API with the same client token creates only one Amazon Kendra
2408
2410
  # experience.
2409
2411
  #
2410
2412
  # **A suitable default value is auto-generated.** You should normally
@@ -2508,8 +2510,8 @@ module Aws::Kendra
2508
2510
  #
2509
2511
  # @!attribute [rw] client_token
2510
2512
  # A token that you provide to identify the request to create a FAQ.
2511
- # Multiple calls to the `CreateFaqRequest` operation with the same
2512
- # client token will create only one FAQ.
2513
+ # Multiple calls to the `CreateFaqRequest` API with the same client
2514
+ # token will create only one FAQ.
2513
2515
  #
2514
2516
  # **A suitable default value is auto-generated.** You should normally
2515
2517
  # not need to pass this option.
@@ -2620,8 +2622,8 @@ module Aws::Kendra
2620
2622
  # @!attribute [rw] role_arn
2621
2623
  # An Identity and Access Management(IAM) role that gives Amazon Kendra
2622
2624
  # permissions to access your Amazon CloudWatch logs and metrics. This
2623
- # is also the role used when you use the `BatchPutDocument` operation
2624
- # to index documents from an Amazon S3 bucket.
2625
+ # is also the role used when you use the `BatchPutDocument` API to
2626
+ # index documents from an Amazon S3 bucket.
2625
2627
  # @return [String]
2626
2628
  #
2627
2629
  # @!attribute [rw] server_side_encryption_configuration
@@ -2636,8 +2638,8 @@ module Aws::Kendra
2636
2638
  #
2637
2639
  # @!attribute [rw] client_token
2638
2640
  # A token that you provide to identify the request to create an index.
2639
- # Multiple calls to the `CreateIndex` operation with the same client
2640
- # token will create only one index.
2641
+ # Multiple calls to the `CreateIndex` API with the same client token
2642
+ # will create only one index.
2641
2643
  #
2642
2644
  # **A suitable default value is auto-generated.** You should normally
2643
2645
  # not need to pass this option.
@@ -2778,10 +2780,10 @@ module Aws::Kendra
2778
2780
  # The IAM (Identity and Access Management) role used by Amazon Kendra
2779
2781
  # to access the block list text file in your S3 bucket.
2780
2782
  #
2781
- # You need permissions to the role ARN (Amazon Resource Name). The
2782
- # role needs S3 read permissions to your file in S3 and needs to give
2783
- # STS (Security Token Service) assume role permissions to Amazon
2784
- # Kendra.
2783
+ # You need permissions to the role ARN (Amazon Web Services Resource
2784
+ # Name). The role needs S3 read permissions to your file in S3 and
2785
+ # needs to give STS (Security Token Service) assume role permissions
2786
+ # to Amazon Kendra.
2785
2787
  # @return [String]
2786
2788
  #
2787
2789
  # @!attribute [rw] tags
@@ -2865,8 +2867,8 @@ module Aws::Kendra
2865
2867
  #
2866
2868
  # @!attribute [rw] client_token
2867
2869
  # A token that you provide to identify the request to create a
2868
- # thesaurus. Multiple calls to the `CreateThesaurus` operation with
2869
- # the same client token will create only one thesaurus.
2870
+ # thesaurus. Multiple calls to the `CreateThesaurus` API with the same
2871
+ # client token will create only one thesaurus.
2870
2872
  #
2871
2873
  # **A suitable default value is auto-generated.** You should normally
2872
2874
  # not need to pass this option.
@@ -3336,6 +3338,24 @@ module Aws::Kendra
3336
3338
  # },
3337
3339
  # ],
3338
3340
  # },
3341
+ # fsx_configuration: {
3342
+ # file_system_id: "FileSystemId", # required
3343
+ # file_system_type: "WINDOWS", # required, accepts WINDOWS
3344
+ # vpc_configuration: { # required
3345
+ # subnet_ids: ["SubnetId"], # required
3346
+ # security_group_ids: ["VpcSecurityGroupId"], # required
3347
+ # },
3348
+ # secret_arn: "SecretArn",
3349
+ # inclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
3350
+ # exclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
3351
+ # field_mappings: [
3352
+ # {
3353
+ # data_source_field_name: "DataSourceFieldName", # required
3354
+ # date_field_format: "DataSourceDateFieldFormat",
3355
+ # index_field_name: "IndexFieldName", # required
3356
+ # },
3357
+ # ],
3358
+ # },
3339
3359
  # }
3340
3360
  #
3341
3361
  # @!attribute [rw] s3_configuration
@@ -3384,10 +3404,15 @@ module Aws::Kendra
3384
3404
  # @return [Types::WebCrawlerConfiguration]
3385
3405
  #
3386
3406
  # @!attribute [rw] work_docs_configuration
3387
- # Provides the configuration information to connect to WorkDocs as
3388
- # your data source.
3407
+ # Provides the configuration information to connect to Amazon WorkDocs
3408
+ # as your data source.
3389
3409
  # @return [Types::WorkDocsConfiguration]
3390
3410
  #
3411
+ # @!attribute [rw] fsx_configuration
3412
+ # Provides the configuration information to connect to Amazon FSx as
3413
+ # your data source.
3414
+ # @return [Types::FsxConfiguration]
3415
+ #
3391
3416
  # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DataSourceConfiguration AWS API Documentation
3392
3417
  #
3393
3418
  class DataSourceConfiguration < Struct.new(
@@ -3400,7 +3425,8 @@ module Aws::Kendra
3400
3425
  :confluence_configuration,
3401
3426
  :google_drive_configuration,
3402
3427
  :web_crawler_configuration,
3403
- :work_docs_configuration)
3428
+ :work_docs_configuration,
3429
+ :fsx_configuration)
3404
3430
  SENSITIVE = []
3405
3431
  include Aws::Structure
3406
3432
  end
@@ -3436,8 +3462,8 @@ module Aws::Kendra
3436
3462
  include Aws::Structure
3437
3463
  end
3438
3464
 
3439
- # Summary information for a Amazon Kendra data source. Returned in a
3440
- # call to the `DescribeDataSource` operation.
3465
+ # Summary information for an Amazon Kendra data source. Returned in a
3466
+ # call to the `DescribeDataSource` API.
3441
3467
  #
3442
3468
  # @!attribute [rw] name
3443
3469
  # The name of the data source.
@@ -3489,18 +3515,18 @@ module Aws::Kendra
3489
3515
  include Aws::Structure
3490
3516
  end
3491
3517
 
3492
- # Provides information about a synchronization job.
3518
+ # Provides information about a data source synchronization job.
3493
3519
  #
3494
3520
  # @!attribute [rw] execution_id
3495
3521
  # A unique identifier for the synchronization job.
3496
3522
  # @return [String]
3497
3523
  #
3498
3524
  # @!attribute [rw] start_time
3499
- # The UNIX datetime that the synchronization job was started.
3525
+ # The UNIX datetime that the synchronization job started.
3500
3526
  # @return [Time]
3501
3527
  #
3502
3528
  # @!attribute [rw] end_time
3503
- # The UNIX datetime that the synchronization job was completed.
3529
+ # The UNIX datetime that the synchronization job completed.
3504
3530
  # @return [Time]
3505
3531
  #
3506
3532
  # @!attribute [rw] status
@@ -3518,7 +3544,7 @@ module Aws::Kendra
3518
3544
  #
3519
3545
  # @!attribute [rw] error_code
3520
3546
  # If the `Status` field is set to `FAILED`, the `ErrorCode` field
3521
- # contains a the reason that the synchronization failed.
3547
+ # indicates the reason the synchronization failed.
3522
3548
  # @return [String]
3523
3549
  #
3524
3550
  # @!attribute [rw] data_source_error_code
@@ -3626,8 +3652,7 @@ module Aws::Kendra
3626
3652
  end
3627
3653
 
3628
3654
  # Maps a column or attribute in the data source to an index field. You
3629
- # must first create the fields in the index using the `UpdateIndex`
3630
- # operation.
3655
+ # must first create the fields in the index using the `UpdateIndex` API.
3631
3656
  #
3632
3657
  # @note When making an API call, you may pass DataSourceToIndexFieldMapping
3633
3658
  # data as a hash:
@@ -4048,7 +4073,7 @@ module Aws::Kendra
4048
4073
  # @return [String]
4049
4074
  #
4050
4075
  # @!attribute [rw] schedule
4051
- # The schedule that Amazon Kendra will update the data source.
4076
+ # The schedule for Amazon Kendra to update the index.
4052
4077
  # @return [String]
4053
4078
  #
4054
4079
  # @!attribute [rw] role_arn
@@ -4182,9 +4207,9 @@ module Aws::Kendra
4182
4207
  #
4183
4208
  # @!attribute [rw] role_arn
4184
4209
  # Shows the Amazon Resource Name (ARN) of a role with permission to
4185
- # access `Query` operations, `QuerySuggestions` operations,
4186
- # `SubmitFeedback` operations, and Amazon Web Services SSO that stores
4187
- # your user and group information.
4210
+ # access `Query` API, `QuerySuggestions` API, `SubmitFeedback` API,
4211
+ # and Amazon Web Services SSO that stores your user and group
4212
+ # information.
4188
4213
  # @return [String]
4189
4214
  #
4190
4215
  # @!attribute [rw] error_message
@@ -4649,7 +4674,7 @@ module Aws::Kendra
4649
4674
  #
4650
4675
  # By default, Amazon Kendra enables query suggestions.`LEARN_ONLY`
4651
4676
  # turns off query suggestions for your users. You can change the mode
4652
- # using the [UpdateQuerySuggestionsConfig][1] operation.
4677
+ # using the [UpdateQuerySuggestionsConfig][1] API.
4653
4678
  #
4654
4679
  #
4655
4680
  #
@@ -4987,9 +5012,9 @@ module Aws::Kendra
4987
5012
  #
4988
5013
  # Documents passed to the `Blob` parameter must be base64 encoded.
4989
5014
  # Your code might not need to encode the document file bytes if
4990
- # you're using an Amazon Web Services SDK to call Amazon Kendra
4991
- # operations. If you are calling the Amazon Kendra endpoint directly
4992
- # using REST, you must base64 encode the contents before sending.
5015
+ # you're using an Amazon Web Services SDK to call Amazon Kendra APIs.
5016
+ # If you are calling the Amazon Kendra endpoint directly using REST,
5017
+ # you must base64 encode the contents before sending.
4993
5018
  # @return [String]
4994
5019
  #
4995
5020
  # @!attribute [rw] s3_path
@@ -5001,6 +5026,12 @@ module Aws::Kendra
5001
5026
  # attributes to provide additional information for searching, to
5002
5027
  # provide facets for refining searches, and to provide additional
5003
5028
  # information in the query response.
5029
+ #
5030
+ # For example, 'DataSourceId' and 'DataSourceSyncJobId' are custom
5031
+ # attributes that provide information on the synchronization of
5032
+ # documents running on a data source. Note, 'DataSourceSyncJobId'
5033
+ # could be an optional custom attribute as Amazon Kendra will use the
5034
+ # ID of a running sync job.
5004
5035
  # @return [Array<Types::DocumentAttribute>]
5005
5036
  #
5006
5037
  # @!attribute [rw] access_control_list
@@ -5038,6 +5069,13 @@ module Aws::Kendra
5038
5069
 
5039
5070
  # A custom attribute value assigned to a document.
5040
5071
  #
5072
+ # For more information on how to create custom document attributes, see
5073
+ # [Custom Attributes][1].
5074
+ #
5075
+ #
5076
+ #
5077
+ # [1]: https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html
5078
+ #
5041
5079
  # @note When making an API call, you may pass DocumentAttribute
5042
5080
  # data as a hash:
5043
5081
  #
@@ -5235,9 +5273,9 @@ module Aws::Kendra
5235
5273
  # A date expressed as an ISO 8601 string.
5236
5274
  #
5237
5275
  # It is important for the time zone to be included in the ISO 8601
5238
- # date-time format. For example, 20120325T123010+01:00 is the ISO 8601
5239
- # date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in
5240
- # Central European Time.
5276
+ # date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO
5277
+ # 8601 date-time format for March 25th 2012 at 12:30PM (plus 10
5278
+ # seconds) in Central European Time.
5241
5279
  # @return [Time]
5242
5280
  #
5243
5281
  # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/DocumentAttributeValue AWS API Documentation
@@ -5570,8 +5608,8 @@ module Aws::Kendra
5570
5608
  # @!attribute [rw] content_source_configuration
5571
5609
  # The identifiers of your data sources and FAQs. Or, you can specify
5572
5610
  # that you want to use documents indexed via the `BatchPutDocument`
5573
- # operation. This is the content you want to use for your Amazon
5574
- # Kendra experience.
5611
+ # API. This is the content you want to use for your Amazon Kendra
5612
+ # experience.
5575
5613
  # @return [Types::ContentSourceConfiguration]
5576
5614
  #
5577
5615
  # @!attribute [rw] user_identity_configuration
@@ -5830,6 +5868,117 @@ module Aws::Kendra
5830
5868
  include Aws::Structure
5831
5869
  end
5832
5870
 
5871
+ # Provides the configuration information to connect to Amazon FSx as
5872
+ # your data source.
5873
+ #
5874
+ # @note When making an API call, you may pass FsxConfiguration
5875
+ # data as a hash:
5876
+ #
5877
+ # {
5878
+ # file_system_id: "FileSystemId", # required
5879
+ # file_system_type: "WINDOWS", # required, accepts WINDOWS
5880
+ # vpc_configuration: { # required
5881
+ # subnet_ids: ["SubnetId"], # required
5882
+ # security_group_ids: ["VpcSecurityGroupId"], # required
5883
+ # },
5884
+ # secret_arn: "SecretArn",
5885
+ # inclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
5886
+ # exclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
5887
+ # field_mappings: [
5888
+ # {
5889
+ # data_source_field_name: "DataSourceFieldName", # required
5890
+ # date_field_format: "DataSourceDateFieldFormat",
5891
+ # index_field_name: "IndexFieldName", # required
5892
+ # },
5893
+ # ],
5894
+ # }
5895
+ #
5896
+ # @!attribute [rw] file_system_id
5897
+ # The identifier of the Amazon FSx file system.
5898
+ #
5899
+ # You can find your file system ID on the file system dashboard in the
5900
+ # Amazon FSx console. For information on how to create a file system
5901
+ # in Amazon FSx console, using Windows File Server as an example, see
5902
+ # [Amazon FSx Getting started guide][1].
5903
+ #
5904
+ #
5905
+ #
5906
+ # [1]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/getting-started-step1.html
5907
+ # @return [String]
5908
+ #
5909
+ # @!attribute [rw] file_system_type
5910
+ # The Amazon FSx file system type. Windows is currently the only
5911
+ # supported type.
5912
+ # @return [String]
5913
+ #
5914
+ # @!attribute [rw] vpc_configuration
5915
+ # Provides the configuration information for connecting to an Amazon
5916
+ # Virtual Private Cloud for your Amazon FSx. Your Amazon FSx instance
5917
+ # must reside inside your VPC.
5918
+ # @return [Types::DataSourceVpcConfiguration]
5919
+ #
5920
+ # @!attribute [rw] secret_arn
5921
+ # The Amazon Resource Name (ARN) of an Secrets Manager secret that
5922
+ # contains the key-value pairs required to connect to your Amazon FSx
5923
+ # file system. Windows is currently the only supported type. The
5924
+ # secret must contain a JSON structure with the following keys:
5925
+ #
5926
+ # * username—The Active Directory user name, along with the Domain
5927
+ # Name System (DNS) domain name. For example,
5928
+ # *user@corp.example.com*. The Active Directory user account must
5929
+ # have read and mounting access to the Amazon FSx file system for
5930
+ # Windows.
5931
+ #
5932
+ # * password—The password of the active directory user with read and
5933
+ # mounting access Amazon FSx Windows file system.
5934
+ # @return [String]
5935
+ #
5936
+ # @!attribute [rw] inclusion_patterns
5937
+ # A list of regular expression patterns to include certain files in
5938
+ # your Amazon FSx file system. Files that match the patterns are
5939
+ # included in the index. Files that don't match the patterns are
5940
+ # excluded from the index. If a file matches both an inclusion pattern
5941
+ # and an exclusion pattern, the exclusion pattern takes precedence and
5942
+ # the file isn't included in the index.
5943
+ # @return [Array<String>]
5944
+ #
5945
+ # @!attribute [rw] exclusion_patterns
5946
+ # A list of regular expression patterns to exclude certain files in
5947
+ # your Amazon FSx file system. Files that match the patterns are
5948
+ # excluded from the index. Files that don’t match the patterns are
5949
+ # included in the index. If a file matches both an inclusion pattern
5950
+ # and an exclusion pattern, the exclusion pattern takes precedence and
5951
+ # the file isn't included in the index.
5952
+ # @return [Array<String>]
5953
+ #
5954
+ # @!attribute [rw] field_mappings
5955
+ # A list of `DataSourceToIndexFieldMapping` objects that map Amazon
5956
+ # FSx data source attributes or field names to Amazon Kendra index
5957
+ # field names in Amazon Kendra. To create custom fields, use the
5958
+ # `UpdateIndex` API before you map to Amazon FSx fields. For more
5959
+ # information, see [Mapping data source fields][1]. The Amazon FSx
5960
+ # data source field names must exist in your Amazon FSx custom
5961
+ # metadata.
5962
+ #
5963
+ #
5964
+ #
5965
+ # [1]: https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html
5966
+ # @return [Array<Types::DataSourceToIndexFieldMapping>]
5967
+ #
5968
+ # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/FsxConfiguration AWS API Documentation
5969
+ #
5970
+ class FsxConfiguration < Struct.new(
5971
+ :file_system_id,
5972
+ :file_system_type,
5973
+ :vpc_configuration,
5974
+ :secret_arn,
5975
+ :inclusion_patterns,
5976
+ :exclusion_patterns,
5977
+ :field_mappings)
5978
+ SENSITIVE = []
5979
+ include Aws::Structure
5980
+ end
5981
+
5833
5982
  # @note When making an API call, you may pass GetQuerySuggestionsRequest
5834
5983
  # data as a hash:
5835
5984
  #
@@ -6049,7 +6198,7 @@ module Aws::Kendra
6049
6198
  #
6050
6199
  # If you are using the console, you can define index fields when
6051
6200
  # creating the mapping. If you are using the API, you must first
6052
- # create the field using the `UpdateIndex` operation.
6201
+ # create the field using the `UpdateIndex` API.
6053
6202
  # @return [Array<Types::DataSourceToIndexFieldMapping>]
6054
6203
  #
6055
6204
  # @!attribute [rw] exclude_mime_types
@@ -6289,18 +6438,17 @@ module Aws::Kendra
6289
6438
  # advanced alterations on the original or raw documents. If you want to
6290
6439
  # apply advanced alterations on the Amazon Kendra structured documents,
6291
6440
  # you must configure your Lambda function using
6292
- # [PostExtractionHookConfiguration][2]. You can only invoke one Lambda
6441
+ # [PostExtractionHookConfiguration][1]. You can only invoke one Lambda
6293
6442
  # function. However, this function can invoke other functions it
6294
6443
  # requires.
6295
6444
  #
6296
6445
  # For more information, see [Customizing document metadata during the
6297
- # ingestion process][3].
6446
+ # ingestion process][2].
6298
6447
  #
6299
6448
  #
6300
6449
  #
6301
- # [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_PreExtractionHookConfiguration.html
6302
- # [2]: https://docs.aws.amazon.com/kendra/latest/dg/API_PostExtractionHookConfiguration.html
6303
- # [3]: https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html
6450
+ # [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_CustomDocumentEnrichmentConfiguration.html
6451
+ # [2]: https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html
6304
6452
  #
6305
6453
  # @note When making an API call, you may pass HookConfiguration
6306
6454
  # data as a hash:
@@ -6366,7 +6514,7 @@ module Aws::Kendra
6366
6514
  #
6367
6515
  # @!attribute [rw] id
6368
6516
  # A unique identifier for the index. Use this to identify the index
6369
- # when you are using operations such as `Query`, `DescribeIndex`,
6517
+ # when you are using APIs such as `Query`, `DescribeIndex`,
6370
6518
  # `UpdateIndex`, and `DeleteIndex`.
6371
6519
  # @return [String]
6372
6520
  #
@@ -6381,7 +6529,7 @@ module Aws::Kendra
6381
6529
  #
6382
6530
  # @!attribute [rw] updated_at
6383
6531
  # The Unix timestamp when the index was last updated by the
6384
- # `UpdateIndex` operation.
6532
+ # `UpdateIndex` API.
6385
6533
  # @return [Time]
6386
6534
  #
6387
6535
  # @!attribute [rw] status
@@ -7649,7 +7797,7 @@ module Aws::Kendra
7649
7797
  #
7650
7798
  # {
7651
7799
  # index_id: "IndexId", # required
7652
- # query_text: "QueryText", # required
7800
+ # query_text: "QueryText",
7653
7801
  # attribute_filter: {
7654
7802
  # and_all_filters: [
7655
7803
  # {
@@ -7771,7 +7919,7 @@ module Aws::Kendra
7771
7919
  #
7772
7920
  # @!attribute [rw] index_id
7773
7921
  # The unique identifier of the index to search. The identifier is
7774
- # returned in the response from the `CreateIndex` operation.
7922
+ # returned in the response from the `CreateIndex` API.
7775
7923
  # @return [String]
7776
7924
  #
7777
7925
  # @!attribute [rw] query_text
@@ -7900,13 +8048,27 @@ module Aws::Kendra
7900
8048
  # items, you can only retrieve the first 100 of the items.
7901
8049
  # @return [Integer]
7902
8050
  #
8051
+ # @!attribute [rw] warnings
8052
+ # A list of warning codes and their messages on problems with your
8053
+ # query.
8054
+ #
8055
+ # Amazon Kendra currently only supports one type of warning, which is
8056
+ # a warning on invalid syntax used in the query. For examples of
8057
+ # invalid query syntax, see [Searching with advanced query syntax][1].
8058
+ #
8059
+ #
8060
+ #
8061
+ # [1]: https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax
8062
+ # @return [Array<Types::Warning>]
8063
+ #
7903
8064
  # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/QueryResult AWS API Documentation
7904
8065
  #
7905
8066
  class QueryResult < Struct.new(
7906
8067
  :query_id,
7907
8068
  :result_items,
7908
8069
  :facet_results,
7909
- :total_number_of_results)
8070
+ :total_number_of_results,
8071
+ :warnings)
7910
8072
  SENSITIVE = []
7911
8073
  include Aws::Structure
7912
8074
  end
@@ -8128,7 +8290,7 @@ module Aws::Kendra
8128
8290
  end
8129
8291
 
8130
8292
  # Provides feedback on how relevant a document is to a search. Your
8131
- # application uses the `SubmitFeedback` operation to provide relevance
8293
+ # application uses the `SubmitFeedback` API to provide relevance
8132
8294
  # information.
8133
8295
  #
8134
8296
  # @note When making an API call, you may pass RelevanceFeedback
@@ -9301,9 +9463,9 @@ module Aws::Kendra
9301
9463
  # @!attribute [rw] field_mappings
9302
9464
  # A list of `DataSourceToIndexFieldMapping` objects that map Microsoft
9303
9465
  # SharePoint attributes to custom fields in the Amazon Kendra index.
9304
- # You must first create the index fields using the `UpdateIndex`
9305
- # operation before you map SharePoint attributes. For more
9306
- # information, see [Mapping Data Source Fields][1].
9466
+ # You must first create the index fields using the `UpdateIndex` API
9467
+ # before you map SharePoint attributes. For more information, see
9468
+ # [Mapping Data Source Fields][1].
9307
9469
  #
9308
9470
  #
9309
9471
  #
@@ -9594,7 +9756,7 @@ module Aws::Kendra
9594
9756
  # @!attribute [rw] query_id
9595
9757
  # The identifier of the specific query for which you are submitting
9596
9758
  # feedback. The query ID is returned in the response to the `Query`
9597
- # operation.
9759
+ # API.
9598
9760
  # @return [String]
9599
9761
  #
9600
9762
  # @!attribute [rw] click_feedback_items
@@ -10225,6 +10387,24 @@ module Aws::Kendra
10225
10387
  # },
10226
10388
  # ],
10227
10389
  # },
10390
+ # fsx_configuration: {
10391
+ # file_system_id: "FileSystemId", # required
10392
+ # file_system_type: "WINDOWS", # required, accepts WINDOWS
10393
+ # vpc_configuration: { # required
10394
+ # subnet_ids: ["SubnetId"], # required
10395
+ # security_group_ids: ["VpcSecurityGroupId"], # required
10396
+ # },
10397
+ # secret_arn: "SecretArn",
10398
+ # inclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
10399
+ # exclusion_patterns: ["DataSourceInclusionsExclusionsStringsMember"],
10400
+ # field_mappings: [
10401
+ # {
10402
+ # data_source_field_name: "DataSourceFieldName", # required
10403
+ # date_field_format: "DataSourceDateFieldFormat",
10404
+ # index_field_name: "IndexFieldName", # required
10405
+ # },
10406
+ # ],
10407
+ # },
10228
10408
  # },
10229
10409
  # description: "Description",
10230
10410
  # schedule: "ScanSchedule",
@@ -10397,10 +10577,9 @@ module Aws::Kendra
10397
10577
  #
10398
10578
  # @!attribute [rw] role_arn
10399
10579
  # The Amazon Resource Name (ARN) of a role with permission to access
10400
- # `Query` operations, `QuerySuggestions` operations, `SubmitFeedback`
10401
- # operations, and Amazon Web Services SSO that stores your user and
10402
- # group information. For more information, see [IAM roles for Amazon
10403
- # Kendra][1].
10580
+ # `Query` API, `QuerySuggestions` API, `SubmitFeedback` API, and
10581
+ # Amazon Web Services SSO that stores your user and group information.
10582
+ # For more information, see [IAM roles for Amazon Kendra][1].
10404
10583
  #
10405
10584
  #
10406
10585
  #
@@ -10879,7 +11058,7 @@ module Aws::Kendra
10879
11058
  # Amazon Kendra filters search results for different users based on
10880
11059
  # their group's access to documents. You can also map your users to
10881
11060
  # their groups for user context filtering using the [PutPrincipalMapping
10882
- # operation][1].
11061
+ # API][1].
10883
11062
  #
10884
11063
  # To set up an Amazon Web Services SSO identity source in the console to
10885
11064
  # use with Amazon Kendra, see [Getting started with an Amazon Web
@@ -10887,6 +11066,12 @@ module Aws::Kendra
10887
11066
  # permissions to use Amazon Web Services SSO with Amazon Kendra. For
10888
11067
  # more information, see [IAM roles for Amazon Web Services SSO][3].
10889
11068
  #
11069
+ # Amazon Kendra currently does not support using
11070
+ # `UserGroupResolutionConfiguration` with an Amazon Web Services
11071
+ # organization member account for your Amazon Web Services SSO identify
11072
+ # source. You must create your index in the management account for the
11073
+ # organization in order to use `UserGroupResolutionConfiguration`.
11074
+ #
10890
11075
  #
10891
11076
  #
10892
11077
  # [1]: https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html
@@ -10998,6 +11183,25 @@ module Aws::Kendra
10998
11183
  include Aws::Structure
10999
11184
  end
11000
11185
 
11186
+ # The warning code and message that explains a problem with a query.
11187
+ #
11188
+ # @!attribute [rw] message
11189
+ # The message that explains the problem with the query.
11190
+ # @return [String]
11191
+ #
11192
+ # @!attribute [rw] code
11193
+ # The code used to show the type of warning for the query.
11194
+ # @return [String]
11195
+ #
11196
+ # @see http://docs.aws.amazon.com/goto/WebAPI/kendra-2019-02-03/Warning AWS API Documentation
11197
+ #
11198
+ class Warning < Struct.new(
11199
+ :message,
11200
+ :code)
11201
+ SENSITIVE = []
11202
+ include Aws::Structure
11203
+ end
11204
+
11001
11205
  # Provides the configuration information required for Amazon Kendra Web
11002
11206
  # Crawler.
11003
11207
  #
@@ -11247,9 +11451,9 @@ module Aws::Kendra
11247
11451
  # A list of `DataSourceToIndexFieldMapping` objects that map Amazon
11248
11452
  # WorkDocs field names to custom index field names in Amazon Kendra.
11249
11453
  # You must first create the custom index fields using the
11250
- # `UpdateIndex` operation before you map to Amazon WorkDocs fields.
11251
- # For more information, see [Mapping Data Source Fields][1]. The
11252
- # Amazon WorkDocs data source field names need to exist in your Amazon
11454
+ # `UpdateIndex` API before you map to Amazon WorkDocs fields. For more
11455
+ # information, see [Mapping Data Source Fields][1]. The Amazon
11456
+ # WorkDocs data source field names need to exist in your Amazon
11253
11457
  # WorkDocs custom metadata.
11254
11458
  #
11255
11459
  #