aws-sdk-lexmodelsv2 1.10.0 → 1.11.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f52073f2359ea2a3c51fb425c8f9ec53f69569b0601ec305c6d7a2ba0709745d
4
- data.tar.gz: 4840b42b3d61ba5c4c34770fc4887178bd9c99d6738bb9746f1965b5d600eec8
3
+ metadata.gz: 125ac009347a40f55d65a46299a33312afbd25fb6a6b8494dedb6ad2f5f6d9fa
4
+ data.tar.gz: 61e17dc74a1972ca161c24f38c834c298401925ab0311259f7607c3ae6d93744
5
5
  SHA512:
6
- metadata.gz: 798b32b2366131f3359310c990174a9b6ca2e781293c2e19db35565e528d1a4b309cd738f3302bf44952b5d98c31efdda77eb6e3bde5d61aab35d6c94a09868e
7
- data.tar.gz: 2aef9746c802f7863f075b70650a121d0a212035c663854bb1256465be7dc2bd29a1fee9729c5e4c6f989ceb934a32e8e7d24709b5eda0e5bf822acb7cd57a11
6
+ metadata.gz: 11814b7000590a29be3e00e030dfa618102a57758e0496559044c229213cc07f61daa315608b42634ba86976f72c01bc0f86ddece00eec0d7ebbc0e0f304a14f
7
+ data.tar.gz: d7a23ff7be3d3b04daaf4c61748177e34a3bd49bc2c6d770fa39c13e8f3f5b765ae7cb5c8c7095a6a4e9fb639d297acedacce128b3fff1395b5ec9318b6e2d35
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.11.0 (2021-09-22)
5
+ ------------------
6
+
7
+ * Feature - This release adds support for utterances statistics for bots built using Lex V2 console and APIs. For details, see: https://docs.aws.amazon.com/lexv2/latest/dg/monitoring-utterances.html
8
+
4
9
  1.10.0 (2021-09-01)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.10.0
1
+ 1.11.0
@@ -2512,6 +2512,54 @@ module Aws::LexModelsV2
2512
2512
  req.send_request(options)
2513
2513
  end
2514
2514
 
2515
+ # Deletes stored utterances.
2516
+ #
2517
+ # Amazon Lex stores the utterances that users send to your bot.
2518
+ # Utterances are stored for 15 days for use with the operation, and then
2519
+ # stored indefinitely for use in improving the ability of your bot to
2520
+ # respond to user input..
2521
+ #
2522
+ # Use the `DeleteUtterances` operation to manually delete utterances for
2523
+ # a specific session. When you use the `DeleteUtterances` operation,
2524
+ # utterances stored for improving your bot's ability to respond to user
2525
+ # input are deleted immediately. Utterances stored for use with the
2526
+ # `ListAggregatedUtterances` operation are deleted after 15 days.
2527
+ #
2528
+ # @option params [required, String] :bot_id
2529
+ # The unique identifier of the bot that contains the utterances.
2530
+ #
2531
+ # @option params [String] :locale_id
2532
+ # The identifier of the language and locale where the utterances were
2533
+ # collected. The string must match one of the supported locales. For
2534
+ # more information, see [Supported languages][1].
2535
+ #
2536
+ #
2537
+ #
2538
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html
2539
+ #
2540
+ # @option params [String] :session_id
2541
+ # The unique identifier of the session with the user. The ID is returned
2542
+ # in the response from the and operations.
2543
+ #
2544
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2545
+ #
2546
+ # @example Request syntax with placeholder values
2547
+ #
2548
+ # resp = client.delete_utterances({
2549
+ # bot_id: "Id", # required
2550
+ # locale_id: "LocaleId",
2551
+ # session_id: "SessionId",
2552
+ # })
2553
+ #
2554
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteUtterances AWS API Documentation
2555
+ #
2556
+ # @overload delete_utterances(params = {})
2557
+ # @param [Hash] params ({})
2558
+ def delete_utterances(params = {}, options = {})
2559
+ req = build_request(:delete_utterances, params)
2560
+ req.send_request(options)
2561
+ end
2562
+
2515
2563
  # Provides metadata information about a bot.
2516
2564
  #
2517
2565
  # @option params [required, String] :bot_id
@@ -3307,6 +3355,146 @@ module Aws::LexModelsV2
3307
3355
  req.send_request(options)
3308
3356
  end
3309
3357
 
