@aws-sdk/client-kendra 3.379.1 → 3.385.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.
@@ -10,15 +10,18 @@ import { AdditionalResultAttribute, AttributeSuggestionsUpdateConfig, CapacityUn
10
10
  */
11
11
  export interface QueryResultItem {
12
12
  /**
13
+ * @public
13
14
  * <p>The identifier for the query result.</p>
14
15
  */
15
16
  Id?: string;
16
17
  /**
18
+ * @public
17
19
  * <p>The type of document within the response. For example, a response could include a
18
20
  * question-answer that's relevant to the query.</p>
19
21
  */
20
22
  Type?: QueryResultType | string;
21
23
  /**
24
+ * @public
22
25
  * <p>If the <code>Type</code> of document within the response is <code>ANSWER</code>, then it
23
26
  * is either a <code>TABLE</code> answer or <code>TEXT</code> answer. If it's a table answer,
24
27
  * a table excerpt is returned in <code>TableExcerpt</code>. If it's a text answer, a text
@@ -26,34 +29,41 @@ export interface QueryResultItem {
26
29
  */
27
30
  Format?: QueryResultFormat | string;
28
31
  /**
32
+ * @public
29
33
  * <p>One or more additional fields/attributes associated with the query result.</p>
30
34
  */
31
35
  AdditionalAttributes?: AdditionalResultAttribute[];
32
36
  /**
37
+ * @public
33
38
  * <p>The identifier for the document.</p>
34
39
  */
35
40
  DocumentId?: string;
36
41
  /**
42
+ * @public
37
43
  * <p>The title of the document. Contains the text of the title and information for
38
44
  * highlighting the relevant terms in the title.</p>
39
45
  */
40
46
  DocumentTitle?: TextWithHighlights;
41
47
  /**
48
+ * @public
42
49
  * <p>An extract of the text in the document. Contains information about highlighting the
43
50
  * relevant terms in the excerpt.</p>
44
51
  */
45
52
  DocumentExcerpt?: TextWithHighlights;
46
53
  /**
54
+ * @public
47
55
  * <p>The URI of the original location of the document.</p>
48
56
  */
49
57
  DocumentURI?: string;
50
58
  /**
59
+ * @public
51
60
  * <p>An array of document fields/attributes assigned to a document in the search results.
52
61
  * For example, the document author (<code>_author</code>) or the source URI
53
62
  * (<code>_source_uri</code>) of the document.</p>
54
63
  */
55
64
  DocumentAttributes?: DocumentAttribute[];
56
65
  /**
66
+ * @public
57
67
  * <p>Indicates the confidence level of Amazon Kendra providing a relevant result for
58
68
  * the query. Each result is placed into a bin that indicates the confidence,
59
69
  * <code>VERY_HIGH</code>, <code>HIGH</code>, <code>MEDIUM</code> and <code>LOW</code>.
@@ -65,11 +75,13 @@ export interface QueryResultItem {
65
75
  */
66
76
  ScoreAttributes?: ScoreAttributes;
67
77
  /**
78
+ * @public
68
79
  * <p>A token that identifies a particular result from a particular query. Use this token to
69
80
  * provide click-through feedback for the result. For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/submitting-feedback.html">Submitting feedback</a>.</p>
70
81
  */
71
82
  FeedbackToken?: string;
72
83
  /**
84
+ * @public
73
85
  * <p>An excerpt from a table within a document.</p>
74
86
  */
75
87
  TableExcerpt?: TableExcerpt;
@@ -80,20 +92,24 @@ export interface QueryResultItem {
80
92
  */
81
93
  export interface Correction {
82
94
  /**
95
+ * @public
83
96
  * <p>The zero-based location in the response string or text where
84
97
  * the corrected word starts.</p>
85
98
  */
86
99
  BeginOffset?: number;
87
100
  /**
101
+ * @public
88
102
  * <p>The zero-based location in the response string or text where
89
103
  * the corrected word ends.</p>
90
104
  */
91
105
  EndOffset?: number;
92
106
  /**
107
+ * @public
93
108
  * <p>The string or text of a misspelled word in a query.</p>
94
109
  */
95
110
  Term?: string;
96
111
  /**
112
+ * @public
97
113
  * <p>The string or text of a corrected misspelled word in a query.</p>
98
114
  */
99
115
  CorrectedTerm?: string;
@@ -104,10 +120,12 @@ export interface Correction {
104
120
  */
105
121
  export interface SpellCorrectedQuery {
106
122
  /**
123
+ * @public
107
124
  * <p>The query with the suggested spell corrections.</p>
108
125
  */
109
126
  SuggestedQueryText?: string;
110
127
  /**
128
+ * @public
111
129
  * <p>The corrected misspelled word or words in a query.</p>
112
130
  */
113
131
  Corrections?: Correction[];
@@ -129,10 +147,12 @@ export type WarningCode = (typeof WarningCode)[keyof typeof WarningCode];
129
147
  */
130
148
  export interface Warning {
131
149
  /**
150
+ * @public
132
151
  * <p>The message that explains the problem with the query.</p>
133
152
  */
134
153
  Message?: string;
135
154
  /**
155
+ * @public
136
156
  * <p>The code used to show the type of warning for the query.</p>
137
157
  */
138
158
  Code?: WarningCode | string;
@@ -143,26 +163,32 @@ export interface Warning {
143
163
  */
144
164
  export interface RetrieveResultItem {
145
165
  /**
166
+ * @public
146
167
  * <p>The identifier of the relevant passage result.</p>
147
168
  */
148
169
  Id?: string;
149
170
  /**
171
+ * @public
150
172
  * <p>The identifier of the document.</p>
151
173
  */
152
174
  DocumentId?: string;
153
175
  /**
176
+ * @public
154
177
  * <p>The title of the document.</p>
155
178
  */
156
179
  DocumentTitle?: string;
157
180
  /**
181
+ * @public
158
182
  * <p>The contents of the relevant passage.</p>
159
183
  */
160
184
  Content?: string;
161
185
  /**
186
+ * @public
162
187
  * <p>The URI of the original location of the document.</p>
163
188
  */
164
189
  DocumentURI?: string;
165
190
  /**
191
+ * @public
166
192
  * <p>An array of document fields/attributes assigned to a document in the
167
193
  * search results. For example, the document author (<code>_author</code>)
168
194
  * or the source URI (<code>_source_uri</code>) of the document.</p>
@@ -174,11 +200,13 @@ export interface RetrieveResultItem {
174
200
  */
175
201
  export interface RetrieveResult {
176
202
  /**
203
+ * @public
177
204
  * <p>The identifier of query used for the search. You also use <code>QueryId</code> to
178
205
  * identify the search when using the <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_SubmitFeedback.html">Submitfeedback</a> API.</p>
179
206
  */
180
207
  QueryId?: string;
181
208
  /**
209
+ * @public
182
210
  * <p>The results of the retrieved relevant passages for the search.</p>
183
211
  */
184
212
  ResultItems?: RetrieveResultItem[];
@@ -202,10 +230,12 @@ export declare class ResourceInUseException extends __BaseException {
202
230
  */
203
231
  export interface StartDataSourceSyncJobRequest {
204
232
  /**
233
+ * @public
205
234
  * <p>The identifier of the data source connector to synchronize.</p>
206
235
  */
207
236
  Id: string | undefined;
208
237
  /**
238
+ * @public
209
239
  * <p>The identifier of the index used with the data source connector.</p>
210
240
  */
211
241
  IndexId: string | undefined;
@@ -215,6 +245,7 @@ export interface StartDataSourceSyncJobRequest {
215
245
  */
216
246
  export interface StartDataSourceSyncJobResponse {
217
247
  /**
248
+ * @public
218
249
  * <p>Identifies a particular synchronization job.</p>
219
250
  */
220
251
  ExecutionId?: string;
@@ -224,11 +255,13 @@ export interface StartDataSourceSyncJobResponse {
224
255
  */
225
256
  export interface StopDataSourceSyncJobRequest {
226
257
  /**
258
+ * @public
227
259
  * <p>The identifier of the data source connector for which to stop the synchronization
228
260
  * jobs.</p>
229
261
  */
230
262
  Id: string | undefined;
231
263
  /**
264
+ * @public
232
265
  * <p>The identifier of the index used with the data source connector.</p>
233
266
  */
234
267
  IndexId: string | undefined;
@@ -241,10 +274,12 @@ export interface StopDataSourceSyncJobRequest {
241
274
  */
242
275
  export interface ClickFeedback {
243
276
  /**
277
+ * @public
244
278
  * <p>The identifier of the search result that was clicked.</p>
245
279
  */
246
280
  ResultId: string | undefined;
247
281
  /**
282
+ * @public
248
283
  * <p>The Unix timestamp when the result was clicked.</p>
249
284
  */
250
285
  ClickTime: Date | undefined;
@@ -268,11 +303,13 @@ export type RelevanceType = (typeof RelevanceType)[keyof typeof RelevanceType];
268
303
  */
269
304
  export interface RelevanceFeedback {
270
305
  /**
306
+ * @public
271
307
  * <p>The identifier of the search result that the user provided relevance feedback
272
308
  * for.</p>
273
309
  */
274
310
  ResultId: string | undefined;
275
311
  /**
312
+ * @public
276
313
  * <p>Whether the document was relevant or not relevant to the search.</p>
277
314
  */
278
315
  RelevanceValue: RelevanceType | string | undefined;
@@ -282,21 +319,25 @@ export interface RelevanceFeedback {
282
319
  */
283
320
  export interface SubmitFeedbackRequest {
284
321
  /**
322
+ * @public
285
323
  * <p>The identifier of the index that was queried.</p>
286
324
  */
287
325
  IndexId: string | undefined;
288
326
  /**
327
+ * @public
289
328
  * <p>The identifier of the specific query for which you are submitting
290
329
  * feedback. The query ID is returned in the response to the
291
330
  * <code>Query</code> API.</p>
292
331
  */
293
332
  QueryId: string | undefined;
294
333
  /**
334
+ * @public
295
335
  * <p>Tells Amazon Kendra that a particular search result link was chosen
296
336
  * by the user. </p>
297
337
  */
298
338
  ClickFeedbackItems?: ClickFeedback[];
299
339
  /**
340
+ * @public
300
341
  * <p>Provides Amazon Kendra with relevant or not relevant feedback for
301
342
  * whether a particular item was relevant to the search.</p>
302
343
  */
@@ -307,10 +348,12 @@ export interface SubmitFeedbackRequest {
307
348
  */
308
349
  export interface TagResourceRequest {
309
350
  /**
351
+ * @public
310
352
  * <p>The Amazon Resource Name (ARN) of the index, FAQ, or data source to tag.</p>
311
353
  */
312
354
  ResourceARN: string | undefined;
313
355
  /**
356
+ * @public
314
357
  * <p>A list of tag keys to add to the index, FAQ, or data source. If a tag already exists, the
315
358
  * existing value is replaced with the new value.</p>
316
359
  */
@@ -326,11 +369,13 @@ export interface TagResourceResponse {
326
369
  */
327
370
  export interface UntagResourceRequest {
328
371
  /**
372
+ * @public
329
373
  * <p>The Amazon Resource Name (ARN) of the index, FAQ, or data source to remove the tag
330
374
  * from.</p>
331
375
  */
332
376
  ResourceARN: string | undefined;
333
377
  /**
378
+ * @public
334
379
  * <p>A list of tag keys to remove from the index, FAQ, or data source. If a tag key does not
335
380
  * exist on the resource, it is ignored.</p>
336
381
  */
@@ -346,28 +391,34 @@ export interface UntagResourceResponse {
346
391
  */
347
392
  export interface UpdateAccessControlConfigurationRequest {
348
393
  /**
394
+ * @public
349
395
  * <p>The identifier of the index for an access control configuration.</p>
350
396
  */
351
397
  IndexId: string | undefined;
352
398
  /**
399
+ * @public
353
400
  * <p>The identifier of the access control configuration you want to update.</p>
354
401
  */
355
402
  Id: string | undefined;
356
403
  /**
404
+ * @public
357
405
  * <p>A new name for the access control configuration.</p>
358
406
  */
359
407
  Name?: string;
360
408
  /**
409
+ * @public
361
410
  * <p>A new description for the access control configuration.</p>
362
411
  */
363
412
  Description?: string;
364
413
  /**
414
+ * @public
365
415
  * <p>Information you want to update on principals (users and/or groups) and which documents
366
416
  * they should have access to. This is useful for user context filtering, where search
367
417
  * results are filtered based on the user or their group access to documents.</p>
368
418
  */
369
419
  AccessControlList?: Principal[];
370
420
  /**
421
+ * @public
371
422
  * <p>The updated list of <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_Principal.html">principal</a> lists that define the
372
423
  * hierarchy for which documents users should have access to.</p>
373
424
  */
@@ -383,40 +434,49 @@ export interface UpdateAccessControlConfigurationResponse {
383
434
  */
384
435
  export interface UpdateDataSourceRequest {
385
436
  /**
437
+ * @public
386
438
  * <p>The identifier of the data source connector you want to update.</p>
387
439
  */
388
440
  Id: string | undefined;
389
441
  /**
442
+ * @public
390
443
  * <p>A new name for the data source connector.</p>
391
444
  */
392
445
  Name?: string;
393
446
  /**
447
+ * @public
394
448
  * <p>The identifier of the index used with the data source connector.</p>
395
449
  */
396
450
  IndexId: string | undefined;
397
451
  /**
452
+ * @public
398
453
  * <p>Configuration information you want to update for the data source connector.</p>
399
454
  */
400
455
  Configuration?: DataSourceConfiguration;
401
456
  /**
457
+ * @public
402
458
  * <p>Configuration information for an Amazon Virtual Private Cloud to connect to your data source.
403
459
  * For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html">Configuring a VPC</a>.</p>
404
460
  */
405
461
  VpcConfiguration?: DataSourceVpcConfiguration;
406
462
  /**
463
+ * @public
407
464
  * <p>A new description for the data source connector.</p>
408
465
  */
409
466
  Description?: string;
410
467
  /**
468
+ * @public
411
469
  * <p>The sync schedule you want to update for the data source connector.</p>
412
470
  */
413
471
  Schedule?: string;
414
472
  /**
473
+ * @public
415
474
  * <p>The Amazon Resource Name (ARN) of a role with permission to access the data source and
416
475
  * required resources. For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html">IAM roles for Amazon Kendra</a>.</p>
417
476
  */
418
477
  RoleArn?: string;
419
478
  /**
479
+ * @public
420
480
  * <p>The code for a language you want to update for the data source connector.
421
481
  * This allows you to support a language for all
422
482
  * documents when updating the data source. English is supported
@@ -426,6 +486,7 @@ export interface UpdateDataSourceRequest {
426
486
  */
427
487
  LanguageCode?: string;
428
488
  /**
489
+ * @public
429
490
  * <p>Configuration information you want to update for altering document metadata and
430
491
  * content during the document ingestion process.</p>
431
492
  * <p>For more information on how to create, modify and delete document metadata, or make
@@ -438,18 +499,22 @@ export interface UpdateDataSourceRequest {
438
499
  */
439
500
  export interface UpdateExperienceRequest {
440
501
  /**
502
+ * @public
441
503
  * <p>The identifier of your Amazon Kendra experience you want to update.</p>
442
504
  */
443
505
  Id: string | undefined;
444
506
  /**
507
+ * @public
445
508
  * <p>A new name for your Amazon Kendra experience.</p>
446
509
  */
447
510
  Name?: string;
448
511
  /**
512
+ * @public
449
513
  * <p>The identifier of the index for your Amazon Kendra experience.</p>
450
514
  */
451
515
  IndexId: string | undefined;
452
516
  /**
517
+ * @public
453
518
  * <p>The Amazon Resource Name (ARN) of a role with permission to access <code>Query</code>
454
519
  * API, <code>QuerySuggestions</code> API, <code>SubmitFeedback</code>
455
520
  * API, and IAM Identity Center that stores your user and group information.
@@ -457,10 +522,12 @@ export interface UpdateExperienceRequest {
457
522
  */
458
523
  RoleArn?: string;
459
524
  /**
525
+ * @public
460
526
  * <p>Configuration information you want to update for your Amazon Kendra experience.</p>
461
527
  */
462
528
  Configuration?: ExperienceConfiguration;
463
529
  /**
530
+ * @public
464
531
  * <p>A new description for your Amazon Kendra experience.</p>
465
532
  */
466
533
  Description?: string;
@@ -470,22 +537,27 @@ export interface UpdateExperienceRequest {
470
537
  */
471
538
  export interface UpdateFeaturedResultsSetRequest {
472
539
  /**
540
+ * @public
473
541
  * <p>The identifier of the index used for featuring results.</p>
474
542
  */
475
543
  IndexId: string | undefined;
476
544
  /**
545
+ * @public
477
546
  * <p>The identifier of the set of featured results that you want to update.</p>
478
547
  */
479
548
  FeaturedResultsSetId: string | undefined;
480
549
  /**
550
+ * @public
481
551
  * <p>A new name for the set of featured results.</p>
482
552
  */
483
553
  FeaturedResultsSetName?: string;
484
554
  /**
555
+ * @public
485
556
  * <p>A new description for the set of featured results.</p>
486
557
  */
487
558
  Description?: string;
488
559
  /**
560
+ * @public
489
561
  * <p>You can set the status to <code>ACTIVE</code> or <code>INACTIVE</code>.
490
562
  * When the value is <code>ACTIVE</code>, featured results are ready for
491
563
  * use. You can still configure your settings before setting the status
@@ -495,11 +567,13 @@ export interface UpdateFeaturedResultsSetRequest {
495
567
  */
496
568
  Status?: FeaturedResultsSetStatus | string;
497
569
  /**
570
+ * @public
498
571
  * <p>A list of queries for featuring results. For more information on the
499
572
  * list of queries, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html">FeaturedResultsSet</a>.</p>
500
573
  */
501
574
  QueryTexts?: string[];
502
575
  /**
576
+ * @public
503
577
  * <p>A list of document IDs for the documents you want to feature at the
504
578
  * top of the search results page. For more information on the list of
505
579
  * featured documents, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html">FeaturedResultsSet</a>.</p>
@@ -511,6 +585,7 @@ export interface UpdateFeaturedResultsSetRequest {
511
585
  */
512
586
  export interface UpdateFeaturedResultsSetResponse {
513
587
  /**
588
+ * @public
514
589
  * <p>Information on the set of featured results. This includes the identifier
515
590
  * of the featured results set, whether the featured results set is active
516
591
  * or inactive, when the featured results set was last updated, and more.</p>
@@ -522,29 +597,35 @@ export interface UpdateFeaturedResultsSetResponse {
522
597
  */
523
598
  export interface UpdateIndexRequest {
524
599
  /**
600
+ * @public
525
601
  * <p>The identifier of the index you want to update.</p>
526
602
  */
527
603
  Id: string | undefined;
528
604
  /**
605
+ * @public
529
606
  * <p>The name of the index you want to update.</p>
530
607
  */
531
608
  Name?: string;
532
609
  /**
610
+ * @public
533
611
  * <p>An Identity and Access Management (IAM) role that gives Amazon Kendra
534
612
  * permission to access Amazon CloudWatch logs and metrics.</p>
535
613
  */
536
614
  RoleArn?: string;
537
615
  /**
616
+ * @public
538
617
  * <p>A new description for the index.</p>
539
618
  */
540
619
  Description?: string;
541
620
  /**
621
+ * @public
542
622
  * <p>The document metadata configuration you want to update for the index. Document metadata
543
623
  * are fields or attributes associated with your documents. For example, the company department
544
624
  * name associated with each document.</p>
545
625
  */
546
626
  DocumentMetadataConfigurationUpdates?: DocumentMetadataConfiguration[];
547
627
  /**
628
+ * @public
548
629
  * <p>Sets the number of additional document storage and query capacity units that should be
549
630
  * used by the index. You can change the capacity of the index up to 5 times per day, or make 5
550
631
  * API calls.</p>
@@ -553,14 +634,17 @@ export interface UpdateIndexRequest {
553
634
  */
554
635
  CapacityUnits?: CapacityUnitsConfiguration;
555
636
  /**
637
+ * @public
556
638
  * <p>The user token configuration.</p>
557
639
  */
558
640
  UserTokenConfigurations?: UserTokenConfiguration[];
559
641
  /**
642
+ * @public
560
643
  * <p>The user context policy.</p>
561
644
  */
562
645
  UserContextPolicy?: UserContextPolicy | string;
563
646
  /**
647
+ * @public
564
648
  * <p>Enables fetching access levels of groups and users from an IAM Identity Center (successor to Single Sign-On)
565
649
  * identity source. To configure this, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html">UserGroupResolutionConfiguration</a>.</p>
566
650
  */
@@ -571,22 +655,27 @@ export interface UpdateIndexRequest {
571
655
  */
572
656
  export interface UpdateQuerySuggestionsBlockListRequest {
573
657
  /**
658
+ * @public
574
659
  * <p>The identifier of the index for the block list.</p>
575
660
  */
576
661
  IndexId: string | undefined;
577
662
  /**
663
+ * @public
578
664
  * <p>The identifier of the block list you want to update.</p>
579
665
  */
580
666
  Id: string | undefined;
581
667
  /**
668
+ * @public
582
669
  * <p>A new name for the block list.</p>
583
670
  */
584
671
  Name?: string;
585
672
  /**
673
+ * @public
586
674
  * <p>A new description for the block list.</p>
587
675
  */
588
676
  Description?: string;
589
677
  /**
678
+ * @public
590
679
  * <p>The S3 path where your block list text file sits in S3.</p>
591
680
  * <p>If you update your block list and provide the same path to the
592
681
  * block list text file in S3, then Amazon Kendra reloads the file to refresh
@@ -599,6 +688,7 @@ export interface UpdateQuerySuggestionsBlockListRequest {
599
688
  */
600
689
  SourceS3Path?: S3Path;
601
690
  /**
691
+ * @public
602
692
  * <p>The IAM (Identity and Access Management) role used to access the
603
693
  * block list text file in S3.</p>
604
694
  */
@@ -609,10 +699,12 @@ export interface UpdateQuerySuggestionsBlockListRequest {
609
699
  */
610
700
  export interface UpdateQuerySuggestionsConfigRequest {
611
701
  /**
702
+ * @public
612
703
  * <p> The identifier of the index with query suggestions you want to update.</p>
613
704
  */
614
705
  IndexId: string | undefined;
615
706
  /**
707
+ * @public
616
708
  * <p>Set the mode to <code>ENABLED</code> or <code>LEARN_ONLY</code>.</p>
617
709
  * <p>By default, Amazon Kendra enables query suggestions.
618
710
  * <code>LEARN_ONLY</code> mode allows you to turn off query suggestions.
@@ -623,12 +715,14 @@ export interface UpdateQuerySuggestionsConfigRequest {
623
715
  */
624
716
  Mode?: Mode | string;
625
717
  /**
718
+ * @public
626
719
  * <p>How recent your queries are in your query log time window.</p>
627
720
  * <p>The time window is the number of days from current day to past days.</p>
628
721
  * <p>By default, Amazon Kendra sets this to 180.</p>
629
722
  */
630
723
  QueryLogLookBackWindowInDays?: number;
631
724
  /**
725
+ * @public
632
726
  * <p>
633
727
  * <code>TRUE</code> to include queries without user information (i.e. all queries,
634
728
  * irrespective of the user), otherwise <code>FALSE</code> to only include queries
@@ -644,6 +738,7 @@ export interface UpdateQuerySuggestionsConfigRequest {
644
738
  */
645
739
  IncludeQueriesWithoutUserInformation?: boolean;
646
740
  /**
741
+ * @public
647
742
  * <p>The minimum number of unique users who must search a query in order for the query
648
743
  * to be eligible to suggest to your users.</p>
649
744
  * <p>Increasing this number might decrease the number of suggestions. However, this
@@ -652,6 +747,7 @@ export interface UpdateQuerySuggestionsConfigRequest {
652
747
  */
653
748
  MinimumNumberOfQueryingUsers?: number;
654
749
  /**
750
+ * @public
655
751
  * <p>The the minimum number of times a query must be searched in order to be
656
752
  * eligible to suggest to your users.</p>
657
753
  * <p>Decreasing this number increases the number of suggestions. However, this
@@ -661,6 +757,7 @@ export interface UpdateQuerySuggestionsConfigRequest {
661
757
  */
662
758
  MinimumQueryCount?: number;
663
759
  /**
760
+ * @public
664
761
  * <p>Configuration information for the document fields/attributes that you want to base
665
762
  * query suggestions on.</p>
666
763
  */
@@ -671,27 +768,33 @@ export interface UpdateQuerySuggestionsConfigRequest {
671
768
  */
672
769
  export interface UpdateThesaurusRequest {
673
770
  /**
771
+ * @public
674
772
  * <p>The identifier of the thesaurus you want to update.</p>
675
773
  */
676
774
  Id: string | undefined;
677
775
  /**
776
+ * @public
678
777
  * <p>A new name for the thesaurus.</p>
679
778
  */
680
779
  Name?: string;
681
780
  /**
781
+ * @public
682
782
  * <p>The identifier of the index for the thesaurus.</p>
683
783
  */
684
784
  IndexId: string | undefined;
685
785
  /**
786
+ * @public
686
787
  * <p>A new description for the thesaurus.</p>
687
788
  */
688
789
  Description?: string;
689
790
  /**
791
+ * @public
690
792
  * <p>An IAM role that gives Amazon Kendra permissions to
691
793
  * access thesaurus file specified in <code>SourceS3Path</code>.</p>
692
794
  */
693
795
  RoleArn?: string;
694
796
  /**
797
+ * @public
695
798
  * <p>Information required to find a specific file in an Amazon S3 bucket.</p>
696
799
  */
697
800
  SourceS3Path?: S3Path;
@@ -708,10 +811,12 @@ export interface UpdateThesaurusRequest {
708
811
  */
709
812
  export interface Facet {
710
813
  /**
814
+ * @public
711
815
  * <p>The unique key for the document attribute.</p>
712
816
  */
713
817
  DocumentAttributeKey?: string;
714
818
  /**
819
+ * @public
715
820
  * <p>An array of document attributes that are nested facets within a facet.</p>
716
821
  * <p>For example, the document attribute or facet "Department" includes a value called
717
822
  * "Engineering". In addition, the document attribute or facet "SubDepartment" includes the
@@ -724,6 +829,7 @@ export interface Facet {
724
829
  */
725
830
  Facets?: Facet[];
726
831
  /**
832
+ * @public
727
833
  * <p>Maximum number of facet values per facet. The default is 10. You can use this to limit
728
834
  * the number of facet values to less than 10. If you want to increase the default, contact
729
835
  * <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
@@ -737,15 +843,18 @@ export interface Facet {
737
843
  */
738
844
  export interface DocumentAttributeValueCountPair {
739
845
  /**
846
+ * @public
740
847
  * <p>The value of the attribute. For example, "HR".</p>
741
848
  */
742
849
  DocumentAttributeValue?: DocumentAttributeValue;
743
850
  /**
851
+ * @public
744
852
  * <p>The number of documents in the response that have the attribute value for the
745
853
  * key.</p>
746
854
  */
747
855
  Count?: number;
748
856
  /**
857
+ * @public
749
858
  * <p>Contains the results of a document attribute that is a nested facet. A
750
859
  * <code>FacetResult</code> contains the counts for each facet nested within a
751
860
  * facet.</p>
@@ -766,16 +875,19 @@ export interface DocumentAttributeValueCountPair {
766
875
  */
767
876
  export interface FacetResult {
768
877
  /**
878
+ * @public
769
879
  * <p>The key for the facet values. This is the same as the <code>DocumentAttributeKey</code>
770
880
  * provided in the query.</p>
771
881
  */
772
882
  DocumentAttributeKey?: string;
773
883
  /**
884
+ * @public
774
885
  * <p>The data type of the facet value. This is the same as the type defined for the index
775
886
  * field when it was created.</p>
776
887
  */
777
888
  DocumentAttributeValueType?: DocumentAttributeValueType | string;
778
889
  /**
890
+ * @public
779
891
  * <p>An array of key/value pairs, where the key is the value of the attribute and the count
780
892
  * is the number of documents that share the key value.</p>
781
893
  */
@@ -810,50 +922,60 @@ export interface FacetResult {
810
922
  */
811
923
  export interface AttributeFilter {
812
924
  /**
925
+ * @public
813
926
  * <p>Performs a logical <code>AND</code> operation on all supplied filters.</p>
814
927
  */
815
928
  AndAllFilters?: AttributeFilter[];
816
929
  /**
930
+ * @public
817
931
  * <p>Performs a logical <code>OR</code> operation on all supplied filters.</p>
818
932
  */
819
933
  OrAllFilters?: AttributeFilter[];
820
934
  /**
935
+ * @public
821
936
  * <p>Performs a logical <code>NOT</code> operation on all supplied filters.</p>
822
937
  */
823
938
  NotFilter?: AttributeFilter;
824
939
  /**
940
+ * @public
825
941
  * <p>Performs an equals operation on two document attributes or metadata fields.</p>
826
942
  */
827
943
  EqualsTo?: DocumentAttribute;
828
944
  /**
945
+ * @public
829
946
  * <p>Returns true when a document contains all of the specified document attributes or
830
947
  * metadata fields. This filter is only applicable to <code>StringListValue</code>
831
948
  * metadata.</p>
832
949
  */
833
950
  ContainsAll?: DocumentAttribute;
834
951
  /**
952
+ * @public
835
953
  * <p>Returns true when a document contains any of the specified document attributes or
836
954
  * metadata fields. This filter is only applicable to <code>StringListValue</code>
837
955
  * metadata.</p>
838
956
  */
839
957
  ContainsAny?: DocumentAttribute;
840
958
  /**
959
+ * @public
841
960
  * <p>Performs a greater than operation on two document attributes or metadata fields. Use
842
961
  * with a document attribute of type <code>Date</code> or <code>Long</code>.</p>
843
962
  */
844
963
  GreaterThan?: DocumentAttribute;
845
964
  /**
965
+ * @public
846
966
  * <p>Performs a greater or equals than operation on two document attributes or metadata
847
967
  * fields. Use with a document attribute of type <code>Date</code> or
848
968
  * <code>Long</code>.</p>
849
969
  */
850
970
  GreaterThanOrEquals?: DocumentAttribute;
851
971
  /**
972
+ * @public
852
973
  * <p>Performs a less than operation on two document attributes or metadata fields. Use with a
853
974
  * document attribute of type <code>Date</code> or <code>Long</code>.</p>
854
975
  */
855
976
  LessThan?: DocumentAttribute;
856
977
  /**
978
+ * @public
857
979
  * <p>Performs a less than or equals operation on two document attributes or metadata fields.
858
980
  * Use with a document attribute of type <code>Date</code> or <code>Long</code>.</p>
859
981
  */
@@ -864,26 +986,31 @@ export interface AttributeFilter {
864
986
  */
865
987
  export interface QueryResult {
866
988
  /**
989
+ * @public
867
990
  * <p>The identifier for the search. You also use <code>QueryId</code> to identify the
868
991
  * search when using the <a href="https://docs.aws.amazon.com/kendra/latest/APIReference/API_SubmitFeedback.html">SubmitFeedback</a> API.</p>
869
992
  */
870
993
  QueryId?: string;
871
994
  /**
995
+ * @public
872
996
  * <p>The results of the search.</p>
873
997
  */
874
998
  ResultItems?: QueryResultItem[];
875
999
  /**
1000
+ * @public
876
1001
  * <p>Contains the facet results. A <code>FacetResult</code> contains the counts for each
877
1002
  * field/attribute key that was specified in the <code>Facets</code> input parameter.</p>
878
1003
  */
879
1004
  FacetResults?: FacetResult[];
880
1005
  /**
1006
+ * @public
881
1007
  * <p>The total number of items found by the search. However, you can only retrieve up to
882
1008
  * 100 items. For example, if the search found 192 items, you can only retrieve the first
883
1009
  * 100 of the items.</p>
884
1010
  */
885
1011
  TotalNumberOfResults?: number;
886
1012
  /**
1013
+ * @public
887
1014
  * <p>A list of warning codes and their messages on problems with your query.</p>
888
1015
  * <p>Amazon Kendra currently only supports one type of warning, which is a warning on
889
1016
  * invalid syntax used in the query. For examples of invalid query syntax, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html#searching-index-query-syntax">Searching
@@ -891,10 +1018,12 @@ export interface QueryResult {
891
1018
  */
892
1019
  Warnings?: Warning[];
893
1020
  /**
1021
+ * @public
894
1022
  * <p>A list of information related to suggested spell corrections for a query.</p>
895
1023
  */
896
1024
  SpellCorrectedQueries?: SpellCorrectedQuery[];
897
1025
  /**
1026
+ * @public
898
1027
  * <p>The list of featured result items. Featured results are displayed at
899
1028
  * the top of the search results page, placed above all other results for
900
1029
  * certain queries. If there's an exact match of a query, then certain
@@ -909,22 +1038,26 @@ export interface QueryResult {
909
1038
  */
910
1039
  export interface AttributeSuggestionsGetConfig {
911
1040
  /**
1041
+ * @public
912
1042
  * <p>The list of document field/attribute keys or field names to use for query suggestions.
913
1043
  * If the content within any of the fields match what your user starts typing as their query,
914
1044
  * then the field content is returned as a query suggestion.</p>
915
1045
  */
916
1046
  SuggestionAttributes?: string[];
917
1047
  /**
1048
+ * @public
918
1049
  * <p>The list of additional document field/attribute keys or field names to include in the
919
1050
  * response. You can use additional fields to provide extra information in the response.
920
1051
  * Additional fields are not used to based suggestions on.</p>
921
1052
  */
922
1053
  AdditionalResponseAttributes?: string[];
923
1054
  /**
1055
+ * @public
924
1056
  * <p>Filters the search results based on document fields/attributes.</p>
925
1057
  */
926
1058
  AttributeFilter?: AttributeFilter;
927
1059
  /**
1060
+ * @public
928
1061
  * <p>Applies user context filtering so that only users who are given access to certain
929
1062
  * documents see these document in their search results.</p>
930
1063
  */
@@ -935,11 +1068,13 @@ export interface AttributeSuggestionsGetConfig {
935
1068
  */
936
1069
  export interface RetrieveRequest {
937
1070
  /**
1071
+ * @public
938
1072
  * <p>The identifier of the index to retrieve relevant passages for the
939
1073
  * search.</p>
940
1074
  */
941
1075
  IndexId: string | undefined;
942
1076
  /**
1077
+ * @public
943
1078
  * <p>The input query text to retrieve relevant passages for the search.
944
1079
  * Amazon Kendra truncates queries at 30 token words, which excludes
945
1080
  * punctuation and stop words. Truncation still applies if you use Boolean
@@ -947,6 +1082,7 @@ export interface RetrieveRequest {
947
1082
  */
948
1083
  QueryText: string | undefined;
949
1084
  /**
1085
+ * @public
950
1086
  * <p>Filters search results by document fields/attributes. You can only provide
951
1087
  * one attribute filter; however, the <code>AndAllFilters</code>, <code>NotFilter</code>,
952
1088
  * and <code>OrAllFilters</code> parameters contain a list of other filters.</p>
@@ -955,12 +1091,14 @@ export interface RetrieveRequest {
955
1091
  */
956
1092
  AttributeFilter?: AttributeFilter;
957
1093
  /**
1094
+ * @public
958
1095
  * <p>A list of document fields/attributes to include in the response. You can limit
959
1096
  * the response to include certain document fields. By default, all document
960
1097
  * fields are included in the response.</p>
961
1098
  */
962
1099
  RequestedDocumentAttributes?: string[];
963
1100
  /**
1101
+ * @public
964
1102
  * <p>Overrides relevance tuning configurations of fields/attributes set at the index
965
1103
  * level.</p>
966
1104
  * <p>If you use this API to override the relevance tuning configured at the index level,
@@ -972,18 +1110,21 @@ export interface RetrieveRequest {
972
1110
  */
973
1111
  DocumentRelevanceOverrideConfigurations?: DocumentRelevanceConfiguration[];
974
1112
  /**
1113
+ * @public
975
1114
  * <p>Retrieved relevant passages are returned in pages the size of the
976
1115
  * <code>PageSize</code> parameter. By default, Amazon Kendra returns the first page
977
1116
  * of results. Use this parameter to get result pages after the first one.</p>
978
1117
  */
979
1118
  PageNumber?: number;
980
1119
  /**
1120
+ * @public
981
1121
  * <p>Sets the number of retrieved relevant passages that are returned in each page of
982
1122
  * results. The default page size is 10. The maximum number of results returned is 100.
983
1123
  * If you ask for more than 100 results, only 100 are returned.</p>
984
1124
  */
985
1125
  PageSize?: number;
986
1126
  /**
1127
+ * @public
987
1128
  * <p>The user context token or user and group information.</p>
988
1129
  */
989
1130
  UserContext?: UserContext;
@@ -993,10 +1134,12 @@ export interface RetrieveRequest {
993
1134
  */
994
1135
  export interface GetQuerySuggestionsRequest {
995
1136
  /**
1137
+ * @public
996
1138
  * <p>The identifier of the index you want to get query suggestions from.</p>
997
1139
  */
998
1140
  IndexId: string | undefined;
999
1141
  /**
1142
+ * @public
1000
1143
  * <p>The text of a user's query to generate query suggestions.</p>
1001
1144
  * <p>A query is suggested if the query prefix matches
1002
1145
  * what a user starts to type as their query.</p>
@@ -1007,11 +1150,13 @@ export interface GetQuerySuggestionsRequest {
1007
1150
  */
1008
1151
  QueryText: string | undefined;
1009
1152
  /**
1153
+ * @public
1010
1154
  * <p>The maximum number of query suggestions you want to show
1011
1155
  * to your users.</p>
1012
1156
  */
1013
1157
  MaxSuggestionsCount?: number;
1014
1158
  /**
1159
+ * @public
1015
1160
  * <p>The suggestions type to base query suggestions on. The suggestion
1016
1161
  * types are query history or document fields/attributes. You can set
1017
1162
  * one type or the other.</p>
@@ -1024,6 +1169,7 @@ export interface GetQuerySuggestionsRequest {
1024
1169
  */
1025
1170
  SuggestionTypes?: (SuggestionType | string)[];
1026
1171
  /**
1172
+ * @public
1027
1173
  * <p>Configuration information for the document fields/attributes that you
1028
1174
  * want to base query suggestions on.</p>
1029
1175
  */
@@ -1034,16 +1180,19 @@ export interface GetQuerySuggestionsRequest {
1034
1180
  */
1035
1181
  export interface QueryRequest {
1036
1182
  /**
1183
+ * @public
1037
1184
  * <p>The identifier of the index for the search.</p>
1038
1185
  */
1039
1186
  IndexId: string | undefined;
1040
1187
  /**
1188
+ * @public
1041
1189
  * <p>The input query text for the search. Amazon Kendra truncates queries at 30 token
1042
1190
  * words, which excludes punctuation and stop words. Truncation still applies if you use
1043
1191
  * Boolean or more advanced, complex queries. </p>
1044
1192
  */
1045
1193
  QueryText?: string;
1046
1194
  /**
1195
+ * @public
1047
1196
  * <p>Filters search results by document fields/attributes. You can only provide
1048
1197
  * one attribute filter; however, the <code>AndAllFilters</code>, <code>NotFilter</code>,
1049
1198
  * and <code>OrAllFilters</code> parameters contain a list of other filters.</p>
@@ -1052,22 +1201,26 @@ export interface QueryRequest {
1052
1201
  */
1053
1202
  AttributeFilter?: AttributeFilter;
1054
1203
  /**
1204
+ * @public
1055
1205
  * <p>An array of documents fields/attributes for faceted search. Amazon Kendra returns a
1056
1206
  * count for each field key specified. This helps your users narrow their search.</p>
1057
1207
  */
1058
1208
  Facets?: Facet[];
1059
1209
  /**
1210
+ * @public
1060
1211
  * <p>An array of document fields/attributes to include in the response. You can limit the
1061
1212
  * response to include certain document fields. By default, all document attributes are
1062
1213
  * included in the response.</p>
1063
1214
  */
1064
1215
  RequestedDocumentAttributes?: string[];
1065
1216
  /**
1217
+ * @public
1066
1218
  * <p>Sets the type of query result or response. Only results for the specified type are
1067
1219
  * returned.</p>
1068
1220
  */
1069
1221
  QueryResultTypeFilter?: QueryResultType | string;
1070
1222
  /**
1223
+ * @public
1071
1224
  * <p>Overrides relevance tuning configurations of fields/attributes set at the index level.</p>
1072
1225
  * <p>If you use this API to override the relevance tuning configured at the index level, but there
1073
1226
  * is no relevance tuning configured at the index level, then Amazon Kendra does not apply any
@@ -1078,18 +1231,21 @@ export interface QueryRequest {
1078
1231
  */
1079
1232
  DocumentRelevanceOverrideConfigurations?: DocumentRelevanceConfiguration[];
1080
1233
  /**
1234
+ * @public
1081
1235
  * <p>Query results are returned in pages the size of the <code>PageSize</code> parameter.
1082
1236
  * By default, Amazon Kendra returns the first page of results. Use this parameter to
1083
1237
  * get result pages after the first one.</p>
1084
1238
  */
1085
1239
  PageNumber?: number;
1086
1240
  /**
1241
+ * @public
1087
1242
  * <p>Sets the number of results that are returned in each page of results. The default page
1088
1243
  * size is 10. The maximum number of results returned is 100. If you ask for more than 100
1089
1244
  * results, only 100 are returned.</p>
1090
1245
  */
1091
1246
  PageSize?: number;
1092
1247
  /**
1248
+ * @public
1093
1249
  * <p>Provides information that determines how the results of the query are sorted. You can
1094
1250
  * set the field that Amazon Kendra should sort the results on, and specify whether the
1095
1251
  * results should be sorted in ascending or descending order. In the case of ties in sorting
@@ -1099,16 +1255,19 @@ export interface QueryRequest {
1099
1255
  */
1100
1256
  SortingConfiguration?: SortingConfiguration;
1101
1257
  /**
1258
+ * @public
1102
1259
  * <p>The user context token or user and group information.</p>
1103
1260
  */
1104
1261
  UserContext?: UserContext;
1105
1262
  /**
1263
+ * @public
1106
1264
  * <p>Provides an identifier for a specific user. The <code>VisitorId</code> should be a
1107
1265
  * unique identifier, such as a GUID. Don't use personally identifiable information, such as
1108
1266
  * the user's email address, as the <code>VisitorId</code>.</p>
1109
1267
  */
1110
1268
  VisitorId?: string;
1111
1269
  /**
1270
+ * @public
1112
1271
  * <p>Enables suggested spell corrections for queries.</p>
1113
1272
  */
1114
1273
  SpellCorrectionConfiguration?: SpellCorrectionConfiguration;