@aws-sdk/client-kendra 3.301.0 → 3.303.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.
Files changed (118) hide show
  1. package/README.md +40 -0
  2. package/dist-cjs/Kendra.js +75 -0
  3. package/dist-cjs/commands/BatchDeleteFeaturedResultsSetCommand.js +45 -0
  4. package/dist-cjs/commands/CreateFeaturedResultsSetCommand.js +45 -0
  5. package/dist-cjs/commands/DescribeFeaturedResultsSetCommand.js +45 -0
  6. package/dist-cjs/commands/ListFeaturedResultsSetsCommand.js +45 -0
  7. package/dist-cjs/commands/UpdateFeaturedResultsSetCommand.js +45 -0
  8. package/dist-cjs/commands/index.js +5 -0
  9. package/dist-cjs/endpoint/ruleset.js +3 -3
  10. package/dist-cjs/models/models_0.js +381 -438
  11. package/dist-cjs/models/models_1.js +20 -0
  12. package/dist-cjs/protocols/Aws_json1_1.js +597 -4
  13. package/dist-es/Kendra.js +75 -0
  14. package/dist-es/commands/BatchDeleteFeaturedResultsSetCommand.js +41 -0
  15. package/dist-es/commands/CreateFeaturedResultsSetCommand.js +41 -0
  16. package/dist-es/commands/DescribeFeaturedResultsSetCommand.js +41 -0
  17. package/dist-es/commands/ListFeaturedResultsSetsCommand.js +41 -0
  18. package/dist-es/commands/UpdateFeaturedResultsSetCommand.js +41 -0
  19. package/dist-es/commands/index.js +5 -0
  20. package/dist-es/endpoint/ruleset.js +3 -3
  21. package/dist-es/models/models_0.js +377 -434
  22. package/dist-es/models/models_1.js +18 -1
  23. package/dist-es/protocols/Aws_json1_1.js +584 -1
  24. package/dist-types/Kendra.d.ts +163 -132
  25. package/dist-types/KendraClient.d.ts +7 -2
  26. package/dist-types/commands/AssociateEntitiesToExperienceCommand.d.ts +1 -1
  27. package/dist-types/commands/AssociatePersonasToEntitiesCommand.d.ts +1 -1
  28. package/dist-types/commands/BatchDeleteDocumentCommand.d.ts +6 -6
  29. package/dist-types/commands/BatchDeleteFeaturedResultsSetCommand.d.ts +88 -0
  30. package/dist-types/commands/BatchGetDocumentStatusCommand.d.ts +9 -13
  31. package/dist-types/commands/BatchPutDocumentCommand.d.ts +14 -13
  32. package/dist-types/commands/ClearQuerySuggestionsCommand.d.ts +1 -1
  33. package/dist-types/commands/CreateAccessControlConfigurationCommand.d.ts +17 -20
  34. package/dist-types/commands/CreateDataSourceCommand.d.ts +3 -4
  35. package/dist-types/commands/CreateExperienceCommand.d.ts +3 -2
  36. package/dist-types/commands/CreateFaqCommand.d.ts +6 -6
  37. package/dist-types/commands/CreateFeaturedResultsSetCommand.d.ts +117 -0
  38. package/dist-types/commands/CreateIndexCommand.d.ts +3 -2
  39. package/dist-types/commands/CreateQuerySuggestionsBlockListCommand.d.ts +3 -2
  40. package/dist-types/commands/CreateThesaurusCommand.d.ts +3 -2
  41. package/dist-types/commands/DeleteAccessControlConfigurationCommand.d.ts +5 -5
  42. package/dist-types/commands/DeleteDataSourceCommand.d.ts +1 -1
  43. package/dist-types/commands/DeleteExperienceCommand.d.ts +1 -1
  44. package/dist-types/commands/DeleteFaqCommand.d.ts +1 -1
  45. package/dist-types/commands/DeleteIndexCommand.d.ts +1 -1
  46. package/dist-types/commands/DeletePrincipalMappingCommand.d.ts +13 -15
  47. package/dist-types/commands/DeleteQuerySuggestionsBlockListCommand.d.ts +1 -1
  48. package/dist-types/commands/DeleteThesaurusCommand.d.ts +1 -1
  49. package/dist-types/commands/DescribeAccessControlConfigurationCommand.d.ts +3 -3
  50. package/dist-types/commands/DescribeDataSourceCommand.d.ts +1 -1
  51. package/dist-types/commands/DescribeExperienceCommand.d.ts +1 -1
  52. package/dist-types/commands/DescribeFaqCommand.d.ts +1 -1
  53. package/dist-types/commands/DescribeFeaturedResultsSetCommand.d.ts +86 -0
  54. package/dist-types/commands/DescribeIndexCommand.d.ts +1 -1
  55. package/dist-types/commands/DescribePrincipalMappingCommand.d.ts +8 -9
  56. package/dist-types/commands/DescribeQuerySuggestionsBlockListCommand.d.ts +1 -1
  57. package/dist-types/commands/DescribeQuerySuggestionsConfigCommand.d.ts +1 -1
  58. package/dist-types/commands/DescribeThesaurusCommand.d.ts +1 -1
  59. package/dist-types/commands/DisassociateEntitiesFromExperienceCommand.d.ts +1 -1
  60. package/dist-types/commands/DisassociatePersonasFromEntitiesCommand.d.ts +1 -1
  61. package/dist-types/commands/GetQuerySuggestionsCommand.d.ts +3 -2
  62. package/dist-types/commands/GetSnapshotsCommand.d.ts +3 -4
  63. package/dist-types/commands/ListAccessControlConfigurationsCommand.d.ts +5 -5
  64. package/dist-types/commands/ListDataSourceSyncJobsCommand.d.ts +1 -1
  65. package/dist-types/commands/ListDataSourcesCommand.d.ts +1 -1
  66. package/dist-types/commands/ListEntityPersonasCommand.d.ts +1 -1
  67. package/dist-types/commands/ListExperienceEntitiesCommand.d.ts +1 -1
  68. package/dist-types/commands/ListExperiencesCommand.d.ts +1 -1
  69. package/dist-types/commands/ListFaqsCommand.d.ts +1 -1
  70. package/dist-types/commands/ListFeaturedResultsSetsCommand.d.ts +87 -0
  71. package/dist-types/commands/ListGroupsOlderThanOrderingIdCommand.d.ts +4 -5
  72. package/dist-types/commands/ListIndicesCommand.d.ts +1 -1
  73. package/dist-types/commands/ListQuerySuggestionsBlockListsCommand.d.ts +1 -1
  74. package/dist-types/commands/ListTagsForResourceCommand.d.ts +3 -3
  75. package/dist-types/commands/ListThesauriCommand.d.ts +1 -1
  76. package/dist-types/commands/PutPrincipalMappingCommand.d.ts +15 -21
  77. package/dist-types/commands/QueryCommand.d.ts +3 -2
  78. package/dist-types/commands/StartDataSourceSyncJobCommand.d.ts +2 -2
  79. package/dist-types/commands/StopDataSourceSyncJobCommand.d.ts +2 -2
  80. package/dist-types/commands/SubmitFeedbackCommand.d.ts +2 -2
  81. package/dist-types/commands/TagResourceCommand.d.ts +4 -5
  82. package/dist-types/commands/UntagResourceCommand.d.ts +2 -2
  83. package/dist-types/commands/UpdateAccessControlConfigurationCommand.d.ts +20 -20
  84. package/dist-types/commands/UpdateDataSourceCommand.d.ts +2 -2
  85. package/dist-types/commands/UpdateExperienceCommand.d.ts +2 -2
  86. package/dist-types/commands/UpdateFeaturedResultsSetCommand.d.ts +105 -0
  87. package/dist-types/commands/UpdateIndexCommand.d.ts +4 -3
  88. package/dist-types/commands/UpdateQuerySuggestionsBlockListCommand.d.ts +2 -2
  89. package/dist-types/commands/UpdateQuerySuggestionsConfigCommand.d.ts +1 -1
  90. package/dist-types/commands/UpdateThesaurusCommand.d.ts +1 -1
  91. package/dist-types/commands/index.d.ts +5 -0
  92. package/dist-types/endpoint/EndpointParameters.d.ts +1 -1
  93. package/dist-types/models/models_0.d.ts +1943 -1687
  94. package/dist-types/models/models_1.d.ts +491 -72
  95. package/dist-types/protocols/Aws_json1_1.d.ts +15 -0
  96. package/dist-types/ts3.4/Kendra.d.ts +85 -0
  97. package/dist-types/ts3.4/KendraClient.d.ts +30 -0
  98. package/dist-types/ts3.4/commands/BatchDeleteFeaturedResultsSetCommand.d.ts +41 -0
  99. package/dist-types/ts3.4/commands/CreateFeaturedResultsSetCommand.d.ts +41 -0
  100. package/dist-types/ts3.4/commands/DescribeFeaturedResultsSetCommand.d.ts +41 -0
  101. package/dist-types/ts3.4/commands/ListFeaturedResultsSetsCommand.d.ts +41 -0
  102. package/dist-types/ts3.4/commands/StartDataSourceSyncJobCommand.d.ts +1 -1
  103. package/dist-types/ts3.4/commands/StopDataSourceSyncJobCommand.d.ts +1 -1
  104. package/dist-types/ts3.4/commands/SubmitFeedbackCommand.d.ts +1 -1
  105. package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +1 -1
  106. package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +1 -1
  107. package/dist-types/ts3.4/commands/UpdateAccessControlConfigurationCommand.d.ts +1 -1
  108. package/dist-types/ts3.4/commands/UpdateDataSourceCommand.d.ts +1 -1
  109. package/dist-types/ts3.4/commands/UpdateExperienceCommand.d.ts +1 -1
  110. package/dist-types/ts3.4/commands/UpdateFeaturedResultsSetCommand.d.ts +41 -0
  111. package/dist-types/ts3.4/commands/UpdateIndexCommand.d.ts +1 -1
  112. package/dist-types/ts3.4/commands/UpdateQuerySuggestionsBlockListCommand.d.ts +1 -1
  113. package/dist-types/ts3.4/commands/index.d.ts +5 -0
  114. package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +1 -1
  115. package/dist-types/ts3.4/models/models_0.d.ts +563 -453
  116. package/dist-types/ts3.4/models/models_1.d.ts +127 -0
  117. package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +60 -0
  118. package/package.json +34 -34