3358
+ # Provides a list of utterances that users have sent to the bot.
3359
+ #
3360
+ # Utterances are aggregated by the text of the utterance. For example,
3361
+ # all instances where customers used the phrase "I want to order
3362
+ # pizza" are aggregated into the same line in the response.
3363
+ #
3364
+ # You can see both detected utterances and missed utterances. A detected
3365
+ # utterance is where the bot properly recognized the utterance and
3366
+ # activated the associated intent. A missed utterance was not recognized
3367
+ # by the bot and didn't activate an intent.
3368
+ #
3369
+ # Utterances can be aggregated for a bot alias or for a bot version, but
3370
+ # not both at the same time.
3371
+ #
3372
+ # Utterances statistics are not generated under the following
3373
+ # conditions:
3374
+ #
3375
+ # * The `childDirected` field was set to true when the bot was created.
3376
+ #
3377
+ # * You are using slot obfuscation with one or more slots.
3378
+ #
3379
+ # * You opted out of participating in improving Amazon Lex.
3380
+ #
3381
+ # @option params [required, String] :bot_id
3382
+ # The unique identifier of the bot associated with this request.
3383
+ #
3384
+ # @option params [String] :bot_alias_id
3385
+ # The identifier of the bot alias associated with this request. If you
3386
+ # specify the bot alias, you can't specify the bot version.
3387
+ #
3388
+ # @option params [String] :bot_version
3389
+ # The identifier of the bot version associated with this request. If you
3390
+ # specify the bot version, you can't specify the bot alias.
3391
+ #
3392
+ # @option params [required, String] :locale_id
3393
+ # The identifier of the language and locale where the utterances were
3394
+ # collected. For more information, see [Supported languages][1].
3395
+ #
3396
+ #
3397
+ #
3398
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html
3399
+ #
3400
+ # @option params [required, Types::UtteranceAggregationDuration] :aggregation_duration
3401
+ # The time window for aggregating the utterance information. You can
3402
+ # specify a time between one hour and two weeks.
3403
+ #
3404
+ # @option params [Types::AggregatedUtterancesSortBy] :sort_by
3405
+ # Specifies sorting parameters for the list of utterances. You can sort
3406
+ # by the hit count, the missed count, or the number of distinct sessions
3407
+ # the utterance appeared in.
3408
+ #
3409
+ # @option params [Array<Types::AggregatedUtterancesFilter>] :filters
3410
+ # Provides the specification of a filter used to limit the utterances in
3411
+ # the response to only those that match the filter specification. You
3412
+ # can only specify one filter and one string to filter on.
3413
+ #
3414
+ # @option params [Integer] :max_results
3415
+ # The maximum number of utterances to return in each page of results. If
3416
+ # there are fewer results than the maximum page size, only the actual
3417
+ # number of results are returned. If you don't specify the `maxResults`
3418
+ # parameter, 1,000 results are returned.
3419
+ #
3420
+ # @option params [String] :next_token
3421
+ # If the response from the `ListAggregatedUtterances` operation contains
3422
+ # more results that specified in the `maxResults` parameter, a token is
3423
+ # returned in the response. Use that token in the `nextToken` parameter
3424
+ # to return the next page of results.
3425
+ #
3426
+ # @return [Types::ListAggregatedUtterancesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3427
+ #
3428
+ # * {Types::ListAggregatedUtterancesResponse#bot_id #bot_id} => String
3429
+ # * {Types::ListAggregatedUtterancesResponse#bot_alias_id #bot_alias_id} => String
3430
+ # * {Types::ListAggregatedUtterancesResponse#bot_version #bot_version} => String
3431
+ # * {Types::ListAggregatedUtterancesResponse#locale_id #locale_id} => String
3432
+ # * {Types::ListAggregatedUtterancesResponse#aggregation_duration #aggregation_duration} => Types::UtteranceAggregationDuration
3433
+ # * {Types::ListAggregatedUtterancesResponse#aggregation_window_start_time #aggregation_window_start_time} => Time
3434
+ # * {Types::ListAggregatedUtterancesResponse#aggregation_window_end_time #aggregation_window_end_time} => Time
3435
+ # * {Types::ListAggregatedUtterancesResponse#aggregation_last_refreshed_date_time #aggregation_last_refreshed_date_time} => Time
3436
+ # * {Types::ListAggregatedUtterancesResponse#aggregated_utterances_summaries #aggregated_utterances_summaries} => Array&lt;Types::AggregatedUtterancesSummary&gt;
3437
+ # * {Types::ListAggregatedUtterancesResponse#next_token #next_token} => String
3438
+ #
3439
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3440
+ #
3441
+ # @example Request syntax with placeholder values
3442
+ #
3443
+ # resp = client.list_aggregated_utterances({
3444
+ # bot_id: "Id", # required
3445
+ # bot_alias_id: "BotAliasId",
3446
+ # bot_version: "BotVersion",
3447
+ # locale_id: "LocaleId", # required
3448
+ # aggregation_duration: { # required
3449
+ # relative_aggregation_duration: { # required
3450
+ # time_dimension: "Hours", # required, accepts Hours, Days, Weeks
3451
+ # time_value: 1, # required
3452
+ # },
3453
+ # },
3454
+ # sort_by: {
3455
+ # attribute: "HitCount", # required, accepts HitCount, MissedCount
3456
+ # order: "Ascending", # required, accepts Ascending, Descending
3457
+ # },
3458
+ # filters: [
3459
+ # {
3460
+ # name: "Utterance", # required, accepts Utterance
3461
+ # values: ["FilterValue"], # required
3462
+ # operator: "CO", # required, accepts CO, EQ
3463
+ # },
3464
+ # ],
3465
+ # max_results: 1,
3466
+ # next_token: "NextToken",
3467
+ # })
3468
+ #
3469
+ # @example Response structure
3470
+ #
3471
+ # resp.bot_id #=> String
3472
+ # resp.bot_alias_id #=> String
3473
+ # resp.bot_version #=> String
3474
+ # resp.locale_id #=> String
3475
+ # resp.aggregation_duration.relative_aggregation_duration.time_dimension #=> String, one of "Hours", "Days", "Weeks"
3476
+ # resp.aggregation_duration.relative_aggregation_duration.time_value #=> Integer
3477
+ # resp.aggregation_window_start_time #=> Time
3478
+ # resp.aggregation_window_end_time #=> Time
3479
+ # resp.aggregation_last_refreshed_date_time #=> Time
3480
+ # resp.aggregated_utterances_summaries #=> Array
3481
+ # resp.aggregated_utterances_summaries[0].utterance #=> String
3482
+ # resp.aggregated_utterances_summaries[0].hit_count #=> Integer
3483
+ # resp.aggregated_utterances_summaries[0].missed_count #=> Integer
3484
+ # resp.aggregated_utterances_summaries[0].utterance_first_recorded_in_aggregation_duration #=> Time
3485
+ # resp.aggregated_utterances_summaries[0].utterance_last_recorded_in_aggregation_duration #=> Time
3486
+ # resp.aggregated_utterances_summaries[0].contains_data_from_deleted_resources #=> Boolean
3487
+ # resp.next_token #=> String
3488
+ #
3489
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListAggregatedUtterances AWS API Documentation
3490
+ #
3491
+ # @overload list_aggregated_utterances(params = {})
3492
+ # @param [Hash] params ({})
3493
+ def list_aggregated_utterances(params = {}, options = {})
3494
+ req = build_request(:list_aggregated_utterances, params)
3495
+ req.send_request(options)
3496
+ end
3497
+
3310
3498
  # Gets a list of aliases for the specified bot.
3311
3499
  #
3312
3500
  # @option params [required, String] :bot_id
@@ -5713,7 +5901,7 @@ module Aws::LexModelsV2
5713
5901
  params: params,
5714
5902
  config: config)
5715
5903
  context[:gem_name] = 'aws-sdk-lexmodelsv2'
5716
- context[:gem_version] = '1.10.0'
5904
+ context[:gem_version] = '1.11.0'
5717
5905
  Seahorse::Client::Request.new(handlers, context)
5718
5906
  end
5719
5907
 
@@ -13,6 +13,14 @@ module Aws::LexModelsV2
13
13
 
14
14
  include Seahorse::Model
15
15
 
16
+ AggregatedUtterancesFilter = Shapes::StructureShape.new(name: 'AggregatedUtterancesFilter')
17
+ AggregatedUtterancesFilterName = Shapes::StringShape.new(name: 'AggregatedUtterancesFilterName')
18
+ AggregatedUtterancesFilterOperator = Shapes::StringShape.new(name: 'AggregatedUtterancesFilterOperator')
19
+ AggregatedUtterancesFilters = Shapes::ListShape.new(name: 'AggregatedUtterancesFilters')
20
+ AggregatedUtterancesSortAttribute = Shapes::StringShape.new(name: 'AggregatedUtterancesSortAttribute')
21
+ AggregatedUtterancesSortBy = Shapes::StructureShape.new(name: 'AggregatedUtterancesSortBy')
22
+ AggregatedUtterancesSummary = Shapes::StructureShape.new(name: 'AggregatedUtterancesSummary')
23
+ AggregatedUtterancesSummaryList = Shapes::ListShape.new(name: 'AggregatedUtterancesSummaryList')
16
24
  AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
