@aws-sdk/client-kendra 3.43.0 → 3.47.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 (112) hide show
  1. package/CHANGELOG.md +50 -0
  2. package/README.md +7 -7
  3. package/dist-cjs/Kendra.js +180 -0
  4. package/dist-cjs/commands/AssociateEntitiesToExperienceCommand.js +36 -0
  5. package/dist-cjs/commands/AssociatePersonasToEntitiesCommand.js +36 -0
  6. package/dist-cjs/commands/CreateExperienceCommand.js +36 -0
  7. package/dist-cjs/commands/DeleteExperienceCommand.js +36 -0
  8. package/dist-cjs/commands/DescribeExperienceCommand.js +36 -0
  9. package/dist-cjs/commands/DisassociateEntitiesFromExperienceCommand.js +36 -0
  10. package/dist-cjs/commands/DisassociatePersonasFromEntitiesCommand.js +36 -0
  11. package/dist-cjs/commands/GetSnapshotsCommand.js +36 -0
  12. package/dist-cjs/commands/ListEntityPersonasCommand.js +36 -0
  13. package/dist-cjs/commands/ListExperienceEntitiesCommand.js +36 -0
  14. package/dist-cjs/commands/ListExperiencesCommand.js +36 -0
  15. package/dist-cjs/commands/UpdateExperienceCommand.js +36 -0
  16. package/dist-cjs/commands/index.js +12 -0
  17. package/dist-cjs/endpoints.js +1 -16
  18. package/dist-cjs/models/models_0.js +306 -69
  19. package/dist-cjs/pagination/ListEntityPersonasPaginator.js +35 -0
  20. package/dist-cjs/pagination/ListExperienceEntitiesPaginator.js +34 -0
  21. package/dist-cjs/pagination/ListExperiencesPaginator.js +35 -0
  22. package/dist-cjs/pagination/index.js +3 -0
  23. package/dist-cjs/protocols/Aws_json1_1.js +2043 -261
  24. package/dist-cjs/runtimeConfig.browser.js +7 -2
  25. package/dist-cjs/runtimeConfig.js +9 -3
  26. package/dist-es/Kendra.js +180 -0
  27. package/dist-es/commands/AssociateEntitiesToExperienceCommand.js +39 -0
  28. package/dist-es/commands/AssociatePersonasToEntitiesCommand.js +39 -0
  29. package/dist-es/commands/CreateExperienceCommand.js +39 -0
  30. package/dist-es/commands/DeleteExperienceCommand.js +39 -0
  31. package/dist-es/commands/DescribeExperienceCommand.js +39 -0
  32. package/dist-es/commands/DisassociateEntitiesFromExperienceCommand.js +39 -0
  33. package/dist-es/commands/DisassociatePersonasFromEntitiesCommand.js +39 -0
  34. package/dist-es/commands/GetSnapshotsCommand.js +39 -0
  35. package/dist-es/commands/ListEntityPersonasCommand.js +39 -0
  36. package/dist-es/commands/ListExperienceEntitiesCommand.js +39 -0
  37. package/dist-es/commands/ListExperiencesCommand.js +39 -0
  38. package/dist-es/commands/UpdateExperienceCommand.js +39 -0
  39. package/dist-es/commands/index.js +12 -0
  40. package/dist-es/endpoints.js +1 -16
  41. package/dist-es/models/models_0.js +215 -44
  42. package/dist-es/pagination/ListEntityPersonasPaginator.js +74 -0
  43. package/dist-es/pagination/ListExperienceEntitiesPaginator.js +73 -0
  44. package/dist-es/pagination/ListExperiencesPaginator.js +74 -0
  45. package/dist-es/pagination/index.js +3 -0
  46. package/dist-es/protocols/Aws_json1_1.js +2042 -234
  47. package/dist-es/runtimeConfig.browser.js +12 -3
  48. package/dist-es/runtimeConfig.js +13 -6
  49. package/dist-types/Kendra.d.ts +164 -1
  50. package/dist-types/KendraClient.d.ts +19 -3
  51. package/dist-types/commands/AssociateEntitiesToExperienceCommand.d.ts +39 -0
  52. package/dist-types/commands/AssociatePersonasToEntitiesCommand.d.ts +39 -0
  53. package/dist-types/commands/ClearQuerySuggestionsCommand.d.ts +3 -0
  54. package/dist-types/commands/CreateDataSourceCommand.d.ts +2 -0
  55. package/dist-types/commands/CreateExperienceCommand.d.ts +37 -0
  56. package/dist-types/commands/CreateQuerySuggestionsBlockListCommand.d.ts +3 -0
  57. package/dist-types/commands/DeleteExperienceCommand.d.ts +37 -0
  58. package/dist-types/commands/DeletePrincipalMappingCommand.d.ts +3 -0
  59. package/dist-types/commands/DeleteQuerySuggestionsBlockListCommand.d.ts +3 -0
  60. package/dist-types/commands/DescribeExperienceCommand.d.ts +38 -0
  61. package/dist-types/commands/DescribePrincipalMappingCommand.d.ts +3 -0
  62. package/dist-types/commands/DescribeQuerySuggestionsBlockListCommand.d.ts +3 -0
  63. package/dist-types/commands/DescribeQuerySuggestionsConfigCommand.d.ts +3 -0
  64. package/dist-types/commands/DisassociateEntitiesFromExperienceCommand.d.ts +39 -0
  65. package/dist-types/commands/DisassociatePersonasFromEntitiesCommand.d.ts +39 -0
  66. package/dist-types/commands/GetQuerySuggestionsCommand.d.ts +3 -0
  67. package/dist-types/commands/GetSnapshotsCommand.d.ts +37 -0
  68. package/dist-types/commands/ListEntityPersonasCommand.d.ts +36 -0
  69. package/dist-types/commands/ListExperienceEntitiesCommand.d.ts +39 -0
  70. package/dist-types/commands/ListExperiencesCommand.d.ts +38 -0
  71. package/dist-types/commands/ListGroupsOlderThanOrderingIdCommand.d.ts +3 -0
  72. package/dist-types/commands/ListQuerySuggestionsBlockListsCommand.d.ts +3 -0
  73. package/dist-types/commands/PutPrincipalMappingCommand.d.ts +3 -0
  74. package/dist-types/commands/SubmitFeedbackCommand.d.ts +4 -1
  75. package/dist-types/commands/UpdateExperienceCommand.d.ts +37 -0
  76. package/dist-types/commands/UpdateQuerySuggestionsBlockListCommand.d.ts +3 -0
  77. package/dist-types/commands/UpdateQuerySuggestionsConfigCommand.d.ts +3 -0
  78. package/dist-types/commands/index.d.ts +12 -0
  79. package/dist-types/models/models_0.d.ts +1217 -147
  80. package/dist-types/pagination/ListEntityPersonasPaginator.d.ts +4 -0
  81. package/dist-types/pagination/ListExperienceEntitiesPaginator.d.ts +4 -0
  82. package/dist-types/pagination/ListExperiencesPaginator.d.ts +4 -0
  83. package/dist-types/pagination/index.d.ts +3 -0
  84. package/dist-types/protocols/Aws_json1_1.d.ts +36 -0
  85. package/dist-types/runtimeConfig.browser.d.ts +3 -2
  86. package/dist-types/runtimeConfig.d.ts +4 -3
  87. package/dist-types/runtimeConfig.native.d.ts +1 -0
  88. package/dist-types/ts3.4/Kendra.d.ts +60 -0
  89. package/dist-types/ts3.4/KendraClient.d.ts +17 -3
  90. package/dist-types/ts3.4/commands/AssociateEntitiesToExperienceCommand.d.ts +17 -0
  91. package/dist-types/ts3.4/commands/AssociatePersonasToEntitiesCommand.d.ts +17 -0
  92. package/dist-types/ts3.4/commands/CreateExperienceCommand.d.ts +17 -0
  93. package/dist-types/ts3.4/commands/DeleteExperienceCommand.d.ts +17 -0
  94. package/dist-types/ts3.4/commands/DescribeExperienceCommand.d.ts +17 -0
  95. package/dist-types/ts3.4/commands/DisassociateEntitiesFromExperienceCommand.d.ts +17 -0
  96. package/dist-types/ts3.4/commands/DisassociatePersonasFromEntitiesCommand.d.ts +17 -0
  97. package/dist-types/ts3.4/commands/GetSnapshotsCommand.d.ts +17 -0
  98. package/dist-types/ts3.4/commands/ListEntityPersonasCommand.d.ts +17 -0
  99. package/dist-types/ts3.4/commands/ListExperienceEntitiesCommand.d.ts +17 -0
  100. package/dist-types/ts3.4/commands/ListExperiencesCommand.d.ts +17 -0
  101. package/dist-types/ts3.4/commands/UpdateExperienceCommand.d.ts +17 -0
  102. package/dist-types/ts3.4/commands/index.d.ts +12 -0
  103. package/dist-types/ts3.4/models/models_0.d.ts +579 -77
  104. package/dist-types/ts3.4/pagination/ListEntityPersonasPaginator.d.ts +4 -0
  105. package/dist-types/ts3.4/pagination/ListExperienceEntitiesPaginator.d.ts +4 -0
  106. package/dist-types/ts3.4/pagination/ListExperiencesPaginator.d.ts +4 -0
  107. package/dist-types/ts3.4/pagination/index.d.ts +3 -0
  108. package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +36 -0
  109. package/dist-types/ts3.4/runtimeConfig.browser.d.ts +3 -2
  110. package/dist-types/ts3.4/runtimeConfig.d.ts +4 -3
  111. package/dist-types/ts3.4/runtimeConfig.native.d.ts +1 -0
  112. package/package.json +38 -45
@@ -24,12 +24,6 @@ export interface AccessDeniedException extends __SmithyException, $MetadataBeare
24
24
  $fault: "client";
25
25
  Message?: string;
26
26
  }
27
- export declare namespace AccessDeniedException {
28
- /**
29
- * @internal
30
- */
31
- const filterSensitiveLog: (obj: AccessDeniedException) => any;
32
- }
33
27
  /**
34
28
  * <p>Provides information about the column that should be used for
35
29
  * filtering the query response by groups.</p>
@@ -149,6 +143,196 @@ export declare namespace AdditionalResultAttribute {
149
143
  */
150
144
  const filterSensitiveLog: (obj: AdditionalResultAttribute) => any;
151
145
  }