@@ -1,4 +1,427 @@
1
- import { DocumentAttribute, DocumentAttributeValue, DocumentAttributeValueType, DocumentRelevanceConfiguration, Mode, QueryResultItem, QueryResultType, S3Path, SortingConfiguration, SpellCorrectedQuery, SpellCorrectionConfiguration, UserContext, Warning } from "./models_0";
1
+ import { ExceptionOptionType as __ExceptionOptionType } from "@aws-sdk/smithy-client";
2
+ import { KendraServiceException as __BaseException } from "./KendraServiceException";
3
+ import { CapacityUnitsConfiguration, CustomDocumentEnrichmentConfiguration, DataSourceConfiguration, DataSourceVpcConfiguration, DocumentAttribute, DocumentAttributeValue, DocumentAttributeValueType, DocumentMetadataConfiguration, DocumentRelevanceConfiguration, ExperienceConfiguration, FeaturedDocument, FeaturedResultsItem, FeaturedResultsSet, FeaturedResultsSetStatus, HierarchicalPrincipal, Mode, Principal, QueryResultItem, QueryResultType, S3Path, SortingConfiguration, SpellCorrectedQuery, SpellCorrectionConfiguration, Tag, UserContext, UserContextPolicy, UserGroupResolutionConfiguration, UserTokenConfiguration, Warning } from "./models_0";
4
+ /**
5
+ * @public
6
+ * <p>The resource you want to use is currently in use. Please check you have provided the
7
+ * correct resource and try again.</p>
8
+ */
9
+ export declare class ResourceInUseException extends __BaseException {
10
+ readonly name: "ResourceInUseException";
11
+ readonly $fault: "client";
12
+ Message?: string;
13
+ /**
14
+ * @internal
15
+ */
16
+ constructor(opts: __ExceptionOptionType<ResourceInUseException, __BaseException>);
17
+ }
18
+ /**
19
+ * @public
20
+ */
21
+ export interface StartDataSourceSyncJobRequest {
22
+ /**
23
+ * <p>The identifier of the data source connector to synchronize.</p>
24
+ */
25
+ Id: string | undefined;
26
+ /**
27
+ * <p>The identifier of the index used with the data source connector.</p>
28
+ */
29
+ IndexId: string | undefined;
30
+ }
31
+ /**
32
+ * @public
33
+ */
34
+ export interface StartDataSourceSyncJobResponse {
35
+ /**
36
+ * <p>Identifies a particular synchronization job.</p>
37
+ */
38
+ ExecutionId?: string;
39
+ }
40
+ /**
41
+ * @public
42
+ */
43
+ export interface StopDataSourceSyncJobRequest {
44
+ /**
45
+ * <p>The identifier of the data source connector for which to stop the synchronization
46
+ * jobs.</p>
47
+ */
48
+ Id: string | undefined;
49
+ /**
50
+ * <p>The identifier of the index used with the data source connector.</p>
51
+ */
52
+ IndexId: string | undefined;
53
+ }
54
+ /**
55
+ * @public
56
+ * <p>Gathers information about when a particular result was clicked by a user. Your
57
+ * application uses the <code>SubmitFeedback</code> API to provide click
58
+ * information.</p>
59
+ */
60
+ export interface ClickFeedback {
61
+ /**
62
+ * <p>The identifier of the search result that was clicked.</p>
63
+ */
64
+ ResultId: string | undefined;
65
+ /**
66
+ * <p>The Unix timestamp when the result was clicked.</p>
67
+ */
68
+ ClickTime: Date | undefined;
69
+ }
70
+ /**
71
+ * @public
72
+ * @enum
73
+ */
74
+ export declare const RelevanceType: {
75
+ readonly NOT_RELEVANT: "NOT_RELEVANT";
76
+ readonly RELEVANT: "RELEVANT";
77
+ };
78
+ /**
79
+ * @public
80
+ */
81
+ export type RelevanceType = (typeof RelevanceType)[keyof typeof RelevanceType];
82
+ /**
83
+ * @public
84
+ * <p>Provides feedback on how relevant a document is to a search. Your application uses the
85
+ * <code>SubmitFeedback</code> API to provide relevance information.</p>
86
+ */
87
+ export interface RelevanceFeedback {
88
+ /**
89
+ * <p>The identifier of the search result that the user provided relevance feedback
90
+ * for.</p>
91
+ */
92
+ ResultId: string | undefined;
93
+ /**
94
+ * <p>Whether the document was relevant or not relevant to the search.</p>
95
+ */
96
+ RelevanceValue: RelevanceType | string | undefined;
97
+ }
98
+ /**
99
+ * @public
100
+ */
101
+ export interface SubmitFeedbackRequest {
102
+ /**
103
+ * <p>The identifier of the index that was queried.</p>
104
+ */
105
+ IndexId: string | undefined;
106
+ /**
107
+ * <p>The identifier of the specific query for which you are submitting
108
+ * feedback. The query ID is returned in the response to the
109
+ * <code>Query</code> API.</p>
110
+ */
111
+ QueryId: string | undefined;
112
+ /**
113
+ * <p>Tells Amazon Kendra that a particular search result link was chosen
114
+ * by the user. </p>
115
+ */
116
+ ClickFeedbackItems?: ClickFeedback[];
117
+ /**
118
+ * <p>Provides Amazon Kendra with relevant or not relevant feedback for
119
+ * whether a particular item was relevant to the search.</p>
120
+ */
121
+ RelevanceFeedbackItems?: RelevanceFeedback[];
122
+ }
123
+ /**
124
+ * @public
125
+ */
126
+ export interface TagResourceRequest {
127
+ /**
128
+ * <p>The Amazon Resource Name (ARN) of the index, FAQ, or data source to tag.</p>
129
+ */
130
+ ResourceARN: string | undefined;
131
+ /**
132
+ * <p>A list of tag keys to add to the index, FAQ, or data source. If a tag already exists, the
133
+ * existing value is replaced with the new value.</p>
134
+ */
135
+ Tags: Tag[] | undefined;
136
+ }
137
+ /**
138
+ * @public
139
+ */
140
+ export interface TagResourceResponse {
141
+ }
142
+ /**
143
+ * @public
144
+ */
145
+ export interface UntagResourceRequest {
146
+ /**
147
+ * <p>The Amazon Resource Name (ARN) of the index, FAQ, or data source to remove the tag
148
+ * from.</p>
149
+ */
150
+ ResourceARN: string | undefined;
151
+ /**
152
+ * <p>A list of tag keys to remove from the index, FAQ, or data source. If a tag key does not
153
+ * exist on the resource, it is ignored.</p>
154
+ */
155
+ TagKeys: string[] | undefined;
156
+ }
157
+ /**
158
+ * @public
159
+ */
160
+ export interface UntagResourceResponse {
161
+ }
162
+ /**
163
+ * @public
164
+ */
165
+ export interface UpdateAccessControlConfigurationRequest {
166
+ /**
167
+ * <p>The identifier of the index for an access control configuration.</p>
168
+ */
169
+ IndexId: string | undefined;
170
+ /**
171
+ * <p>The identifier of the access control configuration you want to update.</p>
172
+ */
173
+ Id: string | undefined;
174
+ /**
175
+ * <p>A new name for the access control configuration.</p>
176
+ */
177
+ Name?: string;
178
+ /**
179
+ * <p>A new description for the access control configuration.</p>
180
+ */
181
+ Description?: string;
182
+ /**
183
+ * <p>Information you want to update on principals (users and/or groups) and which documents
184
+ * they should have access to. This is useful for user context filtering, where search
185
+ * results are filtered based on the user or their group access to documents.</p>
186
+ */
187
+ AccessControlList?: Principal[];
188
+ /**
189
+ * <p>The updated list of <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_Principal.html">principal</a> lists that define the
190
+ * hierarchy for which documents users should have access to.</p>
191
+ */
192
+ HierarchicalAccessControlList?: HierarchicalPrincipal[];
193
+ }
194
+ /**
195
+ * @public
196
+ */
197
+ export interface UpdateAccessControlConfigurationResponse {
198
+ }
199
+ /**
200
+ * @public
201
+ */
202
+ export interface UpdateDataSourceRequest {
203
+ /**
204
+ * <p>The identifier of the data source connector you want to update.</p>
205
+ */
206
+ Id: string | undefined;
207
+ /**
208
+ * <p>A new name for the data source connector.</p>
209
+ */
210
+ Name?: string;
211
+ /**
212
+ * <p>The identifier of the index used with the data source connector.</p>
213
+ */
214
+ IndexId: string | undefined;
215
+ /**
216
+ * <p>Configuration information you want to update for the data source connector.</p>
217
+ */
218
+ Configuration?: DataSourceConfiguration;
219
+ /**
220
+ * <p>Configuration information for an Amazon Virtual Private Cloud to connect to your data source.
221
+ * For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html">Configuring a VPC</a>.</p>
222
+ */
223
+ VpcConfiguration?: DataSourceVpcConfiguration;
224
+ /**
225
+ * <p>A new description for the data source connector.</p>
226
+ */
227
+ Description?: string;
228
+ /**
229
+ * <p>The sync schedule you want to update for the data source connector.</p>
230
+ */
231
+ Schedule?: string;
232
+ /**
233
+ * <p>The Amazon Resource Name (ARN) of a role with permission to access the data source and
234
+ * 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>
235
+ */
236
+ RoleArn?: string;
237
+ /**
238
+ * <p>The code for a language you want to update for the data source connector.
239
+ * This allows you to support a language for all
240
+ * documents when updating the data source. English is supported
241
+ * by default. For more information on supported languages, including their codes,
242
+ * see <a href="https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html">Adding
243
+ * documents in languages other than English</a>.</p>
244
+ */
245
+ LanguageCode?: string;
246
+ /**
247
+ * <p>Configuration information you want to update for altering document metadata and
248
+ * content during the document ingestion process.</p>
249
+ * <p>For more information on how to create, modify and delete document metadata, or make
250
+ * other content alterations when you ingest documents into Amazon Kendra, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html">Customizing document metadata during the ingestion process</a>.</p>
251
+ */
252
+ CustomDocumentEnrichmentConfiguration?: CustomDocumentEnrichmentConfiguration;
253
+ }
254
+ /**
255
+ * @public
256
+ */
257
+ export interface UpdateExperienceRequest {
258
+ /**
259
+ * <p>The identifier of your Amazon Kendra experience you want to update.</p>
260
+ */
261
+ Id: string | undefined;
262
+ /**
263
+ * <p>A new name for your Amazon Kendra experience.</p>
264
+ */
265
+ Name?: string;
266
+ /**
267
+ * <p>The identifier of the index for your Amazon Kendra experience.</p>
268
+ */
269
+ IndexId: string | undefined;
270
+ /**
271
+ * <p>The Amazon Resource Name (ARN) of a role with permission to access <code>Query</code>
272
+ * API, <code>QuerySuggestions</code> API, <code>SubmitFeedback</code>
273
+ * API, and IAM Identity Center that stores your user and group information.
274
+ * For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html">IAM roles for Amazon Kendra</a>.</p>
275
+ */
276
+ RoleArn?: string;
277
+ /**
278
+ * <p>Configuration information you want to update for your Amazon Kendra experience.</p>
279
+ */
280
+ Configuration?: ExperienceConfiguration;
281
+ /**
282
+ * <p>A new description for your Amazon Kendra experience.</p>
283
+ */
284
+ Description?: string;
285
+ }
286
+ /**
287
+ * @public
288
+ */
289
+ export interface UpdateFeaturedResultsSetRequest {
290
+ /**
291
+ * <p>The identifier of the index used for featuring results.</p>
292
+ */
293
+ IndexId: string | undefined;
294
+ /**
295
+ * <p>The identifier of the index used for featuring results.</p>
296
+ */
297
+ FeaturedResultsSetId: string | undefined;
298
+ /**
299
+ * <p>A new name for the set of featured results.</p>
300
+ */
301
+ FeaturedResultsSetName?: string;
302
+ /**
303
+ * <p>A new description for the set of featured results.</p>
304
+ */
305
+ Description?: string;
306
+ /**
307
+ * <p>You can set the status to <code>ACTIVE</code> or <code>INACTIVE</code>.
308
+ * When the value is <code>ACTIVE</code>, featured results are ready for
309
+ * use. You can still configure your settings before setting the status
310
+ * to <code>ACTIVE</code>. The queries you specify for featured results
311
+ * must be unique per featured results set for each index, whether the
312
+ * status is <code>ACTIVE</code> or <code>INACTIVE</code>.</p>
313
+ */
314
+ Status?: FeaturedResultsSetStatus | string;
315
+ /**
316
+ * <p>A list of queries for featuring results. For more information on the
317
+ * list of queries, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html">FeaturedResultsSet</a>.</p>
318
+ */
319
+ QueryTexts?: string[];
320
+ /**
321
+ * <p>A list of document IDs for the documents you want to feature at the
322
+ * top of the search results page. For more information on the list of
323
+ * featured documents, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_FeaturedResultsSet.html">FeaturedResultsSet</a>.</p>
324
+ */
325
+ FeaturedDocuments?: FeaturedDocument[];
326
+ }
327
+ /**
328
+ * @public
329
+ */
330
+ export interface UpdateFeaturedResultsSetResponse {
331
+ /**
332
+ * <p>Information on the set of featured results. This includes the identifier
333
+ * of the featured results set, whether the featured results set is active
334
+ * or inactive, when the featured results set was last updated, and more.</p>
335
+ */
336
+ FeaturedResultsSet?: FeaturedResultsSet;
337
+ }
338
+ /**
339
+ * @public
340
+ */
341
+ export interface UpdateIndexRequest {
342
+ /**
343
+ * <p>The identifier of the index you want to update.</p>
344
+ */
345
+ Id: string | undefined;
346
+ /**
347
+ * <p>The name of the index you want to update.</p>
348
+ */
349
+ Name?: string;
350
+ /**
351
+ * <p>An Identity and Access Management (IAM) role that gives Amazon Kendra
352
+ * permission to access Amazon CloudWatch logs and metrics.</p>
353
+ */
354
+ RoleArn?: string;
355
+ /**
356
+ * <p>A new description for the index.</p>
357
+ */
358
+ Description?: string;
359
+ /**
360
+ * <p>The document metadata configuration you want to update for the index. Document metadata
361
+ * are fields or attributes associated with your documents. For example, the company department
362
+ * name associated with each document.</p>
363
+ */
364
+ DocumentMetadataConfigurationUpdates?: DocumentMetadataConfiguration[];
365
+ /**
366
+ * <p>Sets the number of additional document storage and query capacity units that should be
367
+ * used by the index. You can change the capacity of the index up to 5 times per day, or make 5
368
+ * API calls.</p>
369
+ * <p>If you are using extra storage units, you can't reduce the storage capacity below what is
370
+ * required to meet the storage needs for your index.</p>
371
+ */
372
+ CapacityUnits?: CapacityUnitsConfiguration;
373
+ /**
374
+ * <p>The user token configuration.</p>
375
+ */
376
+ UserTokenConfigurations?: UserTokenConfiguration[];
377
+ /**
378
+ * <p>The user context policy.</p>
379
+ */
380
+ UserContextPolicy?: UserContextPolicy | string;
381
+ /**
382
+ * <p>Enables fetching access levels of groups and users from an IAM Identity Center (successor to Single Sign-On)
383
+ * identity source. To configure this, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html">UserGroupResolutionConfiguration</a>.</p>
384
+ */
385
+ UserGroupResolutionConfiguration?: UserGroupResolutionConfiguration;
386
+ }
387
+ /**
388
+ * @public
389
+ */
390
+ export interface UpdateQuerySuggestionsBlockListRequest {
391
+ /**
392
+ * <p>The identifier of the index for the block list.</p>
393
+ */
394
+ IndexId: string | undefined;
395
+ /**
396
+ * <p>The identifier of the block list you want to update.</p>
397
+ */
398
+ Id: string | undefined;
399
+ /**
400
+ * <p>A new name for the block list.</p>
401
+ */
402
+ Name?: string;
403
+ /**
404
+ * <p>A new description for the block list.</p>
405
+ */
406
+ Description?: string;
407
+ /**
408
+ * <p>The S3 path where your block list text file sits in S3.</p>
409
+ * <p>If you update your block list and provide the same path to the
410
+ * block list text file in S3, then Amazon Kendra reloads the file to refresh
411
+ * the block list. Amazon Kendra does not automatically refresh your block list.
412
+ * You need to call the <code>UpdateQuerySuggestionsBlockList</code> API
413
+ * to refresh you block list.</p>
414
+ * <p>If you update your block list, then Amazon Kendra asynchronously refreshes
415
+ * all query suggestions with the latest content in the S3 file. This
416
+ * means changes might not take effect immediately.</p>
417
+ */
418
+ SourceS3Path?: S3Path;
419
+ /**
420
+ * <p>The IAM (Identity and Access Management) role used to access the
421
+ * block list text file in S3.</p>
422
+ */
423
+ RoleArn?: string;
424
+ }
2
425
  /**
3
426
  * @public
4
427
  */