17
25
  AttachmentTitle = Shapes::StringShape.new(name: 'AttachmentTitle')
18
26
  AttachmentUrl = Shapes::StringShape.new(name: 'AttachmentUrl')
@@ -136,6 +144,8 @@ module Aws::LexModelsV2
136
144
  DeleteResourcePolicyStatementResponse = Shapes::StructureShape.new(name: 'DeleteResourcePolicyStatementResponse')
137
145
  DeleteSlotRequest = Shapes::StructureShape.new(name: 'DeleteSlotRequest')
138
146
  DeleteSlotTypeRequest = Shapes::StructureShape.new(name: 'DeleteSlotTypeRequest')
147
+ DeleteUtterancesRequest = Shapes::StructureShape.new(name: 'DeleteUtterancesRequest')
148
+ DeleteUtterancesResponse = Shapes::StructureShape.new(name: 'DeleteUtterancesResponse')
139
149
  DescribeBotAliasRequest = Shapes::StructureShape.new(name: 'DescribeBotAliasRequest')
140
150
  DescribeBotAliasResponse = Shapes::StructureShape.new(name: 'DescribeBotAliasResponse')
141
151
  DescribeBotLocaleRequest = Shapes::StructureShape.new(name: 'DescribeBotLocaleRequest')
@@ -176,6 +186,7 @@ module Aws::LexModelsV2
176
186
  FilterValue = Shapes::StringShape.new(name: 'FilterValue')
177
187
  FilterValues = Shapes::ListShape.new(name: 'FilterValues')
178
188
  FulfillmentCodeHookSettings = Shapes::StructureShape.new(name: 'FulfillmentCodeHookSettings')
189
+ HitCount = Shapes::IntegerShape.new(name: 'HitCount')
179
190
  Id = Shapes::StringShape.new(name: 'Id')
180
191
  ImageResponseCard = Shapes::StructureShape.new(name: 'ImageResponseCard')
181
192
  ImportExportFileFormat = Shapes::StringShape.new(name: 'ImportExportFileFormat')
@@ -210,6 +221,8 @@ module Aws::LexModelsV2
210
221
  KmsKeyArn = Shapes::StringShape.new(name: 'KmsKeyArn')
211
222
  LambdaARN = Shapes::StringShape.new(name: 'LambdaARN')
212
223
  LambdaCodeHook = Shapes::StructureShape.new(name: 'LambdaCodeHook')
224
+ ListAggregatedUtterancesRequest = Shapes::StructureShape.new(name: 'ListAggregatedUtterancesRequest')
225
+ ListAggregatedUtterancesResponse = Shapes::StructureShape.new(name: 'ListAggregatedUtterancesResponse')
213
226
  ListBotAliasesRequest = Shapes::StructureShape.new(name: 'ListBotAliasesRequest')
214
227
  ListBotAliasesResponse = Shapes::StructureShape.new(name: 'ListBotAliasesResponse')
215
228
  ListBotLocalesRequest = Shapes::StructureShape.new(name: 'ListBotLocalesRequest')
@@ -243,6 +256,7 @@ module Aws::LexModelsV2
243
256
  MessageGroup = Shapes::StructureShape.new(name: 'MessageGroup')
244
257
  MessageGroupsList = Shapes::ListShape.new(name: 'MessageGroupsList')
245
258
  MessageVariationsList = Shapes::ListShape.new(name: 'MessageVariationsList')
259
+ MissedCount = Shapes::IntegerShape.new(name: 'MissedCount')
246
260
  MultipleValuesSetting = Shapes::StructureShape.new(name: 'MultipleValuesSetting')
247
261
  Name = Shapes::StringShape.new(name: 'Name')
248
262
  NextToken = Shapes::StringShape.new(name: 'NextToken')
@@ -266,6 +280,7 @@ module Aws::LexModelsV2
266
280
  PromptSpecification = Shapes::StructureShape.new(name: 'PromptSpecification')
267
281
  QueryFilterString = Shapes::StringShape.new(name: 'QueryFilterString')
268
282
  RegexPattern = Shapes::StringShape.new(name: 'RegexPattern')
283
+ RelativeAggregationDuration = Shapes::StructureShape.new(name: 'RelativeAggregationDuration')
269
284
  ResourceCount = Shapes::IntegerShape.new(name: 'ResourceCount')
270
285
  ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
271
286
  ResponseSpecification = Shapes::StructureShape.new(name: 'ResponseSpecification')
@@ -282,6 +297,7 @@ module Aws::LexModelsV2
282
297
  SentimentAnalysisSettings = Shapes::StructureShape.new(name: 'SentimentAnalysisSettings')
283
298
  ServicePrincipal = Shapes::StringShape.new(name: 'ServicePrincipal')
284
299
  ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
300
+ SessionId = Shapes::StringShape.new(name: 'SessionId')
285
301
  SessionTTL = Shapes::IntegerShape.new(name: 'SessionTTL')
286
302
  SkipResourceInUseCheck = Shapes::BooleanShape.new(name: 'SkipResourceInUseCheck')
287
303
  SlotConstraint = Shapes::StringShape.new(name: 'SlotConstraint')
@@ -331,6 +347,8 @@ module Aws::LexModelsV2
331
347
  TextLogSetting = Shapes::StructureShape.new(name: 'TextLogSetting')
332
348
  TextLogSettingsList = Shapes::ListShape.new(name: 'TextLogSettingsList')
333
349
  ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
350
+ TimeDimension = Shapes::StringShape.new(name: 'TimeDimension')
351
+ TimeValue = Shapes::IntegerShape.new(name: 'TimeValue')
334
352
  Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
335
353
  UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
336
354
  UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
@@ -351,12 +369,34 @@ module Aws::LexModelsV2
351
369
  UpdateSlotTypeRequest = Shapes::StructureShape.new(name: 'UpdateSlotTypeRequest')
352
370
  UpdateSlotTypeResponse = Shapes::StructureShape.new(name: 'UpdateSlotTypeResponse')
353
371
  Utterance = Shapes::StringShape.new(name: 'Utterance')
372
+ UtteranceAggregationDuration = Shapes::StructureShape.new(name: 'UtteranceAggregationDuration')
354
373
  ValidationException = Shapes::StructureShape.new(name: 'ValidationException')
355
374
  Value = Shapes::StringShape.new(name: 'Value')
356
375
  VoiceId = Shapes::StringShape.new(name: 'VoiceId')