146
+ export declare enum EntityType {
147
+ GROUP = "GROUP",
148
+ USER = "USER"
149
+ }
150
+ /**
151
+ * <p>Provides the configuration information of users or groups in
152
+ * your Amazon Web Services SSO identity source to grant access your Amazon Kendra
153
+ * experience.</p>
154
+ */
155
+ export interface EntityConfiguration {
156
+ /**
157
+ * <p>The identifier of a user or group in your Amazon Web Services SSO identity
158
+ * source. For example, a user ID could be an email.</p>
159
+ */
160
+ EntityId: string | undefined;
161
+ /**
162
+ * <p>Specifies whether you are configuring a <code>User</code> or a
163
+ * <code>Group</code>.</p>
164
+ */
165
+ EntityType: EntityType | string | undefined;
166
+ }
167
+ export declare namespace EntityConfiguration {
168
+ /**
169
+ * @internal
170
+ */
171
+ const filterSensitiveLog: (obj: EntityConfiguration) => any;
172
+ }
173
+ export interface AssociateEntitiesToExperienceRequest {
174
+ /**
175
+ * <p>The identifier of your Amazon Kendra experience.</p>
176
+ */
177
+ Id: string | undefined;
178
+ /**
179
+ * <p>The identifier of the index for your Amazon Kendra experience.</p>
180
+ */
181
+ IndexId: string | undefined;
182
+ /**
183
+ * <p>Lists users or groups in your Amazon Web Services SSO identity source.</p>
184
+ */
185
+ EntityList: EntityConfiguration[] | undefined;
186
+ }
187
+ export declare namespace AssociateEntitiesToExperienceRequest {
188
+ /**
189
+ * @internal
190
+ */
191
+ const filterSensitiveLog: (obj: AssociateEntitiesToExperienceRequest) => any;
192
+ }
193
+ /**
194
+ * <p>Information on the users or groups in your Amazon Web Services SSO identity
195
+ * source that failed to properly configure with your Amazon Kendra experience.</p>
196
+ */
197
+ export interface FailedEntity {
198
+ /**
199
+ * <p>The identifier of the user or group in your Amazon Web Services SSO identity
200
+ * source. For example, a user ID could be an email.</p>
201
+ */
202
+ EntityId?: string;
203
+ /**
204
+ * <p>The reason the user or group in your Amazon Web Services SSO identity source
205
+ * failed to properly configure with your Amazon Kendra experience.</p>
206
+ */
207
+ ErrorMessage?: string;
208
+ }
209
+ export declare namespace FailedEntity {
210
+ /**
211
+ * @internal
212
+ */
213
+ const filterSensitiveLog: (obj: FailedEntity) => any;
214
+ }
215
+ export interface AssociateEntitiesToExperienceResponse {
216
+ /**
217
+ * <p>Lists the users or groups in your Amazon Web Services SSO identity source that
218
+ * failed to properly configure with your Amazon Kendra experience.</p>
219
+ */
220
+ FailedEntityList?: FailedEntity[];
221
+ }
222
+ export declare namespace AssociateEntitiesToExperienceResponse {
223
+ /**
224
+ * @internal
225
+ */
226
+ const filterSensitiveLog: (obj: AssociateEntitiesToExperienceResponse) => any;
227
+ }
228
+ /**
229
+ * <p></p>
230
+ */
231
+ export interface InternalServerException extends __SmithyException, $MetadataBearer {
232
+ name: "InternalServerException";
233
+ $fault: "server";
234
+ Message?: string;
235
+ }
236
+ /**
237
+ * <p></p>
238
+ */
239
+ export interface ResourceAlreadyExistException extends __SmithyException, $MetadataBearer {
240
+ name: "ResourceAlreadyExistException";
241
+ $fault: "client";
242
+ Message?: string;
243
+ }
244
+ /**
245
+ * <p></p>
246
+ */
247
+ export interface ResourceNotFoundException extends __SmithyException, $MetadataBearer {
248
+ name: "ResourceNotFoundException";
249
+ $fault: "client";
250
+ Message?: string;
251
+ }
252
+ /**
253
+ * <p></p>
254
+ */
255
+ export interface ThrottlingException extends __SmithyException, $MetadataBearer {
256
+ name: "ThrottlingException";
257
+ $fault: "client";
258
+ Message?: string;
259
+ }
260
+ /**
261
+ * <p></p>
262
+ */
263
+ export interface ValidationException extends __SmithyException, $MetadataBearer {
264
+ name: "ValidationException";
265
+ $fault: "client";
266
+ Message?: string;
267
+ }
268
+ export declare enum Persona {
269
+ OWNER = "OWNER",
270
+ VIEWER = "VIEWER"
271
+ }
272
+ /**
273
+ * <p>Provides the configuration information of users or groups in your
274
+ * Amazon Web Services SSO identity source for access to your Amazon Kendra experience.
275
+ * Specific permissions are defined for each user or group once they are
276
+ * granted access to your Amazon Kendra experience.</p>
277
+ */
278
+ export interface EntityPersonaConfiguration {
279
+ /**
280
+ * <p>The identifier of a user or group in your Amazon Web Services SSO identity
281
+ * source. For example, a user ID could be an email.</p>
282
+ */
283
+ EntityId: string | undefined;
284
+ /**
285
+ * <p>The persona that defines the specific permissions of the user or group
286
+ * in your Amazon Web Services SSO identity source. The available personas or
287
+ * access roles are <code>Owner</code> and <code>Viewer</code>. For more
288
+ * information on these personas, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html#access-search-experience">Providing
289
+ * access to your search page</a>.</p>
290
+ */
291
+ Persona: Persona | string | undefined;
292
+ }
293
+ export declare namespace EntityPersonaConfiguration {
294
+ /**
295
+ * @internal
296
+ */
297
+ const filterSensitiveLog: (obj: EntityPersonaConfiguration) => any;
298
+ }
299
+ export interface AssociatePersonasToEntitiesRequest {
300
+ /**
301
+ * <p>The identifier of your Amazon Kendra experience.</p>
302
+ */
303
+ Id: string | undefined;
304
+ /**
305
+ * <p>The identifier of the index for your Amazon Kendra experience.</p>
306
+ */
307
+ IndexId: string | undefined;
308
+ /**
309
+ * <p>The personas that define the specific permissions of users or groups in
310
+ * your Amazon Web Services SSO identity source. The available personas or access
311
+ * roles are <code>Owner</code> and <code>Viewer</code>. For more information
312
+ * on these personas, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html#access-search-experience">Providing
313
+ * access to your search page</a>.</p>
314
+ */
315
+ Personas: EntityPersonaConfiguration[] | undefined;
316
+ }
317
+ export declare namespace AssociatePersonasToEntitiesRequest {
318
+ /**
319
+ * @internal
320
+ */
321
+ const filterSensitiveLog: (obj: AssociatePersonasToEntitiesRequest) => any;
322
+ }
323
+ export interface AssociatePersonasToEntitiesResponse {
324
+ /**
325
+ * <p>Lists the users or groups in your Amazon Web Services SSO identity source that
326
+ * failed to properly configure with your Amazon Kendra experience.</p>
327
+ */
328
+ FailedEntityList?: FailedEntity[];
329
+ }
330
+ export declare namespace AssociatePersonasToEntitiesResponse {
331
+ /**
332
+ * @internal
333
+ */
334
+ const filterSensitiveLog: (obj: AssociatePersonasToEntitiesResponse) => any;
335
+ }
152
336
  /**
153
337
  * <p>The value of a custom document attribute. You can only provide one
154
338
  * value for a custom attribute.</p>
@@ -221,7 +405,7 @@ export interface BasicAuthenticationConfiguration {
221
405
  */
222
406
  Port: number | undefined;
223
407
  /**
224
- * <p>Your secret ARN, which you can create in <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">AWS Secrets Manager</a>
408
+ * <p>Your secret ARN, which you can create in <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">Secrets Manager</a>
225
409
  * </p>
226
410
  * <p>You use a secret if basic authentication credentials are required to connect
227
411
  * to a website. The secret stores your credentials of user name and password.</p>
@@ -354,68 +538,6 @@ export interface ConflictException extends __SmithyException, $MetadataBearer {
354
538
  $fault: "client";
355
539
  Message?: string;
356
540
  }
357
- export declare namespace ConflictException {
358
- /**
359
- * @internal
360
- */
361
- const filterSensitiveLog: (obj: ConflictException) => any;
362
- }
363
- /**
364
- * <p></p>
365
- */
366
- export interface InternalServerException extends __SmithyException, $MetadataBearer {
367
- name: "InternalServerException";
368
- $fault: "server";
369
- Message?: string;
370
- }
371
- export declare namespace InternalServerException {
372
- /**
373
- * @internal
374
- */
375
- const filterSensitiveLog: (obj: InternalServerException) => any;
376
- }
377
- /**
378
- * <p></p>
379
- */
380
- export interface ResourceNotFoundException extends __SmithyException, $MetadataBearer {
381
- name: "ResourceNotFoundException";
382
- $fault: "client";
383
- Message?: string;
384
- }
385
- export declare namespace ResourceNotFoundException {
386
- /**
387
- * @internal
388
- */
389
- const filterSensitiveLog: (obj: ResourceNotFoundException) => any;
390
- }
391
- /**
392
- * <p></p>
393
- */
394
- export interface ThrottlingException extends __SmithyException, $MetadataBearer {
395
- name: "ThrottlingException";
396
- $fault: "client";
397
- Message?: string;
398
- }
399
- export declare namespace ThrottlingException {
400
- /**
401
- * @internal
402
- */
403
- const filterSensitiveLog: (obj: ThrottlingException) => any;
404
- }
405
- /**
406
- * <p></p>
407
- */
408
- export interface ValidationException extends __SmithyException, $MetadataBearer {
409
- name: "ValidationException";
410
- $fault: "client";
411
- Message?: string;
412
- }
413
- export declare namespace ValidationException {
414
- /**
415
- * @internal
416
- */
417
- const filterSensitiveLog: (obj: ValidationException) => any;
418
- }
419
541
  /**
420
542
  * <p>Identifies a document for which to retrieve status
421
543
  * information</p>
@@ -573,6 +695,216 @@ export declare namespace BatchGetDocumentStatusResponse {
573
695
  */
574
696
  const filterSensitiveLog: (obj: BatchGetDocumentStatusResponse) => any;
575
697
  }