@@ -88,13 +511,13 @@ export interface UpdateThesaurusRequest {
88
511
  }
89
512
  /**
90
513
  * @public
91
- * <p>Information about a document attribute. You can use document
92
- * attributes as facets.</p>
93
- * <p>For example, the document attribute or facet "Department" includes
94
- * the values "HR", "Engineering", and "Accounting". You can display these
95
- * values in the search results so that documents can be searched by department.</p>
96
- * <p>You can display up to 10 facet values per facet for a query. If you want to
97
- * increase this limit, contact <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
514
+ * <p>Information about a document attribute. You can use document attributes as
515
+ * facets.</p>
516
+ * <p>For example, the document attribute or facet "Department" includes the values "HR",
517
+ * "Engineering", and "Accounting". You can display these values in the search results so that
518
+ * documents can be searched by department.</p>
519
+ * <p>You can display up to 10 facet values per facet for a query. If you want to increase
520
+ * this limit, contact <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
98
521
  */
99
522
  export interface Facet {
100
523
  /**
@@ -103,28 +526,27 @@ export interface Facet {
103
526
  DocumentAttributeKey?: string;
104
527
  /**
105
528
  * <p>An array of document attributes that are nested facets within a facet.</p>
106
- * <p>For example, the document attribute or facet "Department" includes a
107
- * value called "Engineering". In addition, the document attribute or
108
- * facet "SubDepartment" includes the values "Frontend" and "Backend" for documents
109
- * assigned to "Engineering". You can display nested facets in the search results
110
- * so that documents can be searched not only by department but also by a sub
111
- * department within a department. This helps your users further narrow their
112
- * search.</p>
113
- * <p>You can only have one nested facet within a facet. If you want to increase
114
- * this limit, contact <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
529
+ * <p>For example, the document attribute or facet "Department" includes a value called
530
+ * "Engineering". In addition, the document attribute or facet "SubDepartment" includes the
531
+ * values "Frontend" and "Backend" for documents assigned to "Engineering". You can display
532
+ * nested facets in the search results so that documents can be searched not only by
533
+ * department but also by a sub department within a department. This helps your users further
534
+ * narrow their search.</p>
535
+ * <p>You can only have one nested facet within a facet. If you want to increase this limit,
536
+ * contact <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
115
537
  */
116
538
  Facets?: Facet[];
117
539
  /**
118
- * <p>Maximum number of facet values per facet. The default is 10. You can use
119
- * this to limit the number of facet values to less than 10. If you want to
120
- * increase the default, contact <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
540
+ * <p>Maximum number of facet values per facet. The default is 10. You can use this to limit
541
+ * the number of facet values to less than 10. If you want to increase the default, contact
542
+ * <a href="http://aws.amazon.com/contact-us/">Support</a>.</p>
121
543
  */
122
544
  MaxResults?: number;
123
545
  }