357
376
  VoiceSettings = Shapes::StructureShape.new(name: 'VoiceSettings')
358
377
  WaitAndContinueSpecification = Shapes::StructureShape.new(name: 'WaitAndContinueSpecification')
359
378
 
379
+ AggregatedUtterancesFilter.add_member(:name, Shapes::ShapeRef.new(shape: AggregatedUtterancesFilterName, required: true, location_name: "name"))
380
+ AggregatedUtterancesFilter.add_member(:values, Shapes::ShapeRef.new(shape: FilterValues, required: true, location_name: "values"))
381
+ AggregatedUtterancesFilter.add_member(:operator, Shapes::ShapeRef.new(shape: AggregatedUtterancesFilterOperator, required: true, location_name: "operator"))
382
+ AggregatedUtterancesFilter.struct_class = Types::AggregatedUtterancesFilter
383
+
384
+ AggregatedUtterancesFilters.member = Shapes::ShapeRef.new(shape: AggregatedUtterancesFilter)
385
+
386
+ AggregatedUtterancesSortBy.add_member(:attribute, Shapes::ShapeRef.new(shape: AggregatedUtterancesSortAttribute, required: true, location_name: "attribute"))
387
+ AggregatedUtterancesSortBy.add_member(:order, Shapes::ShapeRef.new(shape: SortOrder, required: true, location_name: "order"))
388
+ AggregatedUtterancesSortBy.struct_class = Types::AggregatedUtterancesSortBy
389
+
390
+ AggregatedUtterancesSummary.add_member(:utterance, Shapes::ShapeRef.new(shape: Utterance, location_name: "utterance"))
391
+ AggregatedUtterancesSummary.add_member(:hit_count, Shapes::ShapeRef.new(shape: HitCount, location_name: "hitCount"))
392
+ AggregatedUtterancesSummary.add_member(:missed_count, Shapes::ShapeRef.new(shape: MissedCount, location_name: "missedCount"))
393
+ AggregatedUtterancesSummary.add_member(:utterance_first_recorded_in_aggregation_duration, Shapes::ShapeRef.new(shape: Timestamp, location_name: "utteranceFirstRecordedInAggregationDuration"))
394
+ AggregatedUtterancesSummary.add_member(:utterance_last_recorded_in_aggregation_duration, Shapes::ShapeRef.new(shape: Timestamp, location_name: "utteranceLastRecordedInAggregationDuration"))
395
+ AggregatedUtterancesSummary.add_member(:contains_data_from_deleted_resources, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "containsDataFromDeletedResources"))
396
+ AggregatedUtterancesSummary.struct_class = Types::AggregatedUtterancesSummary
397
+
398
+ AggregatedUtterancesSummaryList.member = Shapes::ShapeRef.new(shape: AggregatedUtterancesSummary)
399
+
360
400
  AudioLogDestination.add_member(:s3_bucket, Shapes::ShapeRef.new(shape: S3BucketLogDestination, required: true, location_name: "s3Bucket"))
361
401
  AudioLogDestination.struct_class = Types::AudioLogDestination
362
402
 
@@ -833,6 +873,13 @@ module Aws::LexModelsV2
833
873
  DeleteSlotTypeRequest.add_member(:skip_resource_in_use_check, Shapes::ShapeRef.new(shape: SkipResourceInUseCheck, location: "querystring", location_name: "skipResourceInUseCheck"))
834
874
  DeleteSlotTypeRequest.struct_class = Types::DeleteSlotTypeRequest
835
875
 
876
+ DeleteUtterancesRequest.add_member(:bot_id, Shapes::ShapeRef.new(shape: Id, required: true, location: "uri", location_name: "botId"))
877
+ DeleteUtterancesRequest.add_member(:locale_id, Shapes::ShapeRef.new(shape: LocaleId, location: "querystring", location_name: "localeId"))
878
+ DeleteUtterancesRequest.add_member(:session_id, Shapes::ShapeRef.new(shape: SessionId, location: "querystring", location_name: "sessionId"))
879
+ DeleteUtterancesRequest.struct_class = Types::DeleteUtterancesRequest
880
+
881
+ DeleteUtterancesResponse.struct_class = Types::DeleteUtterancesResponse
882
+
836
883
  DescribeBotAliasRequest.add_member(:bot_alias_id, Shapes::ShapeRef.new(shape: BotAliasId, required: true, location: "uri", location_name: "botAliasId"))
837
884
  DescribeBotAliasRequest.add_member(:bot_id, Shapes::ShapeRef.new(shape: Id, required: true, location: "uri", location_name: "botId"))
838
885
  DescribeBotAliasRequest.struct_class = Types::DescribeBotAliasRequest
@@ -1120,6 +1167,29 @@ module Aws::LexModelsV2
1120
1167
  LambdaCodeHook.add_member(:code_hook_interface_version, Shapes::ShapeRef.new(shape: CodeHookInterfaceVersion, required: true, location_name: "codeHookInterfaceVersion"))
1121
1168
  LambdaCodeHook.struct_class = Types::LambdaCodeHook
1122
1169
 
1170
+ ListAggregatedUtterancesRequest.add_member(:bot_id, Shapes::ShapeRef.new(shape: Id, required: true, location: "uri", location_name: "botId"))
1171
+ ListAggregatedUtterancesRequest.add_member(:bot_alias_id, Shapes::ShapeRef.new(shape: BotAliasId, location_name: "botAliasId"))
1172
+ ListAggregatedUtterancesRequest.add_member(:bot_version, Shapes::ShapeRef.new(shape: BotVersion, location_name: "botVersion"))
1173
+ ListAggregatedUtterancesRequest.add_member(:locale_id, Shapes::ShapeRef.new(shape: LocaleId, required: true, location_name: "localeId"))
1174
+ ListAggregatedUtterancesRequest.add_member(:aggregation_duration, Shapes::ShapeRef.new(shape: UtteranceAggregationDuration, required: true, location_name: "aggregationDuration"))
1175
+ ListAggregatedUtterancesRequest.add_member(:sort_by, Shapes::ShapeRef.new(shape: AggregatedUtterancesSortBy, location_name: "sortBy"))
1176
+ ListAggregatedUtterancesRequest.add_member(:filters, Shapes::ShapeRef.new(shape: AggregatedUtterancesFilters, location_name: "filters"))
1177
+ ListAggregatedUtterancesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "maxResults"))
1178
+ ListAggregatedUtterancesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
1179
+ ListAggregatedUtterancesRequest.struct_class = Types::ListAggregatedUtterancesRequest
1180
+
1181
+ ListAggregatedUtterancesResponse.add_member(:bot_id, Shapes::ShapeRef.new(shape: Id, location_name: "botId"))
1182
+ ListAggregatedUtterancesResponse.add_member(:bot_alias_id, Shapes::ShapeRef.new(shape: BotAliasId, location_name: "botAliasId"))
1183
+ ListAggregatedUtterancesResponse.add_member(:bot_version, Shapes::ShapeRef.new(shape: BotVersion, location_name: "botVersion"))
1184
+ ListAggregatedUtterancesResponse.add_member(:locale_id, Shapes::ShapeRef.new(shape: LocaleId, location_name: "localeId"))
1185
+ ListAggregatedUtterancesResponse.add_member(:aggregation_duration, Shapes::ShapeRef.new(shape: UtteranceAggregationDuration, location_name: "aggregationDuration"))
1186
+ ListAggregatedUtterancesResponse.add_member(:aggregation_window_start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "aggregationWindowStartTime"))
1187
+ ListAggregatedUtterancesResponse.add_member(:aggregation_window_end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "aggregationWindowEndTime"))
1188
+ ListAggregatedUtterancesResponse.add_member(:aggregation_last_refreshed_date_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "aggregationLastRefreshedDateTime"))
1189
+ ListAggregatedUtterancesResponse.add_member(:aggregated_utterances_summaries, Shapes::ShapeRef.new(shape: AggregatedUtterancesSummaryList, location_name: "aggregatedUtterancesSummaries"))
1190
+ ListAggregatedUtterancesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
1191
+ ListAggregatedUtterancesResponse.struct_class = Types::ListAggregatedUtterancesResponse
1192
+
1123
1193
  ListBotAliasesRequest.add_member(:bot_id, Shapes::ShapeRef.new(shape: Id, required: true, location: "uri", location_name: "botId"))