698
+ export declare enum ConditionOperator {
699
+ BeginsWith = "BeginsWith",
700
+ Contains = "Contains",
701
+ Equals = "Equals",
702
+ Exists = "Exists",
703
+ GreaterThan = "GreaterThan",
704
+ GreaterThanOrEquals = "GreaterThanOrEquals",
705
+ LessThan = "LessThan",
706
+ LessThanOrEquals = "LessThanOrEquals",
707
+ NotContains = "NotContains",
708
+ NotEquals = "NotEquals",
709
+ NotExists = "NotExists"
710
+ }
711
+ /**
712
+ * <p>The condition used for the target document attribute or metadata field when
713
+ * ingesting documents into Amazon Kendra. You use this with <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_DocumentAttributeTarget.html">DocumentAttributeTarget
714
+ * to apply the condition</a>.</p>
715
+ * <p>For example, you can create the 'Department' target field and have it prefill
716
+ * department names associated with the documents based on information in the
717
+ * 'Source_URI' field. Set the condition that if the 'Source_URI' field contains
718
+ * 'financial' in its URI value, then prefill the target field 'Department' with
719
+ * the target value 'Finance' for the document.</p>
720
+ * <p>Amazon Kendra cannot create a target field if it has not already been created as an
721
+ * index field. After you create your index field, you can create a document metadata
722
+ * field using <code>DocumentAttributeTarget</code>. Amazon Kendra then will map your newly
723
+ * created metadata field to your index field.</p>
724
+ */
725
+ export interface DocumentAttributeCondition {
726
+ /**
727
+ * <p>The identifier of the document attribute used for the condition.</p>
728
+ * <p>For example, 'Source_URI' could be an identifier for the attribute or metadata
729
+ * field that contains source URIs associated with the documents.</p>
730
+ * <p>Amazon Kendra currently does not support <code>_document_body</code> as an attribute
731
+ * key used for the condition.</p>
732
+ */
733
+ ConditionDocumentAttributeKey: string | undefined;
734
+ /**
735
+ * <p>The condition operator.</p>
736
+ * <p>For example, you can use 'Contains' to partially match a string.</p>
737
+ */
738
+ Operator: ConditionOperator | string | undefined;
739
+ /**
740
+ * <p>The value used by the operator.</p>
741
+ * <p>For example, you can specify the value 'financial' for strings in the 'Source_URI'
742
+ * field that partially match or contain this value.</p>
743
+ */
744
+ ConditionOnValue?: DocumentAttributeValue;
745
+ }
746
+ export declare namespace DocumentAttributeCondition {
747
+ /**
748
+ * @internal
749
+ */
750
+ const filterSensitiveLog: (obj: DocumentAttributeCondition) => any;
751
+ }
752
+ /**
753
+ * <p>The target document attribute or metadata field you want to alter when ingesting
754
+ * documents into Amazon Kendra.</p>
755
+ * <p>For example, you can delete customer identification numbers associated with the
756
+ * documents, stored in the document metadata field called 'Customer_ID'. You set the
757
+ * target key as 'Customer_ID' and the deletion flag to <code>TRUE</code>. This
758
+ * removes all customer ID values in the field 'Customer_ID'. This would scrub
759
+ * personally identifiable information from each document's metadata.</p>
760
+ * <p>Amazon Kendra cannot create a target field if it has not already been created as an
761
+ * index field. After you create your index field, you can create a document metadata
762
+ * field using <code>DocumentAttributeTarget</code>. Amazon Kendra then will map your newly
763
+ * created metadata field to your index field.</p>
764
+ * <p>You can also use this with <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_DocumentAttributeCondition.html">DocumentAttributeCondition</a>.</p>
765
+ */
766
+ export interface DocumentAttributeTarget {
767
+ /**
768
+ * <p>The identifier of the target document attribute or metadata field.</p>
769
+ * <p>For example, 'Department' could be an identifier for the target attribute or
770
+ * metadata field that includes the department names associated with the documents.</p>
771
+ */
772
+ TargetDocumentAttributeKey?: string;
773
+ /**
774
+ * <p>
775
+ * <code>TRUE</code> to delete the existing target value for your specified target
776
+ * attribute key. You cannot create a target value and set this to <code>TRUE</code>.
777
+ * To create a target value (<code>TargetDocumentAttributeValue</code>), set this to
778
+ * <code>FALSE</code>.</p>
779
+ */
780
+ TargetDocumentAttributeValueDeletion?: boolean;
781
+ /**
782
+ * <p>The target value you want to create for the target attribute.</p>
783
+ * <p>For example, 'Finance' could be the target value for the target attribute key
784
+ * 'Department'.</p>
785
+ */
786
+ TargetDocumentAttributeValue?: DocumentAttributeValue;
787
+ }
788
+ export declare namespace DocumentAttributeTarget {
789
+ /**
790
+ * @internal
791
+ */
792
+ const filterSensitiveLog: (obj: DocumentAttributeTarget) => any;
793
+ }
794
+ /**
795
+ * <p>Provides the configuration information for applying basic logic to alter document
796
+ * metadata and content when ingesting documents into Amazon Kendra. To apply advanced
797
+ * logic, to go beyond what you can do with basic logic, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_HookConfiguration.html">HookConfiguration</a>.</p>
798
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html">Customizing document metadata
799
+ * during the ingestion process</a>.</p>
800
+ */
801
+ export interface InlineCustomDocumentEnrichmentConfiguration {
802
+ /**
803
+ * <p>Configuration of the condition used for the target document attribute or metadata
804
+ * field when ingesting documents into Amazon Kendra.</p>
805
+ */
806
+ Condition?: DocumentAttributeCondition;
807
+ /**
808
+ * <p>Configuration of the target document attribute or metadata field when ingesting
809
+ * documents into Amazon Kendra. You can also include a value.</p>
810
+ */
811
+ Target?: DocumentAttributeTarget;
812
+ /**
813
+ * <p>
814
+ * <code>TRUE</code> to delete content if the condition used for the target
815
+ * attribute is met.</p>
816
+ */
817
+ DocumentContentDeletion?: boolean;
818
+ }
819
+ export declare namespace InlineCustomDocumentEnrichmentConfiguration {
820
+ /**
821
+ * @internal
822
+ */
823
+ const filterSensitiveLog: (obj: InlineCustomDocumentEnrichmentConfiguration) => any;
824
+ }
825
+ /**
826
+ * <p>Provides the configuration information for invoking a Lambda function in
827
+ * Lambda to alter document metadata and content when ingesting
828
+ * documents into Amazon Kendra. You can configure your Lambda function using
829
+ * <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_PreExtractionHookConfiguration.html">PreExtractionHookConfiguration</a>
830
+ * if you want to apply advanced alterations on the original or raw documents.
831
+ * If you want to apply advanced alterations on the Amazon Kendra structured documents,
832
+ * you must configure your Lambda function using <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_PostExtractionHookConfiguration.html">PostExtractionHookConfiguration</a>.
833
+ * You can only invoke one Lambda function. However, this function can invoke other
834
+ * functions it requires.</p>
835
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html">Customizing document metadata
836
+ * during the ingestion process</a>.</p>
837
+ */
838
+ export interface HookConfiguration {
839
+ /**
840
+ * <p>The condition used for when a Lambda function should be invoked.</p>
841
+ * <p>For example, you can specify a condition that if there are empty date-time
842
+ * values, then Amazon Kendra should invoke a function that inserts the current date-time.</p>
843
+ */
844
+ InvocationCondition?: DocumentAttributeCondition;
845
+ /**
846
+ * <p>The Amazon Resource Name (ARN) of a role with permission to run a Lambda function
847
+ * during ingestion. For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html">IAM roles for Amazon Kendra</a>.</p>
848
+ */
849
+ LambdaArn: string | undefined;
850
+ /**
851
+ * <p>Stores the original, raw documents or the structured, parsed
852
+ * documents before and after altering them. For more information,
853
+ * see <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html#cde-data-contracts-lambda">Data
854
+ * contracts for Lambda functions</a>.</p>
855
+ */
856
+ S3Bucket: string | undefined;
857
+ }
858
+ export declare namespace HookConfiguration {
859
+ /**
860
+ * @internal
861
+ */
862
+ const filterSensitiveLog: (obj: HookConfiguration) => any;
863
+ }
864
+ /**
865
+ * <p>Provides the configuration information for altering document metadata and content
866
+ * during the document ingestion process.</p>
867
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html">Customizing document metadata
868
+ * during the ingestion process</a>.</p>
869
+ */
870
+ export interface CustomDocumentEnrichmentConfiguration {
871
+ /**
872
+ * <p>Configuration information to alter document attributes or metadata fields and
873
+ * content when ingesting documents into Amazon Kendra.</p>
874
+ */
875
+ InlineConfigurations?: InlineCustomDocumentEnrichmentConfiguration[];
876
+ /**
877
+ * <p>Configuration information for invoking a Lambda function in Lambda
878
+ * on the original or raw documents before extracting their metadata and text. You can
879
+ * use a Lambda function to apply advanced logic for creating, modifying, or deleting
880
+ * document metadata and content. For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html#advanced-data-manipulation">Advanced
881
+ * data manipulation</a>.</p>
882
+ */
883
+ PreExtractionHookConfiguration?: HookConfiguration;
884
+ /**
885
+ * <p>Configuration information for invoking a Lambda function in Lambda
886
+ * on the structured documents with their metadata and text extracted. You can use a
887
+ * Lambda function to apply advanced logic for creating, modifying, or deleting document
888
+ * metadata and content. For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html#advanced-data-manipulation">Advanced
889
+ * data manipulation</a>.</p>
890
+ */
891
+ PostExtractionHookConfiguration?: HookConfiguration;
892
+ /**
893
+ * <p>The Amazon Resource Name (ARN) of a role with permission to run
894
+ * <code>PreExtractionHookConfiguration</code> and
895
+ * <code>PostExtractionHookConfiguration</code> for altering document metadata
896
+ * and content during the document ingestion process. For more information,
897
+ * see <a href="https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html">IAM roles for
898
+ * Amazon Kendra</a>.</p>
899
+ */
900
+ RoleArn?: string;
901
+ }
902
+ export declare namespace CustomDocumentEnrichmentConfiguration {
903
+ /**
904
+ * @internal
905
+ */
906
+ const filterSensitiveLog: (obj: CustomDocumentEnrichmentConfiguration) => any;
907
+ }
576
908
  export declare enum ReadAccessType {
577
909
  ALLOW = "ALLOW",
578
910
  DENY = "DENY"
@@ -750,6 +1082,16 @@ export interface BatchPutDocumentRequest {
750
1082
  * quotas, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/quotas.html">Quotas</a>.</p>
751
1083
  */
752
1084
  Documents: Document[] | undefined;
1085
+ /**
1086
+ * <p>Configuration information for altering your document metadata and content during
1087
+ * the document ingestion process when you use the <code>BatchPutDocument</code>
1088
+ * operation.</p>
1089
+ * <p>For more information on how to create, modify and delete document metadata,
1090
+ * or make other content alterations when you ingest documents into Amazon Kendra, see
1091
+ * <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html">Customizing
1092
+ * document metadata during the ingestion process</a>.</p>
1093
+ */
1094
+ CustomDocumentEnrichmentConfiguration?: CustomDocumentEnrichmentConfiguration;
753
1095
  }
754
1096
  export declare namespace BatchPutDocumentRequest {
755
1097
  /**
@@ -810,12 +1152,6 @@ export interface ServiceQuotaExceededException extends __SmithyException, $Metad
810
1152
  $fault: "client";
811
1153
  Message?: string;
812
1154
  }
813
- export declare namespace ServiceQuotaExceededException {
814
- /**
815
- * @internal
816
- */
817
- const filterSensitiveLog: (obj: ServiceQuotaExceededException) => any;
818
- }
819
1155
  export interface ClearQuerySuggestionsRequest {
820
1156
  /**
821
1157
  * <p>The identifier of the index you want to clear query suggestions from.</p>
@@ -1159,7 +1495,7 @@ export interface ConfluenceConfiguration {
1159
1495
  */
1160
1496
  ServerUrl: string | undefined;
1161
1497
  /**
1162
- * <p>The Amazon Resource Name (ARN) of an Secrets Managersecret
1498
+ * <p>The Amazon Resource Name (ARN) of an Secrets Manager secret
1163
1499
  * that contains the key/value pairs required to connect to your
1164
1500
  * Confluence server. The secret must contain a JSON structure with the
1165
1501
  * following keys:</p>
@@ -2116,7 +2452,7 @@ export interface ServiceNowConfiguration {
2116
2452
  /**
2117
2453
  * <p>Determines the type of authentication used to connect to the
2118
2454
  * ServiceNow instance. If you choose <code>HTTP_BASIC</code>, Amazon Kendra is
2119
- * authenticated using the user name and password provided in the AWS
2455
+ * authenticated using the user name and password provided in the
2120
2456
  * Secrets Manager secret in the <code>SecretArn</code> field. When you
2121
2457
  * choose <code>OAUTH2</code>, Amazon Kendra is authenticated using the OAuth
2122
2458
  * token and secret provided in the Secrets Manager secret, and the
@@ -2162,7 +2498,7 @@ export interface SharePointConfiguration {
2162
2498
  * domain name as part of the credentials. For
2163
2499
  * more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/data-source-sharepoint.html">Using a
2164
2500
  * Microsoft SharePoint Data Source</a>. For more information
2165
- * about Secrets Manager, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html"> What Is
2501
+ * about Secrets Manager see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html"> What Is
2166
2502
  * Secrets Manager</a> in the <i>Secrets Manager
2167
2503
  * </i> user guide.</p>
2168
2504
  */
@@ -2259,7 +2595,7 @@ export interface ProxyConfiguration {
2259
2595
  */
2260
2596
  Port: number | undefined;
2261
2597
  /**
2262
- * <p>Your secret ARN, which you can create in <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">AWS Secrets Manager</a>
2598
+ * <p>Your secret ARN, which you can create in <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">Secrets Manager</a>
2263
2599
  * </p>
2264
2600
  * <p>The credentials are optional. You use a secret if web proxy credentials
2265
2601
  * are required to connect to a website host. Amazon Kendra currently support basic
@@ -2284,8 +2620,8 @@ export declare enum WebCrawlerMode {
2284
2620
  * <p>
2285
2621
  * <i>When selecting websites to index, you must adhere to
2286
2622
  * the <a href="https://aws.amazon.com/aup/">Amazon Acceptable Use Policy</a>
2287
- * and all other Amazon terms. Remember that you must only use the Amazon Kendra web
2288
- * crawler to index your own webpages, or webpages that you have authorization
2623
+ * and all other Amazon terms. Remember that you must only use Amazon Kendra Web
2624
+ * Crawler to index your own webpages, or webpages that you have authorization
2289
2625
  * to index.</i>
2290
2626
  * </p>
2291
2627
  */
@@ -2332,8 +2668,8 @@ export declare namespace SeedUrlConfiguration {
2332
2668
  * <p>
2333
2669
  * <i>When selecting websites to index, you must adhere to
2334
2670
  * the <a href="https://aws.amazon.com/aup/">Amazon Acceptable Use Policy</a>
2335
- * and all other Amazon terms. Remember that you must only use the Amazon Kendra web
2336
- * crawler to index your own webpages, or webpages that you have authorization
2671
+ * and all other Amazon terms. Remember that you must only use Amazon Kendra Web
2672
+ * Crawler to index your own webpages, or webpages that you have authorization
2337
2673
  * to index.</i>
2338
2674
  * </p>
2339
2675
  */
@@ -2359,8 +2695,8 @@ export declare namespace SiteMapsConfiguration {
2359
2695
  * <p>
2360
2696
  * <i>When selecting websites to index, you must adhere to
2361
2697
  * the <a href="https://aws.amazon.com/aup/">Amazon Acceptable Use Policy</a>
2362
- * and all other Amazon terms. Remember that you must only use the Amazon Kendra web
2363
- * crawler to index your own webpages, or webpages that you have authorization to
2698
+ * and all other Amazon terms. Remember that you must only use Amazon Kendra Web
2699
+ * Crawler to index your own webpages, or webpages that you have authorization to
2364
2700
  * index.</i>
2365
2701
  * </p>
2366
2702
  */
@@ -2389,7 +2725,7 @@ export declare namespace Urls {
2389
2725
  }
2390
2726
  /**
2391
2727
  * <p>Provides the configuration information required for Amazon Kendra
2392
- * web crawler.</p>
2728
+ * Web Crawler.</p>
2393
2729
  */
2394
2730
  export interface WebCrawlerConfiguration {
2395
2731
  /**
@@ -2403,8 +2739,8 @@ export interface WebCrawlerConfiguration {
2403
2739
  * <p>
2404
2740
  * <i>When selecting websites to index, you must adhere to
2405
2741
  * the <a href="https://aws.amazon.com/aup/">Amazon Acceptable Use Policy</a>
2406
- * and all other Amazon terms. Remember that you must only use the Amazon Kendra
2407
- * web crawler to index your own webpages, or webpages that you have
2742
+ * and all other Amazon terms. Remember that you must only use Amazon Kendra
2743
+ * Web Crawler to index your own webpages, or webpages that you have
2408
2744
  * authorization to index.</i>
2409
2745
  * </p>
2410
2746
  */
@@ -2459,7 +2795,7 @@ export interface WebCrawlerConfiguration {
2459
2795
  * port is 443, the standard port for HTTPS.</p>
2460
2796
  * <p>Web proxy credentials are optional and you can use them to connect to a
2461
2797
  * web proxy server that requires basic authentication. To store web proxy
2462
- * credentials, you use a secret in <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">AWS Secrets Manager</a>.</p>
2798
+ * credentials, you use a secret in <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">Secrets Manager</a>.</p>
2463
2799
  */
2464
2800
  ProxyConfiguration?: ProxyConfiguration;
2465
2801
  /**
@@ -2468,7 +2804,7 @@ export interface WebCrawlerConfiguration {
2468
2804
  * <p>You can connect to websites using basic authentication of user name and password.</p>
2469
2805
  * <p>You must provide the website host name and port number. For example, the host name
2470
2806
  * of https://a.example.com/page1.html is "a.example.com" and the port is 443, the
2471
- * standard port for HTTPS. You use a secret in <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">AWS Secrets Manager</a> to store
2807
+ * standard port for HTTPS. You use a secret in <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html">Secrets Manager</a> to store
2472
2808
  * your authentication credentials.</p>
2473
2809
  */
2474
2810
  AuthenticationConfiguration?: AuthenticationConfiguration;
@@ -2490,11 +2826,11 @@ export interface WorkDocsConfiguration {
2490
2826
  * <p>The identifier of the directory corresponding to your
2491
2827
  * Amazon WorkDocs site repository.</p>
2492
2828
  * <p>You can find the organization ID in the
2493
- * <a href="https://console.aws.amazon.com/directoryservicev2/">AWS Directory Service</a> by going to
2829
+ * <a href="https://console.aws.amazon.com/directoryservicev2/">Directory Service</a> by going to
2494
2830
  * <b>Active Directory</b>, then
2495
2831
  * <b>Directories</b>. Your Amazon WorkDocs site directory has an
2496
2832
  * ID, which is the organization ID. You can also set up a new Amazon WorkDocs
2497
- * directory in the AWS Directory Service console and enable a Amazon WorkDocs site
2833
+ * directory in the Directory Service console and enable a Amazon WorkDocs site
2498
2834
  * for the directory in the Amazon WorkDocs console.</p>
2499
2835
  */
2500
2836
  OrganizationId: string | undefined;
@@ -2553,7 +2889,7 @@ export declare namespace WorkDocsConfiguration {
2553
2889
  const filterSensitiveLog: (obj: WorkDocsConfiguration) => any;
2554
2890
  }
2555
2891
  /**
2556
- * <p>Configuration information for a Amazon Kendra data source.</p>
2892
+ * <p>Configuration information for an Amazon Kendra data source.</p>
2557
2893
  */
2558
2894
  export interface DataSourceConfiguration {
2559
2895
  /**
@@ -2598,7 +2934,7 @@ export interface DataSourceConfiguration {
2598
2934
  GoogleDriveConfiguration?: GoogleDriveConfiguration;
2599
2935
  /**
2600
2936
  * <p>Provides the configuration information required for Amazon Kendra
2601
- * web crawler.</p>
2937
+ * Web Crawler.</p>
2602
2938
  */
2603
2939
  WebCrawlerConfiguration?: WebCrawlerConfiguration;
2604
2940
  /**
@@ -2720,6 +3056,15 @@ export interface CreateDataSourceRequest {
2720
3056
  * documents in languages other than English</a>.</p>
2721
3057
  */
2722
3058
  LanguageCode?: string;
3059
+ /**
3060
+ * <p>Configuration information for altering document metadata and content during the
3061
+ * document ingestion process when you create a data source.</p>
3062
+ * <p>For more information on how to create, modify and delete document metadata, or make
3063
+ * other content alterations when you ingest documents into Amazon Kendra, see
3064
+ * <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html">Customizing
3065
+ * document metadata during the ingestion process</a>.</p>
3066
+ */
3067
+ CustomDocumentEnrichmentConfiguration?: CustomDocumentEnrichmentConfiguration;
2723
3068
  }
2724
3069
  export declare namespace CreateDataSourceRequest {
2725
3070
  /**
@@ -2740,18 +3085,127 @@ export declare namespace CreateDataSourceResponse {
2740
3085
  const filterSensitiveLog: (obj: CreateDataSourceResponse) => any;
2741
3086
  }
2742
3087
  /**
2743
- * <p></p>
3088
+ * <p>Configuration information for your content sources, such as data sources,
3089
+ * FAQs, and content indexed directly via <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_BatchPutDocument.html">BatchPutDocument</a>.</p>
2744
3090
  */
2745
- export interface ResourceAlreadyExistException extends __SmithyException, $MetadataBearer {
2746
- name: "ResourceAlreadyExistException";
2747
- $fault: "client";
2748
- Message?: string;
3091
+ export interface ContentSourceConfiguration {
3092
+ /**
3093
+ * <p>The identifier of the data sources you want to use for your Amazon Kendra experience.</p>
3094
+ */
3095
+ DataSourceIds?: string[];
3096
+ /**
3097
+ * <p>The identifier of the FAQs that you want to use for your Amazon Kendra experience.</p>
3098
+ */
3099
+ FaqIds?: string[];
3100
+ /**
3101
+ * <p>
3102
+ * <code>TRUE</code> to use documents you indexed directly using the
3103
+ * <code>BatchPutDocument</code> operation.</p>
3104
+ */
3105
+ DirectPutContent?: boolean;
3106
+ }
3107
+ export declare namespace ContentSourceConfiguration {
3108
+ /**
3109
+ * @internal
3110
+ */
3111
+ const filterSensitiveLog: (obj: ContentSourceConfiguration) => any;
3112
+ }
3113
+ /**
3114
+ * <p>Configuration information for the identifiers of your users.</p>
3115
+ */
3116
+ export interface UserIdentityConfiguration {
3117
+ /**
3118
+ * <p>The Amazon Web Services SSO field name that contains the identifiers of your users,
3119
+ * such as their emails. This is used for <a href="https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html">user context filtering</a>
3120
+ * and for granting access to your Amazon Kendra experience. You must set up Amazon Web Services SSO
3121
+ * with Amazon Kendra. You must include your users and groups in your Access Control List when
3122
+ * you ingest documents into your index. For more information, see
3123
+ * <a href="https://docs.aws.amazon.com/kendra/latest/dg/getting-started-aws-sso.html">Getting
3124
+ * started with an Amazon Web Services SSO identity source</a>.</p>
3125
+ */
3126
+ IdentityAttributeName?: string;
3127
+ }
3128
+ export declare namespace UserIdentityConfiguration {
3129
+ /**
3130
+ * @internal
3131
+ */
3132
+ const filterSensitiveLog: (obj: UserIdentityConfiguration) => any;
3133
+ }
3134
+ /**
3135
+ * <p>Specifies the configuration information for your Amazon Kendra experience. This includes
3136
+ * the data source IDs and/or FAQ IDs, and user or group information to grant access
3137
+ * to your Amazon Kendra experience.</p>
3138
+ */
3139
+ export interface ExperienceConfiguration {
3140
+ /**
3141
+ * <p>The identifiers of your data sources and FAQs. Or, you can specify
3142
+ * that you want to use documents indexed via the <code>BatchPutDocument</code>
3143
+ * operation. This is the content you want to use for your Amazon Kendra experience.</p>
3144
+ */
3145
+ ContentSourceConfiguration?: ContentSourceConfiguration;
3146
+ /**
3147
+ * <p>The Amazon Web Services SSO field name that contains the identifiers of your users,
3148
+ * such as their emails.</p>
3149
+ */
3150
+ UserIdentityConfiguration?: UserIdentityConfiguration;
2749
3151
  }
2750
- export declare namespace ResourceAlreadyExistException {
3152
+ export declare namespace ExperienceConfiguration {
2751
3153
  /**
2752
3154
  * @internal
2753
3155
  */
2754
- const filterSensitiveLog: (obj: ResourceAlreadyExistException) => any;
3156
+ const filterSensitiveLog: (obj: ExperienceConfiguration) => any;
3157
+ }
3158
+ export interface CreateExperienceRequest {
3159
+ /**
3160
+ * <p>A name for your Amazon Kendra experience.</p>
3161
+ */
3162
+ Name: string | undefined;
3163
+ /**
3164
+ * <p>The identifier of the index for your Amazon Kendra experience.</p>
3165
+ */
3166
+ IndexId: string | undefined;
3167
+ /**
3168
+ * <p>The Amazon Resource Name (ARN) of a role with permission to access <code>Query</code>
3169
+ * operations, <code>QuerySuggestions</code> operations, <code>SubmitFeedback</code>
3170
+ * operations, and Amazon Web Services SSO that stores your user and group information.
3171
+ * For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html">IAM roles for Amazon Kendra</a>.</p>
3172
+ */
3173
+ RoleArn?: string;
3174
+ /**
3175
+ * <p>Provides the configuration information for your Amazon Kendra experience. This includes
3176
+ * <code>ContentSourceConfiguration</code>, which specifies the data source IDs
3177
+ * and/or FAQ IDs, and <code>UserIdentityConfiguration</code>, which specifies the
3178
+ * user or group information to grant access to your Amazon Kendra experience.</p>
3179
+ */
3180
+ Configuration?: ExperienceConfiguration;
3181
+ /**
3182
+ * <p>A description for your Amazon Kendra experience.</p>
3183
+ */
3184
+ Description?: string;
3185
+ /**
3186
+ * <p>A token that you provide to identify the request to create your Amazon Kendra experience.
3187
+ * Multiple calls to the <code>CreateExperience</code> operation with the same client
3188
+ * token creates only one Amazon Kendra experience.</p>
3189
+ */
3190
+ ClientToken?: string;
3191
+ }
3192
+ export declare namespace CreateExperienceRequest {
3193
+ /**
3194
+ * @internal
3195
+ */
3196
+ const filterSensitiveLog: (obj: CreateExperienceRequest) => any;
3197
+ }
3198
+ export interface CreateExperienceResponse {
3199
+ /**
3200
+ * <p>The identifier for your created Amazon Kendra experience.</p>
3201
+ */
3202
+ Id: string | undefined;
3203
+ }
3204
+ export declare namespace CreateExperienceResponse {
3205
+ /**
3206
+ * @internal
3207
+ */
3208
+ const filterSensitiveLog: (obj: CreateExperienceResponse) => any;
2755
3209
  }
2756
3210
  export declare enum FaqFileFormat {
2757
3211
  CSV = "CSV",
@@ -2860,26 +3314,26 @@ export declare enum UserGroupResolutionMode {
2860
3314
  }
2861
3315
  /**
2862
3316
  * <p>Provides the configuration information to fetch access levels
2863
- * of groups and users from an AWS Single Sign-On identity
3317
+ * of groups and users from an Amazon Web Services Single Sign On identity
2864
3318
  * source. This is useful for setting up user context filtering, where
2865
3319
  * Amazon Kendra filters search results for different users based on their
2866
3320
  * group's access to documents. You can also map your users to their
2867
3321
  * groups for user context filtering using the
2868
- * <a href="https://docs.aws.amazon.com/latest/dg/API_PutPrincipalMapping.html">PutPrincipalMapping
3322
+ * <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html">PutPrincipalMapping
2869
3323
  * operation</a>.</p>
2870
- * <p>To set up an AWS SSO identity source in the console to use with
3324
+ * <p>To set up an Amazon Web Services SSO identity source in the console to use with
2871
3325
  * Amazon Kendra, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/getting-started-aws-sso.html">Getting started
2872
- * with an AWS SSO identity source</a>. You must also grant the required
2873
- * permissions to use AWS SSO with Amazon Kendra. For more information, see
3326
+ * with an Amazon Web Services SSO identity source</a>. You must also grant the required
3327
+ * permissions to use Amazon Web Services SSO with Amazon Kendra. For more information, see
2874
3328
  * <a href="https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-aws-sso">IAM roles for
2875
- * AWS Single Sign-On</a>.</p>
3329
+ * Amazon Web Services SSO</a>.</p>
2876
3330
  */
2877
3331
  export interface UserGroupResolutionConfiguration {
2878
3332
  /**
2879
3333
  * <p>The identity store provider (mode) you want to use to fetch access levels of groups and
2880
- * users. AWS Single Sign-On is currently the only available mode. Your users and groups
3334
+ * users. Amazon Web Services Single Sign On is currently the only available mode. Your users and groups
2881
3335
  * must
2882
- * exist in an AWS SSO identity source in order to use this mode.</p>
3336
+ * exist in an Amazon Web Services SSO identity source in order to use this mode.</p>
2883
3337
  */
2884
3338
  UserGroupResolutionMode: UserGroupResolutionMode | string | undefined;
2885
3339
  }
@@ -3045,7 +3499,7 @@ export interface CreateIndexRequest {
3045
3499
  */
3046
3500
  UserContextPolicy?: UserContextPolicy | string;
3047
3501
  /**
3048
- * <p>Enables fetching access levels of groups and users from an AWS Single Sign-On
3502
+ * <p>Enables fetching access levels of groups and users from an Amazon Web Services Single Sign On
3049
3503
  * identity source. To configure this, see
3050
3504
  * <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html">UserGroupResolutionConfiguration</a>.</p>
3051
3505
  */
@@ -3149,7 +3603,7 @@ export interface CreateThesaurusRequest {
3149
3603
  */
3150
3604
  Description?: string;
3151
3605
  /**
3152
- * <p>An AWS Identity and Access Management (IAM) role that gives Amazon Kendra permissions
3606
+ * <p>An IAM role that gives Amazon Kendra permissions
3153
3607
  * to access thesaurus file specified in <code>SourceS3Path</code>.
3154
3608
  * </p>
3155
3609
  */
@@ -3210,6 +3664,30 @@ export declare namespace DeleteDataSourceRequest {
3210
3664
  */
3211
3665
  const filterSensitiveLog: (obj: DeleteDataSourceRequest) => any;
3212
3666
  }
3667
+ export interface DeleteExperienceRequest {
3668
+ /**
3669
+ * <p>The identifier of your Amazon Kendra experience you want to delete.</p>
3670
+ */
3671
+ Id: string | undefined;
3672
+ /**
3673
+ * <p>The identifier of the index for your Amazon Kendra experience you want to delete.</p>
3674
+ */
3675
+ IndexId: string | undefined;
3676
+ }
3677
+ export declare namespace DeleteExperienceRequest {
3678
+ /**
3679
+ * @internal
3680
+ */
3681
+ const filterSensitiveLog: (obj: DeleteExperienceRequest) => any;
3682
+ }
3683
+ export interface DeleteExperienceResponse {
3684
+ }
3685
+ export declare namespace DeleteExperienceResponse {
3686
+ /**
3687
+ * @internal
3688
+ */
3689
+ const filterSensitiveLog: (obj: DeleteExperienceResponse) => any;
3690
+ }
3213
3691
  export interface DeleteFaqRequest {
3214
3692
  /**
3215
3693
  * <p>The identifier of the FAQ to remove.</p>
@@ -3403,6 +3881,15 @@ export interface DescribeDataSourceResponse {
3403
3881
  * documents in languages other than English</a>.</p>
3404
3882
  */
3405
3883
  LanguageCode?: string;
3884
+ /**
3885
+ * <p>Configuration information for altering document metadata and content during the
3886
+ * document ingestion process when you describe a data source.</p>
3887
+ * <p>For more information on how to create, modify and delete document metadata, or make
3888
+ * other content alterations when you ingest documents into Amazon Kendra, see
3889
+ * <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html">Customizing
3890
+ * document metadata during the ingestion process</a>.</p>
3891
+ */
3892
+ CustomDocumentEnrichmentConfiguration?: CustomDocumentEnrichmentConfiguration;
3406
3893
  }
3407
3894
  export declare namespace DescribeDataSourceResponse {
3408
3895
  /**
@@ -3410,6 +3897,116 @@ export declare namespace DescribeDataSourceResponse {
3410
3897
  */
3411
3898
  const filterSensitiveLog: (obj: DescribeDataSourceResponse) => any;
3412
3899
  }
3900
+ export interface DescribeExperienceRequest {
3901
+ /**
3902
+ * <p>The identifier of your Amazon Kendra experience you want to get information on.</p>
3903
+ */
3904
+ Id: string | undefined;
3905
+ /**
3906
+ * <p>The identifier of the index for your Amazon Kendra experience you want to get
3907
+ * information on.</p>
3908
+ */
3909
+ IndexId: string | undefined;
3910
+ }
3911
+ export declare namespace DescribeExperienceRequest {
3912
+ /**
3913
+ * @internal
3914
+ */
3915
+ const filterSensitiveLog: (obj: DescribeExperienceRequest) => any;
3916
+ }
3917
+ export declare enum EndpointType {
3918
+ HOME = "HOME"
3919
+ }
3920
+ /**
3921
+ * <p>Provides the configuration information of the endpoint for your Amazon Kendra
3922
+ * experience.</p>
3923
+ */
3924
+ export interface ExperienceEndpoint {
3925
+ /**
3926
+ * <p>The type of endpoint for your Amazon Kendra experience. The type currently available
3927
+ * is <code>HOME</code>, which is a unique and fully hosted URL to the home page
3928
+ * of your Amazon Kendra experience.</p>
3929
+ */
3930
+ EndpointType?: EndpointType | string;
3931
+ /**
3932
+ * <p>The endpoint of your Amazon Kendra experience.</p>
3933
+ */
3934
+ Endpoint?: string;
3935
+ }
3936
+ export declare namespace ExperienceEndpoint {
3937
+ /**
3938
+ * @internal
3939
+ */
3940
+ const filterSensitiveLog: (obj: ExperienceEndpoint) => any;
3941
+ }
3942
+ export declare enum ExperienceStatus {
3943
+ ACTIVE = "ACTIVE",
3944
+ CREATING = "CREATING",
3945
+ DELETING = "DELETING",
3946
+ FAILED = "FAILED"
3947
+ }
3948
+ export interface DescribeExperienceResponse {
3949
+ /**
3950
+ * <p>Shows the identifier of your Amazon Kendra experience.</p>
3951
+ */
3952
+ Id?: string;
3953
+ /**
3954
+ * <p>Shows the identifier of the index for your Amazon Kendra experience.</p>
3955
+ */
3956
+ IndexId?: string;
3957
+ /**
3958
+ * <p>Shows the name of your Amazon Kendra experience.</p>
3959
+ */
3960
+ Name?: string;
3961
+ /**
3962
+ * <p>Shows the endpoint URLs for your Amazon Kendra experiences. The URLs are unique and fully
3963
+ * hosted by Amazon Web Services.</p>
3964
+ */
3965
+ Endpoints?: ExperienceEndpoint[];
3966
+ /**
3967
+ * <p>Shows the configuration information for your Amazon Kendra experience. This includes
3968
+ * <code>ContentSourceConfiguration</code>, which specifies the data source IDs
3969
+ * and/or FAQ IDs, and <code>UserIdentityConfiguration</code>, which specifies the
3970
+ * user or group information to grant access to your Amazon Kendra experience.</p>
3971
+ */
3972
+ Configuration?: ExperienceConfiguration;
3973
+ /**
3974
+ * <p>Shows the date-time your Amazon Kendra experience was created.</p>
3975
+ */
3976
+ CreatedAt?: Date;
3977
+ /**
3978
+ * <p>Shows the date-time your Amazon Kendra experience was last updated.</p>
3979
+ */
3980
+ UpdatedAt?: Date;
3981
+ /**
3982
+ * <p>Shows the description for your Amazon Kendra experience.</p>
3983
+ */
3984
+ Description?: string;
3985
+ /**
3986
+ * <p>The current processing status of your Amazon Kendra experience. When the status
3987
+ * is <code>ACTIVE</code>, your Amazon Kendra experience is ready to use. When the
3988
+ * status is <code>FAILED</code>, the <code>ErrorMessage</code> field contains
3989
+ * the reason that this failed.</p>
3990
+ */
3991
+ Status?: ExperienceStatus | string;
3992
+ /**
3993
+ * <p>Shows the Amazon Resource Name (ARN) of a role with permission to access
3994
+ * <code>Query</code> operations, <code>QuerySuggestions</code> operations,
3995
+ * <code>SubmitFeedback</code> operations, and Amazon Web Services SSO that stores
3996
+ * your user and group information.</p>
3997
+ */
3998
+ RoleArn?: string;
3999
+ /**
4000
+ * <p>The reason your Amazon Kendra experience could not properly process.</p>
4001
+ */
4002
+ ErrorMessage?: string;
4003
+ }
4004
+ export declare namespace DescribeExperienceResponse {
4005
+ /**
4006
+ * @internal
4007
+ */
4008
+ const filterSensitiveLog: (obj: DescribeExperienceResponse) => any;
4009
+ }
3413
4010
  export interface DescribeFaqRequest {
3414
4011
  /**
3415
4012
  * <p>The unique identifier of the FAQ.</p>
@@ -3833,7 +4430,7 @@ export interface DescribeIndexResponse {
3833
4430
  UserContextPolicy?: UserContextPolicy | string;
3834
4431
  /**
3835
4432
  * <p>Shows whether you have enabled the configuration for fetching access
3836
- * levels of groups and users from an AWS Single Sign-On identity source.</p>
4433
+ * levels of groups and users from an Amazon Web Services Single Sign On identity source.</p>
3837
4434
  */
3838
4435
  UserGroupResolutionConfiguration?: UserGroupResolutionConfiguration;
3839
4436
  }
@@ -4212,7 +4809,7 @@ export interface DescribeThesaurusResponse {
4212
4809
  */
4213
4810
  UpdatedAt?: Date;
4214
4811
  /**
4215
- * <p>An AWS Identity and Access Management (IAM) role that gives Amazon Kendra permissions
4812
+ * <p>An IAM role that gives Amazon Kendra permissions
4216
4813
  * to access thesaurus file specified in <code>SourceS3Path</code>.
4217
4814
  * </p>
4218
4815
  */
@@ -4244,6 +4841,73 @@ export declare namespace DescribeThesaurusResponse {
4244
4841
  */
4245
4842
  const filterSensitiveLog: (obj: DescribeThesaurusResponse) => any;
4246
4843
  }
4844
+ export interface DisassociateEntitiesFromExperienceRequest {
4845
+ /**
4846
+ * <p>The identifier of your Amazon Kendra experience.</p>
4847
+ */
4848
+ Id: string | undefined;
4849
+ /**
4850
+ * <p>The identifier of the index for your Amazon Kendra experience.</p>
4851
+ */
4852
+ IndexId: string | undefined;
4853
+ /**
4854
+ * <p>Lists users or groups in your Amazon Web Services SSO identity source.</p>
4855
+ */
4856
+ EntityList: EntityConfiguration[] | undefined;
4857
+ }
4858
+ export declare namespace DisassociateEntitiesFromExperienceRequest {
4859
+ /**
4860
+ * @internal
4861
+ */
4862
+ const filterSensitiveLog: (obj: DisassociateEntitiesFromExperienceRequest) => any;
4863
+ }
4864
+ export interface DisassociateEntitiesFromExperienceResponse {
4865
+ /**
4866
+ * <p>Lists the users or groups in your Amazon Web Services SSO identity source that
4867
+ * failed to properly remove access to your Amazon Kendra experience.</p>
4868
+ */
4869
+ FailedEntityList?: FailedEntity[];
4870
+ }
4871
+ export declare namespace DisassociateEntitiesFromExperienceResponse {
4872
+ /**
4873
+ * @internal
4874
+ */
4875
+ const filterSensitiveLog: (obj: DisassociateEntitiesFromExperienceResponse) => any;
4876
+ }
4877
+ export interface DisassociatePersonasFromEntitiesRequest {
4878
+ /**
4879
+ * <p>The identifier of your Amazon Kendra experience.</p>
4880
+ */
4881
+ Id: string | undefined;
4882
+ /**
4883
+ * <p>The identifier of the index for your Amazon Kendra experience.</p>
4884
+ */
4885
+ IndexId: string | undefined;
4886
+ /**
4887
+ * <p>The identifiers of users or groups in your Amazon Web Services SSO identity
4888
+ * source. For example, user IDs could be user emails.</p>
4889
+ */
4890
+ EntityIds: string[] | undefined;
4891
+ }
4892
+ export declare namespace DisassociatePersonasFromEntitiesRequest {
4893
+ /**
4894
+ * @internal
4895
+ */
4896
+ const filterSensitiveLog: (obj: DisassociatePersonasFromEntitiesRequest) => any;
4897
+ }
4898
+ export interface DisassociatePersonasFromEntitiesResponse {
4899
+ /**
4900
+ * <p>Lists the users or groups in your Amazon Web Services SSO identity source that
4901
+ * failed to properly remove access to your Amazon Kendra experience.</p>
4902
+ */
4903
+ FailedEntityList?: FailedEntity[];
4904
+ }
4905
+ export declare namespace DisassociatePersonasFromEntitiesResponse {
4906
+ /**
4907
+ * @internal
4908
+ */
4909
+ const filterSensitiveLog: (obj: DisassociatePersonasFromEntitiesResponse) => any;
4910
+ }
4247
4911
  export interface GetQuerySuggestionsRequest {
4248
4912
  /**
4249
4913
  * <p>The identifier of the index you want to get query suggestions from.</p>
@@ -4363,6 +5027,146 @@ export declare namespace GetQuerySuggestionsResponse {
4363
5027
  */
4364
5028
  const filterSensitiveLog: (obj: GetQuerySuggestionsResponse) => any;
4365
5029
  }
5030
+ export declare enum Interval {
5031
+ ONE_MONTH_AGO = "ONE_MONTH_AGO",
5032
+ ONE_WEEK_AGO = "ONE_WEEK_AGO",
5033
+ THIS_MONTH = "THIS_MONTH",
5034
+ THIS_WEEK = "THIS_WEEK",
5035
+ TWO_MONTHS_AGO = "TWO_MONTHS_AGO",
5036
+ TWO_WEEKS_AGO = "TWO_WEEKS_AGO"
5037
+ }
5038
+ export declare enum MetricType {
5039
+ AGG_QUERY_DOC_METRICS = "AGG_QUERY_DOC_METRICS",
5040
+ DOCS_BY_CLICK_COUNT = "DOCS_BY_CLICK_COUNT",
5041
+ QUERIES_BY_COUNT = "QUERIES_BY_COUNT",
5042
+ QUERIES_BY_ZERO_CLICK_RATE = "QUERIES_BY_ZERO_CLICK_RATE",
5043
+ QUERIES_BY_ZERO_RESULT_RATE = "QUERIES_BY_ZERO_RESULT_RATE",
5044
+ TREND_QUERY_DOC_METRICS = "TREND_QUERY_DOC_METRICS"
5045
+ }
5046
+ export interface GetSnapshotsRequest {
5047
+ /**
5048
+ * <p>The identifier of the index to get search metrics data.</p>
5049
+ */
5050
+ IndexId: string | undefined;
5051
+ /**
5052
+ * <p>The time interval or time window to get search metrics data.
5053
+ * The time interval uses the time zone of your index.
5054
+ * You can view data in the following time windows:</p>
5055
+ * <ul>
5056
+ * <li>
5057
+ * <p>
5058
+ * <code>THIS_WEEK</code>: The current week, starting on
5059
+ * the Sunday and ending on the day before the current date.</p>
5060
+ * </li>
5061
+ * <li>
5062
+ * <p>
5063
+ * <code>ONE_WEEK_AGO</code>: The previous week, starting on
5064
+ * the Sunday and ending on the following Saturday.</p>
5065
+ * </li>
5066
+ * <li>
5067
+ * <p>
5068
+ * <code>TWO_WEEKS_AGO</code>: The week before the previous week,
5069
+ * starting on the Sunday and ending on the following Saturday.</p>
5070
+ * </li>
5071
+ * <li>
5072
+ * <p>
5073
+ * <code>THIS_MONTH</code>: The current month, starting on the
5074
+ * first day of the month and ending on the day before the current date.</p>
5075
+ * </li>
5076
+ * <li>
5077
+ * <p>
5078
+ * <code>ONE_MONTH_AGO</code>: The previous month, starting on the
5079
+ * first day of the month and ending on the last day of the month.</p>
5080
+ * </li>
5081
+ * <li>
5082
+ * <p>
5083
+ * <code>TWO_MONTHS_AGO</code>: The month before the previous month,
5084
+ * starting on the first day of the month and ending on last day of the month.</p>
5085
+ * </li>
5086
+ * </ul>
5087
+ */
5088
+ Interval: Interval | string | undefined;
5089
+ /**
5090
+ * <p>The metric you want to retrieve. You
5091
+ * can specify only one metric per call.</p>
5092
+ * <p>For more information about the metrics you can view, see
5093
+ * <a href="https://docs.aws.amazon.com/kendra/latest/dg/search-analytics.html">Gaining
5094
+ * insights with search analytics</a>.</p>
5095
+ */
5096
+ MetricType: MetricType | string | undefined;
5097
+ /**
5098
+ * <p>If the previous response was incomplete (because there
5099
+ * is more data to retrieve), Amazon Kendra returns a pagination token in
5100
+ * the response. You can use this pagination token to
5101
+ * retrieve the next set of search metrics data.</p>
5102
+ */
5103
+ NextToken?: string;
5104
+ /**
5105
+ * <p>The maximum number of returned data for the metric.</p>
5106
+ */
5107
+ MaxResults?: number;
5108
+ }
5109
+ export declare namespace GetSnapshotsRequest {
5110
+ /**
5111
+ * @internal
5112
+ */
5113
+ const filterSensitiveLog: (obj: GetSnapshotsRequest) => any;
5114
+ }
5115
+ /**
5116
+ * <p>Provides a range of time.</p>
5117
+ */
5118
+ export interface TimeRange {
5119
+ /**
5120
+ * <p>The UNIX datetime of the beginning of the time range.</p>
5121
+ */
5122
+ StartTime?: Date;
5123
+ /**
5124
+ * <p>The UNIX datetime of the end of the time range.</p>
5125
+ */
5126
+ EndTime?: Date;
5127
+ }
5128
+ export declare namespace TimeRange {
5129
+ /**
5130
+ * @internal
5131
+ */
5132
+ const filterSensitiveLog: (obj: TimeRange) => any;
5133
+ }
5134
+ export interface GetSnapshotsResponse {
5135
+ /**
5136
+ * <p>The date-time for the beginning and end of the time window
5137
+ * for the search metrics data.</p>
5138
+ */
5139
+ SnapShotTimeFilter?: TimeRange;
5140
+ /**
5141
+ * <p>The column headers for the search metrics data.</p>
5142
+ */
5143
+ SnapshotsDataHeader?: string[];
5144
+ /**
5145
+ * <p>The search metrics data. The data returned depends on the
5146
+ * metric type you requested.</p>
5147
+ */
5148
+ SnapshotsData?: string[][];
5149
+ /**
5150
+ * <p>If the response is truncated, Amazon Kendra returns this
5151
+ * token, which you can use in a later request to retrieve the
5152
+ * next set of search metrics data.</p>
5153
+ */
5154
+ NextToken?: string;
5155
+ }
5156
+ export declare namespace GetSnapshotsResponse {
5157
+ /**
5158
+ * @internal
5159
+ */
5160
+ const filterSensitiveLog: (obj: GetSnapshotsResponse) => any;
5161
+ }
5162
+ /**
5163
+ * <p>The input to the request is not valid.</p>
5164
+ */
5165
+ export interface InvalidRequestException extends __SmithyException, $MetadataBearer {
5166
+ name: "InvalidRequestException";
5167
+ $fault: "client";
5168
+ Message?: string;
5169
+ }
4366
5170
  export interface ListDataSourcesRequest {
4367
5171
  /**
4368
5172
  * <p>The identifier of the index that contains the data source.</p>
@@ -4449,25 +5253,6 @@ export declare namespace ListDataSourcesResponse {
4449
5253
  */
4450
5254
  const filterSensitiveLog: (obj: ListDataSourcesResponse) => any;
4451
5255
  }
4452
- /**
4453
- * <p>Provides a range of time.</p>
4454
- */
4455
- export interface TimeRange {
4456
- /**
4457
- * <p>The UNIX datetime of the beginning of the time range.</p>
4458
- */
4459
- StartTime?: Date;
4460
- /**
4461
- * <p>The UNIX datetime of the end of the time range.</p>
4462
- */
4463
- EndTime?: Date;
4464
- }
4465
- export declare namespace TimeRange {
4466
- /**
4467
- * @internal
4468
- */
4469
- const filterSensitiveLog: (obj: TimeRange) => any;
4470
- }
4471
5256
  export declare enum DataSourceSyncJobStatus {
4472
5257
  ABORTED = "ABORTED",
4473
5258
  FAILED = "FAILED",
@@ -4627,6 +5412,258 @@ export declare namespace ListDataSourceSyncJobsResponse {
4627
5412
  */
4628
5413
  const filterSensitiveLog: (obj: ListDataSourceSyncJobsResponse) => any;
4629
5414
  }
5415
+ export interface ListEntityPersonasRequest {
5416
+ /**
5417
+ * <p>The identifier of your Amazon Kendra experience.</p>
5418
+ */
5419
+ Id: string | undefined;
5420
+ /**
5421
+ * <p>The identifier of the index for your Amazon Kendra experience.</p>
5422
+ */
5423
+ IndexId: string | undefined;
5424
+ /**
5425
+ * <p>If the previous response was incomplete (because there is more data to retrieve),
5426
+ * Amazon Kendra returns a pagination token in the response. You can use this pagination
5427
+ * token to retrieve the next set of users or groups.</p>
5428
+ */
5429
+ NextToken?: string;
5430
+ /**
5431
+ * <p>The maximum number of returned users or groups.</p>
5432
+ */
5433
+ MaxResults?: number;
5434
+ }
5435
+ export declare namespace ListEntityPersonasRequest {
5436
+ /**
5437
+ * @internal
5438
+ */
5439
+ const filterSensitiveLog: (obj: ListEntityPersonasRequest) => any;
5440
+ }
5441
+ /**
5442
+ * <p>Summary information for users or groups in your Amazon Web Services SSO identity
5443
+ * source. This applies to users and groups with specific permissions that define
5444
+ * their level of access to your Amazon Kendra experience. You can create an Amazon Kendra experience
5445
+ * such as a search application. For more information on creating a search application
5446
+ * experience, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html">Building a
5447
+ * search experience with no code</a>.</p>
5448
+ */
5449
+ export interface PersonasSummary {
5450
+ /**
5451
+ * <p>The identifier of a user or group in your Amazon Web Services SSO identity source.
5452
+ * For example, a user ID could be an email.</p>
5453
+ */
5454
+ EntityId?: string;
5455
+ /**
5456
+ * <p>The persona that defines the specific permissions of the user or group in
5457
+ * your Amazon Web Services SSO identity source. The available personas or access
5458
+ * roles are <code>Owner</code> and <code>Viewer</code>. For more information on
5459
+ * these personas, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html#access-search-experience">Providing
5460
+ * access to your search page</a>.</p>
5461
+ */
5462
+ Persona?: Persona | string;
5463
+ /**
5464
+ * <p>The date-time the summary information was created.</p>
5465
+ */
5466
+ CreatedAt?: Date;
5467
+ /**
5468
+ * <p>The date-time the summary information was last updated.</p>
5469
+ */
5470
+ UpdatedAt?: Date;
5471
+ }
5472
+ export declare namespace PersonasSummary {
5473
+ /**
5474
+ * @internal
5475
+ */
5476
+ const filterSensitiveLog: (obj: PersonasSummary) => any;
5477
+ }
5478
+ export interface ListEntityPersonasResponse {
5479
+ /**
5480
+ * <p>An array of summary information for one or more users or groups.</p>
5481
+ */
5482
+ SummaryItems?: PersonasSummary[];
5483
+ /**
5484
+ * <p>If the response is truncated, Amazon Kendra returns this token, which you can use in
5485
+ * a later request to retrieve the next set of users or groups.</p>
5486
+ */
5487
+ NextToken?: string;
5488
+ }
5489
+ export declare namespace ListEntityPersonasResponse {
5490
+ /**
5491
+ * @internal
5492
+ */
5493
+ const filterSensitiveLog: (obj: ListEntityPersonasResponse) => any;
5494
+ }
5495
+ export interface ListExperienceEntitiesRequest {
5496
+ /**
5497
+ * <p>The identifier of your Amazon Kendra experience.</p>
5498
+ */
5499
+ Id: string | undefined;
5500
+ /**
5501
+ * <p>The identifier of the index for your Amazon Kendra experience.</p>
5502
+ */
5503
+ IndexId: string | undefined;
5504
+ /**
5505
+ * <p>If the previous response was incomplete (because there is more data to retrieve),
5506
+ * Amazon Kendra returns a pagination token in the response. You can use this pagination
5507
+ * token to retrieve the next set of users or groups.</p>
5508
+ */
5509
+ NextToken?: string;
5510
+ }
5511
+ export declare namespace ListExperienceEntitiesRequest {
5512
+ /**
5513
+ * @internal
5514
+ */
5515
+ const filterSensitiveLog: (obj: ListExperienceEntitiesRequest) => any;
5516
+ }
5517
+ /**
5518
+ * <p>Information about the user entity.</p>
5519
+ */
5520
+ export interface EntityDisplayData {
5521
+ /**
5522
+ * <p>The name of the user.</p>
5523
+ */
5524
+ UserName?: string;
5525
+ /**
5526
+ * <p>The name of the group.</p>
5527
+ */
5528
+ GroupName?: string;
5529
+ /**
5530
+ * <p>The user name of the user.</p>
5531
+ */
5532
+ IdentifiedUserName?: string;
5533
+ /**
5534
+ * <p>The first name of the user.</p>
5535
+ */
5536
+ FirstName?: string;
5537
+ /**
5538
+ * <p>The last name of the user.</p>
5539
+ */
5540
+ LastName?: string;
5541
+ }
5542
+ export declare namespace EntityDisplayData {
5543
+ /**
5544
+ * @internal
5545
+ */
5546
+ const filterSensitiveLog: (obj: EntityDisplayData) => any;
5547
+ }
5548
+ /**
5549
+ * <p>Summary information for users or groups in your Amazon Web Services SSO identity
5550
+ * source with granted access to your Amazon Kendra experience. You can create an Amazon Kendra
5551
+ * experience such as a search application. For more information on creating a
5552
+ * search application experience, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html">Building
5553
+ * a search experience with no code</a>.</p>
5554
+ */
5555
+ export interface ExperienceEntitiesSummary {
5556
+ /**
5557
+ * <p>The identifier of a user or group in your Amazon Web Services SSO identity source.
5558
+ * For example, a user ID could be an email.</p>
5559
+ */
5560
+ EntityId?: string;
5561
+ /**
5562
+ * <p>Shows the type as <code>User</code> or <code>Group</code>.</p>
5563
+ */
5564
+ EntityType?: EntityType | string;
5565
+ /**
5566
+ * <p>Information about the user entity.</p>
5567
+ */
5568
+ DisplayData?: EntityDisplayData;
5569
+ }
5570
+ export declare namespace ExperienceEntitiesSummary {
5571
+ /**
5572
+ * @internal
5573
+ */
5574
+ const filterSensitiveLog: (obj: ExperienceEntitiesSummary) => any;
5575
+ }
5576
+ export interface ListExperienceEntitiesResponse {
5577
+ /**
5578
+ * <p>An array of summary information for one or more users or groups.</p>
5579
+ */
5580
+ SummaryItems?: ExperienceEntitiesSummary[];
5581
+ /**
5582
+ * <p>If the response is truncated, Amazon Kendra returns this token, which you can use in
5583
+ * a later request to retrieve the next set of users or groups.</p>
5584
+ */
5585
+ NextToken?: string;
5586
+ }
5587
+ export declare namespace ListExperienceEntitiesResponse {
5588
+ /**
5589
+ * @internal
5590
+ */
5591
+ const filterSensitiveLog: (obj: ListExperienceEntitiesResponse) => any;
5592
+ }
5593
+ export interface ListExperiencesRequest {
5594
+ /**
5595
+ * <p>The identifier of the index for your Amazon Kendra experience.</p>
5596
+ */
5597
+ IndexId: string | undefined;
5598
+ /**
5599
+ * <p>If the previous response was incomplete (because there is more data
5600
+ * to retrieve), Amazon Kendra returns a pagination token in the response. You can use this
5601
+ * pagination token to retrieve the next set of Amazon Kendra experiences.</p>
5602
+ */
5603
+ NextToken?: string;
5604
+ /**
5605
+ * <p>The maximum number of returned Amazon Kendra experiences.</p>
5606
+ */
5607
+ MaxResults?: number;
5608
+ }
5609
+ export declare namespace ListExperiencesRequest {
5610
+ /**
5611
+ * @internal
5612
+ */
5613
+ const filterSensitiveLog: (obj: ListExperiencesRequest) => any;
5614
+ }
5615
+ /**
5616
+ * <p>Summary information for your Amazon Kendra experience. You can create an Amazon Kendra
5617
+ * experience such as a search application. For more information on creating
5618
+ * a search application experience, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html">Building
5619
+ * a search experience with no code</a>.</p>
5620
+ */
5621
+ export interface ExperiencesSummary {
5622
+ /**
5623
+ * <p>The name of your Amazon Kendra experience.</p>
5624
+ */
5625
+ Name?: string;
5626
+ /**
5627
+ * <p>The identifier of your Amazon Kendra experience.</p>
5628
+ */
5629
+ Id?: string;
5630
+ /**
5631
+ * <p>The date-time your Amazon Kendra experience was created.</p>
5632
+ */
5633
+ CreatedAt?: Date;
5634
+ /**
5635
+ * <p>The processing status of your Amazon Kendra experience.</p>
5636
+ */
5637
+ Status?: ExperienceStatus | string;
5638
+ /**
5639
+ * <p>The endpoint URLs for your Amazon Kendra experiences. The URLs are unique
5640
+ * and fully hosted by Amazon Web Services.</p>
5641
+ */
5642
+ Endpoints?: ExperienceEndpoint[];
5643
+ }
5644
+ export declare namespace ExperiencesSummary {
5645
+ /**
5646
+ * @internal
5647
+ */
5648
+ const filterSensitiveLog: (obj: ExperiencesSummary) => any;
5649
+ }
5650
+ export interface ListExperiencesResponse {
5651
+ /**
5652
+ * <p>An array of summary information for one or more Amazon Kendra experiences.</p>
5653
+ */
5654
+ SummaryItems?: ExperiencesSummary[];
5655
+ /**
5656
+ * <p>If the response is truncated, Amazon Kendra returns this token, which you can use
5657
+ * in a later request to retrieve the next set of Amazon Kendra experiences.</p>
5658
+ */
5659
+ NextToken?: string;
5660
+ }
5661
+ export declare namespace ListExperiencesResponse {
5662
+ /**
5663
+ * @internal
5664
+ */
5665
+ const filterSensitiveLog: (obj: ListExperiencesResponse) => any;
5666
+ }
4630
5667
  export interface ListFaqsRequest {
4631
5668
  /**
4632
5669
  * <p>The index that contains the FAQ lists.</p>
@@ -5003,12 +6040,6 @@ export interface ResourceUnavailableException extends __SmithyException, $Metada
5003
6040
  $fault: "client";
5004
6041
  Message?: string;
5005
6042
  }
5006
- export declare namespace ResourceUnavailableException {
5007
- /**
5008
- * @internal
5009
- */
5010
- const filterSensitiveLog: (obj: ResourceUnavailableException) => any;
5011
- }
5012
6043
  export interface ListThesauriRequest {
5013
6044
  /**
5014
6045
  * <p>The identifier of the index associated with the thesaurus to list.</p>
@@ -5577,12 +6608,6 @@ export interface ResourceInUseException extends __SmithyException, $MetadataBear
5577
6608
  $fault: "client";
5578
6609
  Message?: string;
5579
6610
  }
5580
- export declare namespace ResourceInUseException {
5581
- /**
5582
- * @internal
5583
- */
5584
- const filterSensitiveLog: (obj: ResourceInUseException) => any;
5585
- }
5586
6611
  export interface StartDataSourceSyncJobRequest {
5587
6612
  /**
5588
6613
  * <p>The identifier of the data source to synchronize.</p>
@@ -5775,7 +6800,7 @@ export interface UpdateDataSourceRequest {
5775
6800
  */
5776
6801
  IndexId: string | undefined;
5777
6802
  /**
5778
- * <p>Configuration information for a Amazon Kendra data source.</p>
6803
+ * <p>Configuration information for an Amazon Kendra data source.</p>
5779
6804
  */
5780
6805
  Configuration?: DataSourceConfiguration;
5781
6806
  /**
@@ -5799,6 +6824,15 @@ export interface UpdateDataSourceRequest {
5799
6824
  * documents in languages other than English</a>.</p>
5800
6825
  */
5801
6826
  LanguageCode?: string;
6827
+ /**
6828
+ * <p>Configuration information for altering document metadata and content during the
6829
+ * document ingestion process when you update a data source.</p>
6830
+ * <p>For more information on how to create, modify and delete document metadata, or make
6831
+ * other content alterations when you ingest documents into Amazon Kendra, see
6832
+ * <a href="https://docs.aws.amazon.com/kendra/latest/dg/custom-document-enrichment.html">Customizing
6833
+ * document metadata during the ingestion process</a>.</p>
6834
+ */
6835
+ CustomDocumentEnrichmentConfiguration?: CustomDocumentEnrichmentConfiguration;
5802
6836
  }
5803
6837
  export declare namespace UpdateDataSourceRequest {
5804
6838
  /**
@@ -5806,6 +6840,42 @@ export declare namespace UpdateDataSourceRequest {
5806
6840
  */
5807
6841
  const filterSensitiveLog: (obj: UpdateDataSourceRequest) => any;
5808
6842
  }
6843
+ export interface UpdateExperienceRequest {
6844
+ /**
6845
+ * <p>The identifier of your Amazon Kendra experience you want to update.</p>
6846
+ */
6847
+ Id: string | undefined;
6848
+ /**
6849
+ * <p>The name of your Amazon Kendra experience you want to update.</p>
6850
+ */
6851
+ Name?: string;
6852
+ /**
6853
+ * <p>The identifier of the index for your Amazon Kendra experience you want to update.</p>
6854
+ */
6855
+ IndexId: string | undefined;
6856
+ /**
6857
+ * <p>The Amazon Resource Name (ARN) of a role with permission to access <code>Query</code>
6858
+ * operations, <code>QuerySuggestions</code> operations, <code>SubmitFeedback</code>
6859
+ * operations, and Amazon Web Services SSO that stores your user and group information.
6860
+ * For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html">IAM roles for Amazon Kendra</a>.</p>
6861
+ */
6862
+ RoleArn?: string;
6863
+ /**
6864
+ * <p>Provides the user configuration information. This includes the Amazon Web Services SSO
6865
+ * field name that contains the identifiers of your users, such as their emails.</p>
6866
+ */
6867
+ Configuration?: ExperienceConfiguration;
6868
+ /**
6869
+ * <p>The description of your Amazon Kendra experience you want to update.</p>
6870
+ */
6871
+ Description?: string;
6872
+ }
6873
+ export declare namespace UpdateExperienceRequest {
6874
+ /**
6875
+ * @internal
6876
+ */
6877
+ const filterSensitiveLog: (obj: UpdateExperienceRequest) => any;
6878
+ }
5809
6879
  export interface UpdateIndexRequest {
5810
6880
  /**
5811
6881
  * <p>The identifier of the index to update.</p>
@@ -5846,7 +6916,7 @@ export interface UpdateIndexRequest {
5846
6916
  */
5847
6917
  UserContextPolicy?: UserContextPolicy | string;
5848
6918
  /**
5849
- * <p>Enables fetching access levels of groups and users from an AWS Single Sign-On
6919
+ * <p>Enables fetching access levels of groups and users from an Amazon Web Services Single Sign On
5850
6920
  * identity source. To configure this, see
5851
6921
  * <a href="https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html">UserGroupResolutionConfiguration</a>.</p>
5852
6922
  */
@@ -6009,7 +7079,7 @@ export declare namespace UpdateThesaurusRequest {
6009
7079
  * </li>
6010
7080
  * <li>
6011
7081
  * <p>
6012
- * <code> <EqualTo></code>
7082
+ * <code> <EqualsTo></code>
6013
7083
  * </p>
6014
7084
  * </li>
6015
7085
  * </ol>