124
546
  /**
125
547
  * @public
126
548
  * <p>Provides the count of documents that match a particular attribute when doing a faceted
127
- * search.</p>
549
+ * search.</p>
128
550
  */
129
551
  export interface DocumentAttributeValueCountPair {
130
552
  /**
@@ -133,20 +555,21 @@ export interface DocumentAttributeValueCountPair {
133
555
  DocumentAttributeValue?: DocumentAttributeValue;
134
556
  /**
135
557
  * <p>The number of documents in the response that have the attribute value for the
136
- * key.</p>
558
+ * key.</p>
137
559
  */
138
560
  Count?: number;
139
561
  /**
140
562
  * <p>Contains the results of a document attribute that is a nested facet. A
141
- * <code>FacetResult</code> contains the counts for each facet nested within a
142
- * facet.</p>
563
+ * <code>FacetResult</code> contains the counts for each facet nested within a
564
+ * facet.</p>
143
565
  * <p>For example, the document attribute or facet "Department" includes a value called
144
- * "Engineering". In addition, the document attribute or facet "SubDepartment" includes the
145
- * values "Frontend" and "Backend" for documents assigned to "Engineering". You can display
146
- * nested facets in the search results so that documents can be searched not only by
147
- * department but also by a sub department within a department. The counts for documents
148
- * that belong to "Frontend" and "Backend" within "Engineering" are returned for a
149
- * query.</p>
566
+ * "Engineering". In addition, the document attribute or facet "SubDepartment" includes the
567
+ * values "Frontend" and "Backend" for documents assigned to "Engineering". You can display
568
+ * nested facets in the search results so that documents can be searched not only by
569
+ * department but also by a sub department within a department. The counts for documents that
570
+ * belong to "Frontend" and "Backend" within "Engineering" are returned for a query.</p>
571
+ * <p></p>
572
+ * <p></p>
150
573
  */
151
574
  FacetResults?: FacetResult[];
152
575
  }
