@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.
- package/README.md +40 -0
- package/dist-cjs/Kendra.js +75 -0
- package/dist-cjs/commands/BatchDeleteFeaturedResultsSetCommand.js +45 -0
- package/dist-cjs/commands/CreateFeaturedResultsSetCommand.js +45 -0
- package/dist-cjs/commands/DescribeFeaturedResultsSetCommand.js +45 -0
- package/dist-cjs/commands/ListFeaturedResultsSetsCommand.js +45 -0
- package/dist-cjs/commands/UpdateFeaturedResultsSetCommand.js +45 -0
- package/dist-cjs/commands/index.js +5 -0
- package/dist-cjs/endpoint/ruleset.js +3 -3
- package/dist-cjs/models/models_0.js +381 -438
- package/dist-cjs/models/models_1.js +20 -0
- package/dist-cjs/protocols/Aws_json1_1.js +597 -4
- package/dist-es/Kendra.js +75 -0
- package/dist-es/commands/BatchDeleteFeaturedResultsSetCommand.js +41 -0
- package/dist-es/commands/CreateFeaturedResultsSetCommand.js +41 -0
- package/dist-es/commands/DescribeFeaturedResultsSetCommand.js +41 -0
- package/dist-es/commands/ListFeaturedResultsSetsCommand.js +41 -0
- package/dist-es/commands/UpdateFeaturedResultsSetCommand.js +41 -0
- package/dist-es/commands/index.js +5 -0
- package/dist-es/endpoint/ruleset.js +3 -3
- package/dist-es/models/models_0.js +377 -434
- package/dist-es/models/models_1.js +18 -1
- package/dist-es/protocols/Aws_json1_1.js +584 -1
- package/dist-types/Kendra.d.ts +163 -132
- package/dist-types/KendraClient.d.ts +7 -2
- package/dist-types/commands/AssociateEntitiesToExperienceCommand.d.ts +1 -1
- package/dist-types/commands/AssociatePersonasToEntitiesCommand.d.ts +1 -1
- package/dist-types/commands/BatchDeleteDocumentCommand.d.ts +6 -6
- package/dist-types/commands/BatchDeleteFeaturedResultsSetCommand.d.ts +88 -0
- package/dist-types/commands/BatchGetDocumentStatusCommand.d.ts +9 -13
- package/dist-types/commands/BatchPutDocumentCommand.d.ts +14 -13
- package/dist-types/commands/ClearQuerySuggestionsCommand.d.ts +1 -1
- package/dist-types/commands/CreateAccessControlConfigurationCommand.d.ts +17 -20
- package/dist-types/commands/CreateDataSourceCommand.d.ts +3 -4
- package/dist-types/commands/CreateExperienceCommand.d.ts +3 -2
- package/dist-types/commands/CreateFaqCommand.d.ts +6 -6
- package/dist-types/commands/CreateFeaturedResultsSetCommand.d.ts +117 -0
- package/dist-types/commands/CreateIndexCommand.d.ts +3 -2
- package/dist-types/commands/CreateQuerySuggestionsBlockListCommand.d.ts +3 -2
- package/dist-types/commands/CreateThesaurusCommand.d.ts +3 -2
- package/dist-types/commands/DeleteAccessControlConfigurationCommand.d.ts +5 -5
- package/dist-types/commands/DeleteDataSourceCommand.d.ts +1 -1
- package/dist-types/commands/DeleteExperienceCommand.d.ts +1 -1
- package/dist-types/commands/DeleteFaqCommand.d.ts +1 -1
- package/dist-types/commands/DeleteIndexCommand.d.ts +1 -1
- package/dist-types/commands/DeletePrincipalMappingCommand.d.ts +13 -15
- package/dist-types/commands/DeleteQuerySuggestionsBlockListCommand.d.ts +1 -1
- package/dist-types/commands/DeleteThesaurusCommand.d.ts +1 -1
- package/dist-types/commands/DescribeAccessControlConfigurationCommand.d.ts +3 -3
- package/dist-types/commands/DescribeDataSourceCommand.d.ts +1 -1
- package/dist-types/commands/DescribeExperienceCommand.d.ts +1 -1
- package/dist-types/commands/DescribeFaqCommand.d.ts +1 -1
- package/dist-types/commands/DescribeFeaturedResultsSetCommand.d.ts +86 -0
- package/dist-types/commands/DescribeIndexCommand.d.ts +1 -1
- package/dist-types/commands/DescribePrincipalMappingCommand.d.ts +8 -9
- package/dist-types/commands/DescribeQuerySuggestionsBlockListCommand.d.ts +1 -1
- package/dist-types/commands/DescribeQuerySuggestionsConfigCommand.d.ts +1 -1
- package/dist-types/commands/DescribeThesaurusCommand.d.ts +1 -1
- package/dist-types/commands/DisassociateEntitiesFromExperienceCommand.d.ts +1 -1
- package/dist-types/commands/DisassociatePersonasFromEntitiesCommand.d.ts +1 -1
- package/dist-types/commands/GetQuerySuggestionsCommand.d.ts +3 -2
- package/dist-types/commands/GetSnapshotsCommand.d.ts +3 -4
- package/dist-types/commands/ListAccessControlConfigurationsCommand.d.ts +5 -5
- package/dist-types/commands/ListDataSourceSyncJobsCommand.d.ts +1 -1
- package/dist-types/commands/ListDataSourcesCommand.d.ts +1 -1
- package/dist-types/commands/ListEntityPersonasCommand.d.ts +1 -1
- package/dist-types/commands/ListExperienceEntitiesCommand.d.ts +1 -1
- package/dist-types/commands/ListExperiencesCommand.d.ts +1 -1
- package/dist-types/commands/ListFaqsCommand.d.ts +1 -1
- package/dist-types/commands/ListFeaturedResultsSetsCommand.d.ts +87 -0
- package/dist-types/commands/ListGroupsOlderThanOrderingIdCommand.d.ts +4 -5
- package/dist-types/commands/ListIndicesCommand.d.ts +1 -1
- package/dist-types/commands/ListQuerySuggestionsBlockListsCommand.d.ts +1 -1
- package/dist-types/commands/ListTagsForResourceCommand.d.ts +3 -3
- package/dist-types/commands/ListThesauriCommand.d.ts +1 -1
- package/dist-types/commands/PutPrincipalMappingCommand.d.ts +15 -21
- package/dist-types/commands/QueryCommand.d.ts +3 -2
- package/dist-types/commands/StartDataSourceSyncJobCommand.d.ts +2 -2
- package/dist-types/commands/StopDataSourceSyncJobCommand.d.ts +2 -2
- package/dist-types/commands/SubmitFeedbackCommand.d.ts +2 -2
- package/dist-types/commands/TagResourceCommand.d.ts +4 -5
- package/dist-types/commands/UntagResourceCommand.d.ts +2 -2
- package/dist-types/commands/UpdateAccessControlConfigurationCommand.d.ts +20 -20
- package/dist-types/commands/UpdateDataSourceCommand.d.ts +2 -2
- package/dist-types/commands/UpdateExperienceCommand.d.ts +2 -2
- package/dist-types/commands/UpdateFeaturedResultsSetCommand.d.ts +105 -0
- package/dist-types/commands/UpdateIndexCommand.d.ts +4 -3
- package/dist-types/commands/UpdateQuerySuggestionsBlockListCommand.d.ts +2 -2
- package/dist-types/commands/UpdateQuerySuggestionsConfigCommand.d.ts +1 -1
- package/dist-types/commands/UpdateThesaurusCommand.d.ts +1 -1
- package/dist-types/commands/index.d.ts +5 -0
- package/dist-types/endpoint/EndpointParameters.d.ts +1 -1
- package/dist-types/models/models_0.d.ts +1943 -1687
- package/dist-types/models/models_1.d.ts +491 -72
- package/dist-types/protocols/Aws_json1_1.d.ts +15 -0
- package/dist-types/ts3.4/Kendra.d.ts +85 -0
- package/dist-types/ts3.4/KendraClient.d.ts +30 -0
- package/dist-types/ts3.4/commands/BatchDeleteFeaturedResultsSetCommand.d.ts +41 -0
- package/dist-types/ts3.4/commands/CreateFeaturedResultsSetCommand.d.ts +41 -0
- package/dist-types/ts3.4/commands/DescribeFeaturedResultsSetCommand.d.ts +41 -0
- package/dist-types/ts3.4/commands/ListFeaturedResultsSetsCommand.d.ts +41 -0
- package/dist-types/ts3.4/commands/StartDataSourceSyncJobCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/StopDataSourceSyncJobCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/SubmitFeedbackCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/TagResourceCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UntagResourceCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateAccessControlConfigurationCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateDataSourceCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateExperienceCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateFeaturedResultsSetCommand.d.ts +41 -0
- package/dist-types/ts3.4/commands/UpdateIndexCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/UpdateQuerySuggestionsBlockListCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/index.d.ts +5 -0
- package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +1 -1
- package/dist-types/ts3.4/models/models_0.d.ts +563 -453
- package/dist-types/ts3.4/models/models_1.d.ts +127 -0
- package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts +60 -0
- package/package.json +34 -34
|
@@ -1,4 +1,427 @@
|
|
|
1
|
-
import {
|
|
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
|
-
*
|
|
93
|
-
* <p>For example, the document attribute or facet "Department" includes
|
|
94
|
-
*
|
|
95
|
-
*
|
|
96
|
-
* <p>You can display up to 10 facet values per facet for a query. If you want to
|
|
97
|
-
*
|
|
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
|
-
*
|
|
108
|
-
*
|
|
109
|
-
*
|
|
110
|
-
*
|
|
111
|
-
*
|
|
112
|
-
*
|
|
113
|
-
* <
|
|
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
|
-
*
|
|
120
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
142
|
-
*
|
|
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
|
-
*
|
|
145
|
-
*
|
|
146
|
-
*
|
|
147
|
-
*
|
|
148
|
-
*
|
|
149
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
179
|
-
* <p>When you use the <code>AndAllFilters</code> or
|
|
180
|
-
*
|
|
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
|
-
*
|
|
199
|
-
*
|
|
200
|
-
*
|
|
201
|
-
* <
|
|
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
|
-
*
|
|
229
|
-
*
|
|
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
|
-
*
|
|
235
|
-
*
|
|
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
|
-
*
|
|
247
|
-
*
|
|
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
|
-
*
|
|
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
|