aws-sdk-kendra 1.40.0 → 1.44.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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
  #