@@ -156,29 +579,27 @@ export interface DocumentAttributeValueCountPair {
156
579
  */
157
580
  export interface FacetResult {
158
581
  /**
159
- * <p>The key for the facet values. This is the same as the
160
- * <code>DocumentAttributeKey</code> provided in the query.</p>
582
+ * <p>The key for the facet values. This is the same as the <code>DocumentAttributeKey</code>
583
+ * provided in the query.</p>
161
584
  */
162
585
  DocumentAttributeKey?: string;
163
586
  /**
164
- * <p>The data type of the facet value. This is the same as the type
165
- * defined for the index field when it was created.</p>
587
+ * <p>The data type of the facet value. This is the same as the type defined for the index
588
+ * field when it was created.</p>
166
589
  */
167
590
  DocumentAttributeValueType?: DocumentAttributeValueType | string;
168
591
  /**
169
- * <p>An array of key/value pairs, where the key is the value of the
170
- * attribute and the count is the number of documents that share the key
171
- * value.</p>
592
+ * <p>An array of key/value pairs, where the key is the value of the attribute and the count
593
+ * is the number of documents that share the key value.</p>
172
594
  */
173
595
  DocumentAttributeValueCountPairs?: DocumentAttributeValueCountPair[];
174
596
  }
175
597
  /**
176
598
  * @public
177
- * <p>Provides filtering the query results based on document
178
- * attributes or metadata fields.</p>
179
- * <p>When you use the <code>AndAllFilters</code> or
180
- * <code>OrAllFilters</code>, filters you can use 2 layers under the
181
- * first attribute filter. For example, you can use:</p>
599
+ * <p>Provides filtering the query results based on document attributes or metadata
600
+ * fields.</p>
601
+ * <p>When you use the <code>AndAllFilters</code> or <code>OrAllFilters</code>, filters you
602
+ * can use 2 layers under the first attribute filter. For example, you can use:</p>
182
603
  * <p>
183
604
  * <code><AndAllFilters></code>
184
605
  * </p>
@@ -194,29 +615,23 @@ export interface FacetResult {
194
615
  * </p>
195
616
  * </li>
196
617
  * </ol>
197
- * <p>If you use more than 2 layers, you receive a
198
- * <code>ValidationException</code> exception with the message
199
- * "<code>AttributeFilter</code> cannot have a depth of more
200
- * than 2."</p>
201
- * <p>If you use more than 10 attribute filters in a given list for
202
- * <code>AndAllFilters</code> or <code>OrAllFilters</code>, you receive
203
- * a <code>ValidationException</code> with the message
204
- * "<code>AttributeFilter</code> cannot have a length of more than 10".</p>
618
+ * <p>If you use more than 2 layers, you receive a <code>ValidationException</code> exception
619
+ * with the message "<code>AttributeFilter</code> cannot have a depth of more than 2."</p>
620
+ * <p>If you use more than 10 attribute filters in a given list for <code>AndAllFilters</code>
621
+ * or <code>OrAllFilters</code>, you receive a <code>ValidationException</code> with the
622
+ * message "<code>AttributeFilter</code> cannot have a length of more than 10".</p>
205
623
  */
206
624
  export interface AttributeFilter {
207
625
  /**
208
- * <p>Performs a logical <code>AND</code> operation on all supplied
209
- * filters.</p>
626
+ * <p>Performs a logical <code>AND</code> operation on all supplied filters.</p>
210
627
  */
211
628
  AndAllFilters?: AttributeFilter[];
212
629
  /**
213
- * <p>Performs a logical <code>OR</code> operation on all supplied
214
- * filters.</p>
630
+ * <p>Performs a logical <code>OR</code> operation on all supplied filters.</p>
215
631
  */
216
632
  OrAllFilters?: AttributeFilter[];
217
633
  /**
218
- * <p>Performs a logical <code>NOT</code> operation on all supplied
219
- * filters.</p>
634
+ * <p>Performs a logical <code>NOT</code> operation on all supplied filters.</p>
220
635
  */
221
636
  NotFilter?: AttributeFilter;
222
637
  /**
@@ -224,39 +639,36 @@ export interface AttributeFilter {
224
639
  */
225
640
  EqualsTo?: DocumentAttribute;
226
641
  /**
227
- * <p>Returns true when a document contains all of the specified document
228
- * attributes or metadata fields. This filter is only applicable to
229
- * <code>StringListValue</code> metadata.</p>
642
+ * <p>Returns true when a document contains all of the specified document attributes or
643
+ * metadata fields. This filter is only applicable to <code>StringListValue</code>
644
+ * metadata.</p>
230
645
  */
231
646
  ContainsAll?: DocumentAttribute;
232
647
  /**
233
- * <p>Returns true when a document contains any of the specified document
234
- * attributes or metadata fields. This filter is only applicable to
235
- * <code>StringListValue</code> metadata.</p>
648
+ * <p>Returns true when a document contains any of the specified document attributes or
649
+ * metadata fields. This filter is only applicable to <code>StringListValue</code>
650
+ * metadata.</p>
236
651
  */
237
652
  ContainsAny?: DocumentAttribute;
238
653
  /**
239
654
  * <p>Performs a greater than operation on two document attributes or metadata fields. Use
240
- * with a document attribute of type <code>Date</code> or
241
- * <code>Long</code>.</p>
655
+ * with a document attribute of type <code>Date</code> or <code>Long</code>.</p>
242
656
  */
243
657
  GreaterThan?: DocumentAttribute;
244
658
  /**
245
- * <p>Performs a greater or equals than operation on two document
246
- * attributes or metadata fields. Use with a document attribute of type <code>Date</code>
247
- * or <code>Long</code>.</p>
659
+ * <p>Performs a greater or equals than operation on two document attributes or metadata
660
+ * fields. Use with a document attribute of type <code>Date</code> or
661
+ * <code>Long</code>.</p>
248
662
  */
249
663
  GreaterThanOrEquals?: DocumentAttribute;
250
664
  /**
251
- * <p>Performs a less than operation on two document attributes or metadata fields. Use with
252
- * a document attribute of type <code>Date</code> or
253
- * <code>Long</code>.</p>
665
+ * <p>Performs a less than operation on two document attributes or metadata fields. Use with a
666
+ * document attribute of type <code>Date</code> or <code>Long</code>.</p>
254
667
  */
255
668
  LessThan?: DocumentAttribute;
256
669
  /**
257
670
  * <p>Performs a less than or equals operation on two document attributes or metadata fields.
258
- * Use with a document attribute of type <code>Date</code> or
259
- * <code>Long</code>.</p>
671
+ * Use with a document attribute of type <code>Date</code> or <code>Long</code>.</p>
260
672
  */
261
673
  LessThanOrEquals?: DocumentAttribute;
262
674
  }
@@ -295,6 +707,13 @@ export interface QueryResult {
295
707
  * <p>A list of information related to suggested spell corrections for a query.</p>
296
708
  */
297
709
  SpellCorrectedQueries?: SpellCorrectedQuery[];
710
+ /**
711
+ * <p>The list of featured result items. Featured results are displayed at
712
+ * the top of the search results page, placed above all other results for
713
+ * certain queries. If there's an exact match of a query, then certain
714
+ * documents are featured in the search results.</p>
715
+ */
716
+ FeaturedResultsItems?: FeaturedResultsItem[];
298
717
  }
299
718
  /**
300
719
  * @public