1124
1194
  ListBotAliasesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "maxResults"))
1125
1195
  ListBotAliasesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
@@ -1317,6 +1387,10 @@ module Aws::LexModelsV2
1317
1387
  PromptSpecification.add_member(:allow_interrupt, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "allowInterrupt"))
1318
1388
  PromptSpecification.struct_class = Types::PromptSpecification
1319
1389
 
1390
+ RelativeAggregationDuration.add_member(:time_dimension, Shapes::ShapeRef.new(shape: TimeDimension, required: true, location_name: "timeDimension"))
1391
+ RelativeAggregationDuration.add_member(:time_value, Shapes::ShapeRef.new(shape: TimeValue, required: true, location_name: "timeValue"))
1392
+ RelativeAggregationDuration.struct_class = Types::RelativeAggregationDuration
1393
+
1320
1394
  ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionMessage, location_name: "message"))
1321
1395
  ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
1322
1396
 
@@ -1647,6 +1721,9 @@ module Aws::LexModelsV2
1647
1721
  UpdateSlotTypeResponse.add_member(:last_updated_date_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastUpdatedDateTime"))
1648
1722
  UpdateSlotTypeResponse.struct_class = Types::UpdateSlotTypeResponse
1649
1723
 
1724
+ UtteranceAggregationDuration.add_member(:relative_aggregation_duration, Shapes::ShapeRef.new(shape: RelativeAggregationDuration, required: true, location_name: "relativeAggregationDuration"))
1725
+ UtteranceAggregationDuration.struct_class = Types::UtteranceAggregationDuration
1726
+
1650
1727
  ValidationException.add_member(:message, Shapes::ShapeRef.new(shape: ExceptionMessage, location_name: "message"))
1651
1728
  ValidationException.struct_class = Types::ValidationException
1652
1729
 
@@ -1994,6 +2071,17 @@ module Aws::LexModelsV2
1994
2071
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1995
2072
  end)
1996
2073
 
2074
+ api.add_operation(:delete_utterances, Seahorse::Model::Operation.new.tap do |o|
2075
+ o.name = "DeleteUtterances"
2076
+ o.http_method = "DELETE"
2077
+ o.http_request_uri = "/bots/{botId}/utterances/"
2078
+ o.input = Shapes::ShapeRef.new(shape: DeleteUtterancesRequest)
2079
+ o.output = Shapes::ShapeRef.new(shape: DeleteUtterancesResponse)
2080
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
2081
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
2082
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
2083
+ end)
2084
+
1997
2085
  api.add_operation(:describe_bot, Seahorse::Model::Operation.new.tap do |o|
1998
2086
  o.name = "DescribeBot"
1999
2087
  o.http_method = "GET"
@@ -2120,6 +2208,24 @@ module Aws::LexModelsV2
2120
2208
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
2121
2209
  end)
2122
2210
 
2211
+ api.add_operation(:list_aggregated_utterances, Seahorse::Model::Operation.new.tap do |o|
2212
+ o.name = "ListAggregatedUtterances"
2213
+ o.http_method = "POST"
2214
+ o.http_request_uri = "/bots/{botId}/aggregatedutterances/"
2215
+ o.input = Shapes::ShapeRef.new(shape: ListAggregatedUtterancesRequest)
2216
+ o.output = Shapes::ShapeRef.new(shape: ListAggregatedUtterancesResponse)
2217
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
2218
+ o.errors << Shapes::ShapeRef.new(shape: PreconditionFailedException)
2219
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
2220
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
2221
+ o[:pager] = Aws::Pager.new(
2222
+ limit_key: "max_results",
2223
+ tokens: {
2224
+ "next_token" => "next_token"
2225
+ }
2226
+ )
2227
+ end)
2228
+
2123
2229
  api.add_operation(:list_bot_aliases, Seahorse::Model::Operation.new.tap do |o|
2124
2230
  o.name = "ListBotAliases"
2125
2231
  o.http_method = "POST"
@@ -10,6 +10,125 @@
10
10
  module Aws::LexModelsV2
11
11
  module Types
12
12
 
13
+ # Filters responses returned by the `ListAggregatedUtterances`
14
+ # operation.
15
+ #
16
+ # @note When making an API call, you may pass AggregatedUtterancesFilter
17
+ # data as a hash:
18
+ #
19
+ # {
20
+ # name: "Utterance", # required, accepts Utterance
21
+ # values: ["FilterValue"], # required
22
+ # operator: "CO", # required, accepts CO, EQ
23
+ # }
24
+ #
25
+ # @!attribute [rw] name
26
+ # The name of the field to filter the utterance list.
27
+ # @return [String]
28
+ #
29
+ # @!attribute [rw] values
30
+ # The value to use for filtering the list of bots.
31
+ # @return [Array<String>]
32
+ #
33
+ # @!attribute [rw] operator
34
+ # The operator to use for the filter. Specify `EQ` when the
35
+ # `ListAggregatedUtterances` operation should return only utterances
36
+ # that equal the specified value. Specify `CO` when the
37
+ # `ListAggregatedUtterances` operation should return utterances that
38
+ # contain the specified value.
39
+ # @return [String]
40
+ #
41
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/AggregatedUtterancesFilter AWS API Documentation
42
+ #
43
+ class AggregatedUtterancesFilter < Struct.new(
44
+ :name,
45
+ :values,
46
+ :operator)
47
+ SENSITIVE = []
48
+ include Aws::Structure
49
+ end
50
+
51
+ # Specifies attributes for sorting a list of utterances.
52
+ #
53
+ # @note When making an API call, you may pass AggregatedUtterancesSortBy
54
+ # data as a hash:
55
+ #
56
+ # {
57
+ # attribute: "HitCount", # required, accepts HitCount, MissedCount
58
+ # order: "Ascending", # required, accepts Ascending, Descending
59
+ # }
60
+ #
61
+ # @!attribute [rw] attribute
62
+ # The utterance attribute to sort by.
63
+ # @return [String]
64
+ #
65
+ # @!attribute [rw] order
66
+ # Specifies whether to sort the aggregated utterances in ascending or
67
+ # descending order.
68
+ # @return [String]
69
+ #
70
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/AggregatedUtterancesSortBy AWS API Documentation
71
+ #
72
+ class AggregatedUtterancesSortBy < Struct.new(
73
+ :attribute,
74
+ :order)
75
+ SENSITIVE = []
76
+ include Aws::Structure
77
+ end
78
+
79
+ # Provides summary information for aggregated utterances. The
80
+ # `ListAggregatedUtterances` operations combines all instances of the
81
+ # same utterance into a single aggregated summary.
82
+ #
83
+ # @!attribute [rw] utterance
84
+ # The text of the utterance. If the utterance was used with the
85
+ # `RecognizeUtterance` operation, the text is the transcription of the
86
+ # audio utterance.
87
+ # @return [String]
88
+ #
89
+ # @!attribute [rw] hit_count
90
+ # The number of times that the utterance was detected by Amazon Lex
91
+ # during the time period. When an utterance is detected, it activates
92
+ # an intent or a slot.
93
+ # @return [Integer]
94
+ #
95
+ # @!attribute [rw] missed_count
96
+ # The number of times that the utterance was missed by Amazon Lex An
97
+ # utterance is missed when it doesn't activate an intent or slot.
98
+ # @return [Integer]
99
+ #
100
+ # @!attribute [rw] utterance_first_recorded_in_aggregation_duration
101
+ # The date and time that the utterance was first recorded in the time
102
+ # window for aggregation. An utterance may have been sent to Amazon
103
+ # Lex before that time, but only utterances within the time window are
104
+ # counted.
105
+ # @return [Time]
106
+ #
107
+ # @!attribute [rw] utterance_last_recorded_in_aggregation_duration
108
+ # The last date and time that an utterance was recorded in the time
109
+ # window for aggregation. An utterance may be sent to Amazon Lex after
110
+ # that time, but only utterances within the time window are counted.
111
+ # @return [Time]
112
+ #
113
+ # @!attribute [rw] contains_data_from_deleted_resources
114
+ # Aggregated utterance data may contain utterances from versions of
115
+ # your bot that have since been deleted. When the aggregated contains
116
+ # this kind of data, this field is set to true.
117
+ # @return [Boolean]
118
+ #
119
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/AggregatedUtterancesSummary AWS API Documentation
120
+ #
121
+ class AggregatedUtterancesSummary < Struct.new(
122
+ :utterance,
123
+ :hit_count,
124
+ :missed_count,
125
+ :utterance_first_recorded_in_aggregation_duration,
126
+ :utterance_last_recorded_in_aggregation_duration,
127
+ :contains_data_from_deleted_resources)
128
+ SENSITIVE = []
129
+ include Aws::Structure
130
+ end
131
+
13
132
  # The location of audio log files collected when conversation logging is
14
133
  # enabled for a bot.
15
134
  #
@@ -968,6 +1087,10 @@ module Aws::LexModelsV2
968
1087
  include Aws::Structure
969
1088
  end
970
1089
 
1090
+ # The action that you tried to perform couldn't be completed because
1091
+ # the resource is in a conflicting state. For example, deleting a bot
1092
+ # that is in the CREATING state. Try your request again.
1093
+ #
971
1094
  # @!attribute [rw] message
972
1095
  # @return [String]
973
1096
  #
@@ -3480,6 +3603,48 @@ module Aws::LexModelsV2
3480
3603
  include Aws::Structure
3481
3604
  end
3482
3605
 
3606
+ # @note When making an API call, you may pass DeleteUtterancesRequest
3607
+ # data as a hash:
3608
+ #
3609
+ # {
3610
+ # bot_id: "Id", # required
3611
+ # locale_id: "LocaleId",
3612
+ # session_id: "SessionId",
3613
+ # }
3614
+ #
3615
+ # @!attribute [rw] bot_id
3616
+ # The unique identifier of the bot that contains the utterances.
3617
+ # @return [String]
3618
+ #
3619
+ # @!attribute [rw] locale_id
3620
+ # The identifier of the language and locale where the utterances were
3621
+ # collected. The string must match one of the supported locales. For
3622
+ # more information, see [Supported languages][1].
3623
+ #
3624
+ #
3625
+ #
3626
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html
3627
+ # @return [String]
3628
+ #
3629
+ # @!attribute [rw] session_id
3630
+ # The unique identifier of the session with the user. The ID is
3631
+ # returned in the response from the and operations.
3632
+ # @return [String]
3633
+ #
3634
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteUtterancesRequest AWS API Documentation
3635
+ #
3636
+ class DeleteUtterancesRequest < Struct.new(
3637
+ :bot_id,
3638
+ :locale_id,
3639
+ :session_id)
3640
+ SENSITIVE = []
3641
+ include Aws::Structure
3642
+ end
3643
+
3644
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteUtterancesResponse AWS API Documentation
3645
+ #
3646
+ class DeleteUtterancesResponse < Aws::EmptyStructure; end
3647
+
3483
3648
  # @note When making an API call, you may pass DescribeBotAliasRequest
3484
3649
  # data as a hash:
3485
3650
  #
@@ -5216,6 +5381,9 @@ module Aws::LexModelsV2
5216
5381
  include Aws::Structure
5217
5382
  end
5218
5383
 
5384
+ # The service encountered an unexpected condition. Try your request
5385
+ # again.
5386
+ #
5219
5387
  # @!attribute [rw] message
5220
5388
  # @return [String]
5221
5389
  #
@@ -5301,6 +5469,184 @@ module Aws::LexModelsV2
5301
5469
  include Aws::Structure
5302
5470
  end
5303
5471
 
5472
+ # @note When making an API call, you may pass ListAggregatedUtterancesRequest
5473
+ # data as a hash:
5474
+ #
5475
+ # {
5476
+ # bot_id: "Id", # required
5477
+ # bot_alias_id: "BotAliasId",
5478
+ # bot_version: "BotVersion",
5479
+ # locale_id: "LocaleId", # required
5480
+ # aggregation_duration: { # required
5481
+ # relative_aggregation_duration: { # required
5482
+ # time_dimension: "Hours", # required, accepts Hours, Days, Weeks
5483
+ # time_value: 1, # required
5484
+ # },
5485
+ # },
5486
+ # sort_by: {
5487
+ # attribute: "HitCount", # required, accepts HitCount, MissedCount
5488
+ # order: "Ascending", # required, accepts Ascending, Descending
5489
+ # },
5490
+ # filters: [
5491
+ # {
5492
+ # name: "Utterance", # required, accepts Utterance
5493
+ # values: ["FilterValue"], # required
5494
+ # operator: "CO", # required, accepts CO, EQ
5495
+ # },
5496
+ # ],
5497
+ # max_results: 1,
5498
+ # next_token: "NextToken",
5499
+ # }
5500
+ #
5501
+ # @!attribute [rw] bot_id
5502
+ # The unique identifier of the bot associated with this request.
5503
+ # @return [String]
5504
+ #
5505
+ # @!attribute [rw] bot_alias_id
5506
+ # The identifier of the bot alias associated with this request. If you
5507
+ # specify the bot alias, you can't specify the bot version.
5508
+ # @return [String]
5509
+ #
5510
+ # @!attribute [rw] bot_version
5511
+ # The identifier of the bot version associated with this request. If
5512
+ # you specify the bot version, you can't specify the bot alias.
5513
+ # @return [String]
5514
+ #
5515
+ # @!attribute [rw] locale_id
5516
+ # The identifier of the language and locale where the utterances were
5517
+ # collected. For more information, see [Supported languages][1].
5518
+ #
5519
+ #
5520
+ #
5521
+ # [1]: https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html
5522
+ # @return [String]
5523
+ #
5524
+ # @!attribute [rw] aggregation_duration
5525
+ # The time window for aggregating the utterance information. You can
5526
+ # specify a time between one hour and two weeks.
5527
+ # @return [Types::UtteranceAggregationDuration]
5528
+ #
5529
+ # @!attribute [rw] sort_by
5530
+ # Specifies sorting parameters for the list of utterances. You can
5531
+ # sort by the hit count, the missed count, or the number of distinct
5532
+ # sessions the utterance appeared in.
5533
+ # @return [Types::AggregatedUtterancesSortBy]
5534
+ #
5535
+ # @!attribute [rw] filters
5536
+ # Provides the specification of a filter used to limit the utterances
5537
+ # in the response to only those that match the filter specification.
5538
+ # You can only specify one filter and one string to filter on.
5539
+ # @return [Array<Types::AggregatedUtterancesFilter>]
5540
+ #
5541
+ # @!attribute [rw] max_results
5542
+ # The maximum number of utterances to return in each page of results.
5543
+ # If there are fewer results than the maximum page size, only the
5544
+ # actual number of results are returned. If you don't specify the
5545
+ # `maxResults` parameter, 1,000 results are returned.
5546
+ # @return [Integer]
5547
+ #
5548
+ # @!attribute [rw] next_token
5549
+ # If the response from the `ListAggregatedUtterances` operation
5550
+ # contains more results that specified in the `maxResults` parameter,
5551
+ # a token is returned in the response. Use that token in the
5552
+ # `nextToken` parameter to return the next page of results.
5553
+ # @return [String]
5554
+ #
5555
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListAggregatedUtterancesRequest AWS API Documentation
5556
+ #
5557
+ class ListAggregatedUtterancesRequest < Struct.new(
5558
+ :bot_id,
5559
+ :bot_alias_id,
5560
+ :bot_version,
5561
+ :locale_id,
5562
+ :aggregation_duration,
5563
+ :sort_by,
5564
+ :filters,
5565
+ :max_results,
5566
+ :next_token)
5567
+ SENSITIVE = []
5568
+ include Aws::Structure
5569
+ end
5570
+
5571
+ # @!attribute [rw] bot_id
5572
+ # The identifier of the bot that contains the utterances.
5573
+ # @return [String]
5574
+ #
5575
+ # @!attribute [rw] bot_alias_id
5576
+ # The identifier of the bot alias that contains the utterances. If you
5577
+ # specified the bot version, the bot alias ID isn't returned.
5578
+ # @return [String]
5579
+ #
5580
+ # @!attribute [rw] bot_version
5581
+ # The identifier of the bot version that contains the utterances. If
5582
+ # you specified the bot alias, the bot version isn't returned.
5583
+ # @return [String]
5584
+ #
5585
+ # @!attribute [rw] locale_id
5586
+ # The identifier of the language and locale that the utterances are
5587
+ # in.
5588
+ # @return [String]
5589
+ #
5590
+ # @!attribute [rw] aggregation_duration
5591
+ # The time period used to aggregate the utterance data.
5592
+ # @return [Types::UtteranceAggregationDuration]
5593
+ #
5594
+ # @!attribute [rw] aggregation_window_start_time
5595
+ # The date and time that the aggregation window begins. Only data
5596
+ # collected after this time is returned in the results.
5597
+ # @return [Time]
5598
+ #
5599
+ # @!attribute [rw] aggregation_window_end_time
5600
+ # The date and time that the aggregation window ends. Only data
5601
+ # collected between the start time and the end time are returned in
5602
+ # the results.
5603
+ # @return [Time]
5604
+ #
5605
+ # @!attribute [rw] aggregation_last_refreshed_date_time
5606
+ # The last date and time that the aggregated data was collected. The
5607
+ # time period depends on the length of the aggregation window.
5608
+ #
5609
+ # * **Hours** - for 1 hour time window, every half hour; otherwise
5610
+ # every hour.
5611
+ #
5612
+ # * **Days** - every 6 hours
5613
+ #
5614
+ # * **Weeks** - for a one week time window, every 12 hours; otherwise,
5615
+ # every day
5616
+ # @return [Time]
5617
+ #
5618
+ # @!attribute [rw] aggregated_utterances_summaries
5619
+ # Summaries of the aggregated utterance data. Each response contains
5620
+ # information about the number of times that the utterance was seen
5621
+ # during the time period, whether it was detected or missed, and when
5622
+ # it was seen during the time period.
5623
+ # @return [Array<Types::AggregatedUtterancesSummary>]
5624
+ #
5625
+ # @!attribute [rw] next_token
5626
+ # A token that indicates whether there are more results to return in a
5627
+ # response to the `ListAggregatedUtterances` operation. If the
5628
+ # `nextToken` field is present, you send the contents as the
5629
+ # `nextToken` parameter of a `ListAggregatedUtterances` operation
5630
+ # request to get the next page of results.
5631
+ # @return [String]
5632
+ #
5633
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListAggregatedUtterancesResponse AWS API Documentation
5634
+ #
5635
+ class ListAggregatedUtterancesResponse < Struct.new(
5636
+ :bot_id,
5637
+ :bot_alias_id,
5638
+ :bot_version,
5639
+ :locale_id,
5640
+ :aggregation_duration,
5641
+ :aggregation_window_start_time,
5642
+ :aggregation_window_end_time,
5643
+ :aggregation_last_refreshed_date_time,
5644
+ :aggregated_utterances_summaries,
5645
+ :next_token)
5646
+ SENSITIVE = []
5647
+ include Aws::Structure
5648
+ end
5649
+
5304
5650
  # @note When making an API call, you may pass ListBotAliasesRequest
5305
5651
  # data as a hash:
5306
5652
  #
@@ -6626,6 +6972,9 @@ module Aws::LexModelsV2
6626
6972
  include Aws::Structure
6627
6973
  end
6628
6974
 
6975
+ # Your request couldn't be completed because one or more request fields
6976
+ # aren't valid. Check the fields in your request and try again.
6977
+ #
6629
6978
  # @!attribute [rw] message
6630
6979
  # @return [String]
6631
6980
  #
@@ -6758,6 +7107,61 @@ module Aws::LexModelsV2
6758
7107
  include Aws::Structure
6759
7108
  end
6760
7109
 
7110
+ # Specifies the time window that utterance statistics are returned for.
7111
+ # The time window is always relative to the last time that the that
7112
+ # utterances were aggregated. For example, if the
7113
+ # `ListAggregatedUtterances` operation is called at 1600, the time
7114
+ # window is set to 1 hour, and the last refresh time was 1530, only
7115
+ # utterances made between 1430 and 1530 are returned.
7116
+ #
7117
+ # You can choose the time window that statistics should be returned for.
7118
+ #
7119
+ # * **Hours** - You can request utterance statistics for 1, 3, 6, 12, or
7120
+ # 24 hour time windows. Statistics are refreshed every half hour for 1
7121
+ # hour time windows, and hourly for the other time windows.
7122
+ #
7123
+ # * **Days** - You can request utterance statistics for 3 days.
7124
+ # Statistics are refreshed every 6 hours.
7125
+ #
7126
+ # * **Weeks** - You can see statistics for one or two weeks. Statistics
7127
+ # are refreshed every 12 hours for one week time windows, and once per
7128
+ # day for two week time windows.
7129
+ #
7130
+ # @note When making an API call, you may pass RelativeAggregationDuration
7131
+ # data as a hash:
7132
+ #
7133
+ # {
7134
+ # time_dimension: "Hours", # required, accepts Hours, Days, Weeks
7135
+ # time_value: 1, # required
7136
+ # }
7137
+ #
7138
+ # @!attribute [rw] time_dimension
7139
+ # The type of time period that the `timeValue` field represents.
7140
+ # @return [String]
7141
+ #
7142
+ # @!attribute [rw] time_value
7143
+ # The period of the time window to gather statistics for. The valid
7144
+ # value depends on the setting of the `timeDimension` field.
7145
+ #
7146
+ # * `Hours` - 1/3/6/12/24
7147
+ #
7148
+ # * `Days` - 3
7149
+ #
7150
+ # * `Weeks` - 1/2
7151
+ # @return [Integer]
7152
+ #
7153
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/RelativeAggregationDuration AWS API Documentation
7154
+ #
7155
+ class RelativeAggregationDuration < Struct.new(
7156
+ :time_dimension,
7157
+ :time_value)
7158
+ SENSITIVE = []
7159
+ include Aws::Structure
7160
+ end
7161
+
7162
+ # You asked to describe a resource that doesn't exist. Check the
7163
+ # resource that you are requesting and try again.
7164
+ #
6761
7165
  # @!attribute [rw] message
6762
7166
  # @return [String]
6763
7167
  #
@@ -6971,6 +7375,8 @@ module Aws::LexModelsV2
6971
7375
  include Aws::Structure
6972
7376
  end
6973
7377
 
7378
+ # You have reached a quota for your bot.
7379
+ #
6974
7380
  # @!attribute [rw] message
6975
7381
  # @return [String]
6976
7382
  #
@@ -7950,6 +8356,8 @@ module Aws::LexModelsV2
7950
8356
  include Aws::Structure
7951
8357
  end
7952
8358
 
8359
+ # Your request rate is too high. Reduce the frequency of requests.
8360
+ #
7953
8361
  # @!attribute [rw] retry_after_seconds
7954
8362
  # @return [Integer]
7955
8363
  #
@@ -9525,6 +9933,34 @@ module Aws::LexModelsV2
9525
9933
  include Aws::Structure
9526
9934
  end
9527
9935
 
9936
+ # Provides parameters for setting the time window and duration for
9937
+ # aggregating utterance data.
9938
+ #
9939
+ # @note When making an API call, you may pass UtteranceAggregationDuration
9940
+ # data as a hash:
9941
+ #
9942
+ # {
9943
+ # relative_aggregation_duration: { # required
9944
+ # time_dimension: "Hours", # required, accepts Hours, Days, Weeks
9945
+ # time_value: 1, # required
9946
+ # },
9947
+ # }
9948
+ #
9949
+ # @!attribute [rw] relative_aggregation_duration
9950
+ # The desired time window for aggregating utterances.
9951
+ # @return [Types::RelativeAggregationDuration]
9952
+ #
9953
+ # @see http://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UtteranceAggregationDuration AWS API Documentation
9954
+ #
9955
+ class UtteranceAggregationDuration < Struct.new(
9956
+ :relative_aggregation_duration)
9957
+ SENSITIVE = []
9958
+ include Aws::Structure
9959
+ end
9960
+
9961
+ # One of the input parameters in your request isn't valid. Check the
9962
+ # parameters and try your request again.
9963
+ #
9528
9964
  # @!attribute [rw] message
9529
9965
  # @return [String]
9530
9966
  #
@@ -49,6 +49,6 @@ require_relative 'aws-sdk-lexmodelsv2/customizations'
49
49
  # @!group service
50
50
  module Aws::LexModelsV2
51
51
 
52
- GEM_VERSION = '1.10.0'
52
+ GEM_VERSION = '1.11.0'
53
53
 
54
54
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-lexmodelsv2
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.10.0
4
+ version: 1.11.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-09-01 00:00:00.000000000 Z
11
+ date: 2021-09-22 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core