aws-sdk-connect 1.213.0 → 1.215.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 659b5f2526f4143dddb35851139a46b04e21e242cb2e8ab08b6f9da11ffb4c19
4
- data.tar.gz: 0d02592d1a68e701f60043ab7714c28b1e7460885c22ac8e8937625570cb97a4
3
+ metadata.gz: db039b5c4733396b29f8e3b90cd69f58e8115c9c1e8611a7ed7ba23ff54e4894
4
+ data.tar.gz: 3ee43e9b990fb48a79aa66319458b1b7c625c94f1c075945234f43ed9105b275
5
5
  SHA512:
6
- metadata.gz: cec601116d6d0607fa120720d9fb9cf6e9c6738149b313eeaac4ce3ca3bddb8fd0e2bcccba7e9b2f8d424604575d4c9437c8eaba08040b4058cd7968a31cec15
7
- data.tar.gz: 3eff71c063c0c133c2245440b76fc3d17a8600f0e85e632c669eedd604f805fe4323fac6ffea3b959b0df05fe762ad551489b630f3ce6a362b32f49405a7ac03
6
+ metadata.gz: 3d6188be50a7192bee85be264fe3bc343f8974bf06187059914a421a2f0dc03facb7b93771d8d62b24f3a6c03979da7cb1fd634bf0dccc346b5357eac5613109
7
+ data.tar.gz: 59cd27658d7ff02fce1ed9adb0cb3c4284eac50696c155a9fc291b7fca1b99c2be9d7dae5207c51b1ac9002c19706c33a3ef2cf5d4dc25985258808e540c654d
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.215.0 (2025-08-28)
5
+ ------------------
6
+
7
+ * Feature - AgentStatusDrillDown feature in GetCurrentMetricData API. Adding AGENT_STATUS as filter and grouping in GetCurrentMetricData API
8
+
9
+ 1.214.0 (2025-08-26)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
4
14
  1.213.0 (2025-08-21)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.213.0
1
+ 1.215.0
@@ -5320,8 +5320,8 @@ module Aws::Connect
5320
5320
  end
5321
5321
 
5322
5322
  # This API is in preview release for Amazon Connect and is subject to
5323
- # change. To request access to this API, contact Amazon Web
5324
- # ServicesSupport.
5323
+ # change. To request access to this API, contact Amazon Web Services
5324
+ # Support.
5325
5325
  #
5326
5326
  # Describes the target authentication profile.
5327
5327
  #
@@ -7847,11 +7847,16 @@ module Aws::Connect
7847
7847
  #
7848
7848
  # * RoutingStepExpressions: 50
7849
7849
  #
7850
+ # * AgentStatuses: 50
7851
+ #
7850
7852
  # Metric data is retrieved only for the resources associated with the
7851
7853
  # queues or routing profiles, and by any channels included in the
7852
7854
  # filter. (You cannot filter by both queue AND routing profile.) You can
7853
7855
  # include both resource IDs and resource ARNs in the same request.
7854
7856
  #
7857
+ # When using `AgentStatuses` as filter make sure Queues is added as
7858
+ # primary filter.
7859
+ #
7855
7860
  # When using the `RoutingStepExpression` filter, you need to pass
7856
7861
  # exactly one `QueueId`. The filter is also case sensitive so when using
7857
7862
  # the `RoutingStepExpression` filter, grouping by
@@ -7861,21 +7866,29 @@ module Aws::Connect
7861
7866
  # in the filter.
7862
7867
  #
7863
7868
  # @option params [Array<String>] :groupings
7864
- # The grouping applied to the metrics returned. For example, when
7865
- # grouped by `QUEUE`, the metrics returned apply to each queue rather
7866
- # than aggregated for all queues.
7869
+ # Defines the level of aggregation for metrics data by a dimension(s).
7870
+ # Its similar to sorting items into buckets based on a common
7871
+ # characteristic, then counting or calculating something for each
7872
+ # bucket. For example, when grouped by `QUEUE`, the metrics returned
7873
+ # apply to each queue rather than aggregated for all queues.
7874
+ #
7875
+ # The grouping list is an ordered list, with the first item in the list
7876
+ # defined as the primary grouping. If no grouping is included in the
7877
+ # request, the aggregation happens at the instance-level.
7867
7878
  #
7868
7879
  # * If you group by `CHANNEL`, you should include a Channels filter.
7869
7880
  # VOICE, CHAT, and TASK channels are supported.
7870
7881
  #
7882
+ # * If you group by `AGENT_STATUS`, you must include the `QUEUE` as the
7883
+ # primary grouping and use queue filter. When you group by
7884
+ # `AGENT_STATUS`, the only metric available is the `AGENTS_ONLINE`
7885
+ # metric.
7886
+ #
7871
7887
  # * If you group by `ROUTING_PROFILE`, you must include either a queue
7872
7888
  # or routing profile filter. In addition, a routing profile filter is
7873
7889
  # required for metrics `CONTACTS_SCHEDULED`, `CONTACTS_IN_QUEUE`, and
7874
7890
  # ` OLDEST_CONTACT_AGE`.
7875
7891
  #
7876
- # * If no `Grouping` is included in the request, a summary of metrics is
7877
- # returned.
7878
- #
7879
7892
  # * When using the `RoutingStepExpression` filter, group by
7880
7893
  # `ROUTING_STEP_EXPRESSION` is required.
7881
7894
  #
@@ -8039,8 +8052,9 @@ module Aws::Connect
8039
8052
  # channels: ["VOICE"], # accepts VOICE, CHAT, TASK, EMAIL
8040
8053
  # routing_profiles: ["RoutingProfileId"],
8041
8054
  # routing_step_expressions: ["RoutingExpression"],
8055
+ # agent_statuses: ["AgentStatusId"],
8042
8056
  # },
8043
- # groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE, ROUTING_STEP_EXPRESSION
8057
+ # groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE, ROUTING_STEP_EXPRESSION, AGENT_STATUS
8044
8058
  # current_metrics: [ # required
8045
8059
  # {
8046
8060
  # name: "AGENTS_ONLINE", # accepts AGENTS_ONLINE, AGENTS_AVAILABLE, AGENTS_ON_CALL, AGENTS_NON_PRODUCTIVE, AGENTS_AFTER_CONTACT_WORK, AGENTS_ERROR, AGENTS_STAFFED, CONTACTS_IN_QUEUE, OLDEST_CONTACT_AGE, CONTACTS_SCHEDULED, AGENTS_ON_CONTACT, SLOTS_ACTIVE, SLOTS_AVAILABLE
@@ -8067,6 +8081,8 @@ module Aws::Connect
8067
8081
  # resp.metric_results[0].dimensions.routing_profile.id #=> String
8068
8082
  # resp.metric_results[0].dimensions.routing_profile.arn #=> String
8069
8083
  # resp.metric_results[0].dimensions.routing_step_expression #=> String
8084
+ # resp.metric_results[0].dimensions.agent_status.arn #=> String
8085
+ # resp.metric_results[0].dimensions.agent_status.id #=> String
8070
8086
  # resp.metric_results[0].collections #=> Array
8071
8087
  # resp.metric_results[0].collections[0].metric.name #=> String, one of "AGENTS_ONLINE", "AGENTS_AVAILABLE", "AGENTS_ON_CALL", "AGENTS_NON_PRODUCTIVE", "AGENTS_AFTER_CONTACT_WORK", "AGENTS_ERROR", "AGENTS_STAFFED", "CONTACTS_IN_QUEUE", "OLDEST_CONTACT_AGE", "CONTACTS_SCHEDULED", "AGENTS_ON_CONTACT", "SLOTS_ACTIVE", "SLOTS_AVAILABLE"
8072
8088
  # resp.metric_results[0].collections[0].metric.unit #=> String, one of "SECONDS", "COUNT", "PERCENT"
@@ -8701,8 +8717,9 @@ module Aws::Connect
8701
8717
  # channels: ["VOICE"], # accepts VOICE, CHAT, TASK, EMAIL
8702
8718
  # routing_profiles: ["RoutingProfileId"],
8703
8719
  # routing_step_expressions: ["RoutingExpression"],
8720
+ # agent_statuses: ["AgentStatusId"],
8704
8721
  # },
8705
- # groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE, ROUTING_STEP_EXPRESSION
8722
+ # groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE, ROUTING_STEP_EXPRESSION, AGENT_STATUS
8706
8723
  # historical_metrics: [ # required
8707
8724
  # {
8708
8725
  # name: "CONTACTS_QUEUED", # accepts CONTACTS_QUEUED, CONTACTS_HANDLED, CONTACTS_ABANDONED, CONTACTS_CONSULTED, CONTACTS_AGENT_HUNG_UP_FIRST, CONTACTS_HANDLED_INCOMING, CONTACTS_HANDLED_OUTBOUND, CONTACTS_HOLD_ABANDONS, CONTACTS_TRANSFERRED_IN, CONTACTS_TRANSFERRED_OUT, CONTACTS_TRANSFERRED_IN_FROM_QUEUE, CONTACTS_TRANSFERRED_OUT_FROM_QUEUE, CONTACTS_MISSED, CALLBACK_CONTACTS_HANDLED, API_CONTACTS_HANDLED, OCCUPANCY, HANDLE_TIME, AFTER_CONTACT_WORK_TIME, QUEUED_TIME, ABANDON_TIME, QUEUE_ANSWER_TIME, HOLD_TIME, INTERACTION_TIME, INTERACTION_AND_HOLD_TIME, SERVICE_LEVEL
@@ -8728,6 +8745,8 @@ module Aws::Connect
8728
8745
  # resp.metric_results[0].dimensions.routing_profile.id #=> String
8729
8746
  # resp.metric_results[0].dimensions.routing_profile.arn #=> String
8730
8747
  # resp.metric_results[0].dimensions.routing_step_expression #=> String
8748
+ # resp.metric_results[0].dimensions.agent_status.arn #=> String
8749
+ # resp.metric_results[0].dimensions.agent_status.id #=> String
8731
8750
  # resp.metric_results[0].collections #=> Array
8732
8751
  # resp.metric_results[0].collections[0].metric.name #=> String, one of "CONTACTS_QUEUED", "CONTACTS_HANDLED", "CONTACTS_ABANDONED", "CONTACTS_CONSULTED", "CONTACTS_AGENT_HUNG_UP_FIRST", "CONTACTS_HANDLED_INCOMING", "CONTACTS_HANDLED_OUTBOUND", "CONTACTS_HOLD_ABANDONS", "CONTACTS_TRANSFERRED_IN", "CONTACTS_TRANSFERRED_OUT", "CONTACTS_TRANSFERRED_IN_FROM_QUEUE", "CONTACTS_TRANSFERRED_OUT_FROM_QUEUE", "CONTACTS_MISSED", "CALLBACK_CONTACTS_HANDLED", "API_CONTACTS_HANDLED", "OCCUPANCY", "HANDLE_TIME", "AFTER_CONTACT_WORK_TIME", "QUEUED_TIME", "ABANDON_TIME", "QUEUE_ANSWER_TIME", "HOLD_TIME", "INTERACTION_TIME", "INTERACTION_AND_HOLD_TIME", "SERVICE_LEVEL"
8733
8752
  # resp.metric_results[0].collections[0].metric.threshold.comparison #=> String, one of "LT"
@@ -10791,7 +10810,7 @@ module Aws::Connect
10791
10810
  # service level quota of 99 phone numbers, and in any 180 day period you
10792
10811
  # release 99, claim 99, and then release 99, you will have exceeded the
10793
10812
  # 200% limit. At that point you are blocked from claiming any more
10794
- # numbers until you open an Amazon Web ServicesSupport ticket.
10813
+ # numbers until you open an Amazon Web Services Support ticket.
10795
10814
  #
10796
10815
  #
10797
10816
  #
@@ -11135,8 +11154,8 @@ module Aws::Connect
11135
11154
  end
11136
11155
 
11137
11156
  # This API is in preview release for Amazon Connect and is subject to
11138
- # change. To request access to this API, contact Amazon Web
11139
- # ServicesSupport.
11157
+ # change. To request access to this API, contact Amazon Web Services
11158
+ # Support.
11140
11159
  #
11141
11160
  # Provides summary information about the authentication profiles in a
11142
11161
  # specified Amazon Connect instance.
@@ -14008,7 +14027,7 @@ module Aws::Connect
14008
14027
  # After releasing a phone number, the phone number enters into a
14009
14028
  # cooldown period for up to 180 days. It cannot be searched for or
14010
14029
  # claimed again until the period has ended. If you accidentally release
14011
- # a phone number, contact Amazon Web ServicesSupport.
14030
+ # a phone number, contact Amazon Web Services Support.
14012
14031
  #
14013
14032
  # If you plan to claim and release numbers frequently, contact us for a
14014
14033
  # service quota exception. Otherwise, it is possible you will be blocked
@@ -16513,8 +16532,8 @@ module Aws::Connect
16513
16532
  #
16514
16533
  # If you use the `ChatDurationInMinutes` parameter and receive a 400
16515
16534
  # error, your account may not support the ability to configure custom
16516
- # chat durations. For more information, contact Amazon Web
16517
- # ServicesSupport.
16535
+ # chat durations. For more information, contact Amazon Web Services
16536
+ # Support.
16518
16537
  #
16519
16538
  # For more information about chat, see the following topics in the
16520
16539
  # *Amazon Connect Administrator Guide*:
@@ -18511,8 +18530,8 @@ module Aws::Connect
18511
18530
  end
18512
18531
 
18513
18532
  # This API is in preview release for Amazon Connect and is subject to
18514
- # change. To request access to this API, contact Amazon Web
18515
- # ServicesSupport.
18533
+ # change. To request access to this API, contact Amazon Web Services
18534
+ # Support.
18516
18535
  #
18517
18536
  # Updates the selected authentication profile.
18518
18537
  #
@@ -19608,7 +19627,7 @@ module Aws::Connect
19608
19627
  # The type of attribute.
19609
19628
  #
19610
19629
  # <note markdown="1"> Only allowlisted customers can consume USE\_CUSTOM\_TTS\_VOICES. To
19611
- # access this feature, contact Amazon Web ServicesSupport for
19630
+ # access this feature, contact Amazon Web Services Support for
19612
19631
  # allowlisting.
19613
19632
  #
19614
19633
  # </note>
@@ -21543,7 +21562,7 @@ module Aws::Connect
21543
21562
  tracer: tracer
21544
21563
  )
21545
21564
  context[:gem_name] = 'aws-sdk-connect'
21546
- context[:gem_version] = '1.213.0'
21565
+ context[:gem_version] = '1.215.0'
21547
21566
  Seahorse::Client::Request.new(handlers, context)
21548
21567
  end
21549
21568
 
@@ -43,6 +43,7 @@ module Aws::Connect
43
43
  AgentStatus = Shapes::StructureShape.new(name: 'AgentStatus')
44
44
  AgentStatusDescription = Shapes::StringShape.new(name: 'AgentStatusDescription')
45
45
  AgentStatusId = Shapes::StringShape.new(name: 'AgentStatusId')
46
+ AgentStatusIdentifier = Shapes::StructureShape.new(name: 'AgentStatusIdentifier')
46
47
  AgentStatusList = Shapes::ListShape.new(name: 'AgentStatusList')
47
48
  AgentStatusName = Shapes::StringShape.new(name: 'AgentStatusName')
48
49
  AgentStatusOrderNumber = Shapes::IntegerShape.new(name: 'AgentStatusOrderNumber')
@@ -55,6 +56,7 @@ module Aws::Connect
55
56
  AgentStatusSummaryList = Shapes::ListShape.new(name: 'AgentStatusSummaryList')
56
57
  AgentStatusType = Shapes::StringShape.new(name: 'AgentStatusType')
57
58
  AgentStatusTypes = Shapes::ListShape.new(name: 'AgentStatusTypes')
59
+ AgentStatuses = Shapes::ListShape.new(name: 'AgentStatuses')
58
60
  AgentUsername = Shapes::StringShape.new(name: 'AgentUsername')
59
61
  AgentsCriteria = Shapes::StructureShape.new(name: 'AgentsCriteria')
60
62
  AgentsMinOneMaxHundred = Shapes::ListShape.new(name: 'AgentsMinOneMaxHundred')
@@ -1646,6 +1648,10 @@ module Aws::Connect
1646
1648
  AgentStatus.add_member(:last_modified_region, Shapes::ShapeRef.new(shape: RegionName, location_name: "LastModifiedRegion"))
1647
1649
  AgentStatus.struct_class = Types::AgentStatus
1648
1650
 
1651
+ AgentStatusIdentifier.add_member(:arn, Shapes::ShapeRef.new(shape: ARN, location_name: "Arn"))
1652
+ AgentStatusIdentifier.add_member(:id, Shapes::ShapeRef.new(shape: AgentStatusId, location_name: "Id"))
1653
+ AgentStatusIdentifier.struct_class = Types::AgentStatusIdentifier
1654
+
1649
1655
  AgentStatusList.member = Shapes::ShapeRef.new(shape: AgentStatus)
1650
1656
 
1651
1657
  AgentStatusReference.add_member(:status_start_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "StatusStartTimestamp"))
@@ -1675,6 +1681,8 @@ module Aws::Connect
1675
1681
 
1676
1682
  AgentStatusTypes.member = Shapes::ShapeRef.new(shape: AgentStatusType)
1677
1683
 
1684
+ AgentStatuses.member = Shapes::ShapeRef.new(shape: AgentStatusId)
1685
+
1678
1686
  AgentsCriteria.add_member(:agent_ids, Shapes::ShapeRef.new(shape: AgentIds, location_name: "AgentIds"))
1679
1687
  AgentsCriteria.struct_class = Types::AgentsCriteria
1680
1688
 
@@ -3098,6 +3106,7 @@ module Aws::Connect
3098
3106
  Dimensions.add_member(:channel, Shapes::ShapeRef.new(shape: Channel, location_name: "Channel"))
3099
3107
  Dimensions.add_member(:routing_profile, Shapes::ShapeRef.new(shape: RoutingProfileReference, location_name: "RoutingProfile"))
3100
3108
  Dimensions.add_member(:routing_step_expression, Shapes::ShapeRef.new(shape: RoutingExpression, location_name: "RoutingStepExpression"))
3109
+ Dimensions.add_member(:agent_status, Shapes::ShapeRef.new(shape: AgentStatusIdentifier, location_name: "AgentStatus"))
3101
3110
  Dimensions.struct_class = Types::Dimensions
3102
3111
 
3103
3112
  DimensionsV2Map.key = Shapes::ShapeRef.new(shape: DimensionsV2Key)
@@ -3527,6 +3536,7 @@ module Aws::Connect
3527
3536
  Filters.add_member(:channels, Shapes::ShapeRef.new(shape: Channels, location_name: "Channels"))
3528
3537
  Filters.add_member(:routing_profiles, Shapes::ShapeRef.new(shape: RoutingProfiles, location_name: "RoutingProfiles"))
3529
3538
  Filters.add_member(:routing_step_expressions, Shapes::ShapeRef.new(shape: RoutingExpressions, location_name: "RoutingStepExpressions"))
3539
+ Filters.add_member(:agent_statuses, Shapes::ShapeRef.new(shape: AgentStatuses, location_name: "AgentStatuses"))
3530
3540
  Filters.struct_class = Types::Filters
3531
3541
 
3532
3542
  FiltersV2List.member = Shapes::ShapeRef.new(shape: FilterV2)
@@ -389,6 +389,25 @@ module Aws::Connect
389
389
  include Aws::Structure
390
390
  end
391
391
 
392
+ # Information about the agent status assigned to the user.
393
+ #
394
+ # @!attribute [rw] arn
395
+ # The Amazon Resource Name (ARN) of the agent status.
396
+ # @return [String]
397
+ #
398
+ # @!attribute [rw] id
399
+ # The identifier of the agent status.
400
+ # @return [String]
401
+ #
402
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/AgentStatusIdentifier AWS API Documentation
403
+ #
404
+ class AgentStatusIdentifier < Struct.new(
405
+ :arn,
406
+ :id)
407
+ SENSITIVE = []
408
+ include Aws::Structure
409
+ end
410
+
392
411
  # Information about the agent's status.
393
412
  #
394
413
  # @!attribute [rw] status_start_timestamp
@@ -1564,8 +1583,8 @@ module Aws::Connect
1564
1583
  end
1565
1584
 
1566
1585
  # This API is in preview release for Amazon Connect and is subject to
1567
- # change. To request access to this API, contact Amazon Web
1568
- # ServicesSupport.
1586
+ # change. To request access to this API, contact Amazon Web Services
1587
+ # Support.
1569
1588
  #
1570
1589
  # Information about an authentication profile. An authentication profile
1571
1590
  # is a resource that stores the authentication settings for users in
@@ -1678,8 +1697,8 @@ module Aws::Connect
1678
1697
  end
1679
1698
 
1680
1699
  # This API is in preview release for Amazon Connect and is subject to
1681
- # change. To request access to this API, contact Amazon Web
1682
- # ServicesSupport.
1700
+ # change. To request access to this API, contact Amazon Web Services
1701
+ # Support.
1683
1702
  #
1684
1703
  # A summary of a given authentication profile.
1685
1704
  #
@@ -7936,13 +7955,18 @@ module Aws::Connect
7936
7955
  # The expression of a step in a routing criteria.
7937
7956
  # @return [String]
7938
7957
  #
7958
+ # @!attribute [rw] agent_status
7959
+ # Information about the agent status assigned to the user.
7960
+ # @return [Types::AgentStatusIdentifier]
7961
+ #
7939
7962
  # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/Dimensions AWS API Documentation
7940
7963
  #
7941
7964
  class Dimensions < Struct.new(
7942
7965
  :queue,
7943
7966
  :channel,
7944
7967
  :routing_profile,
7945
- :routing_step_expression)
7968
+ :routing_step_expression,
7969
+ :agent_status)
7946
7970
  SENSITIVE = []
7947
7971
  include Aws::Structure
7948
7972
  end
@@ -9868,13 +9892,18 @@ module Aws::Connect
9868
9892
  # object of a step in a routing criteria.
9869
9893
  # @return [Array<String>]
9870
9894
  #
9895
+ # @!attribute [rw] agent_statuses
9896
+ # A list of up to 50 agent status IDs or ARNs.
9897
+ # @return [Array<String>]
9898
+ #
9871
9899
  # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/Filters AWS API Documentation
9872
9900
  #
9873
9901
  class Filters < Struct.new(
9874
9902
  :queues,
9875
9903
  :channels,
9876
9904
  :routing_profiles,
9877
- :routing_step_expressions)
9905
+ :routing_step_expressions,
9906
+ :agent_statuses)
9878
9907
  SENSITIVE = []
9879
9908
  include Aws::Structure
9880
9909
  end
@@ -10118,11 +10147,16 @@ module Aws::Connect
10118
10147
  #
10119
10148
  # * RoutingStepExpressions: 50
10120
10149
  #
10150
+ # * AgentStatuses: 50
10151
+ #
10121
10152
  # Metric data is retrieved only for the resources associated with the
10122
10153
  # queues or routing profiles, and by any channels included in the
10123
10154
  # filter. (You cannot filter by both queue AND routing profile.) You
10124
10155
  # can include both resource IDs and resource ARNs in the same request.
10125
10156
  #
10157
+ # When using `AgentStatuses` as filter make sure Queues is added as
10158
+ # primary filter.
10159
+ #
10126
10160
  # When using the `RoutingStepExpression` filter, you need to pass
10127
10161
  # exactly one `QueueId`. The filter is also case sensitive so when
10128
10162
  # using the `RoutingStepExpression` filter, grouping by
@@ -10133,21 +10167,29 @@ module Aws::Connect
10133
10167
  # @return [Types::Filters]
10134
10168
  #
10135
10169
  # @!attribute [rw] groupings
10136
- # The grouping applied to the metrics returned. For example, when
10137
- # grouped by `QUEUE`, the metrics returned apply to each queue rather
10138
- # than aggregated for all queues.
10170
+ # Defines the level of aggregation for metrics data by a dimension(s).
10171
+ # Its similar to sorting items into buckets based on a common
10172
+ # characteristic, then counting or calculating something for each
10173
+ # bucket. For example, when grouped by `QUEUE`, the metrics returned
10174
+ # apply to each queue rather than aggregated for all queues.
10175
+ #
10176
+ # The grouping list is an ordered list, with the first item in the
10177
+ # list defined as the primary grouping. If no grouping is included in
10178
+ # the request, the aggregation happens at the instance-level.
10139
10179
  #
10140
10180
  # * If you group by `CHANNEL`, you should include a Channels filter.
10141
10181
  # VOICE, CHAT, and TASK channels are supported.
10142
10182
  #
10183
+ # * If you group by `AGENT_STATUS`, you must include the `QUEUE` as
10184
+ # the primary grouping and use queue filter. When you group by
10185
+ # `AGENT_STATUS`, the only metric available is the `AGENTS_ONLINE`
10186
+ # metric.
10187
+ #
10143
10188
  # * If you group by `ROUTING_PROFILE`, you must include either a queue
10144
10189
  # or routing profile filter. In addition, a routing profile filter
10145
10190
  # is required for metrics `CONTACTS_SCHEDULED`, `CONTACTS_IN_QUEUE`,
10146
10191
  # and ` OLDEST_CONTACT_AGE`.
10147
10192
  #
10148
- # * If no `Grouping` is included in the request, a summary of metrics
10149
- # is returned.
10150
- #
10151
10193
  # * When using the `RoutingStepExpression` filter, group by
10152
10194
  # `ROUTING_STEP_EXPRESSION` is required.
10153
10195
  # @return [Array<String>]
@@ -25993,7 +26035,7 @@ module Aws::Connect
25993
26035
  # The type of attribute.
25994
26036
  #
25995
26037
  # <note markdown="1"> Only allowlisted customers can consume USE\_CUSTOM\_TTS\_VOICES. To
25996
- # access this feature, contact Amazon Web ServicesSupport for
26038
+ # access this feature, contact Amazon Web Services Support for
25997
26039
  # allowlisting.
25998
26040
  #
25999
26041
  # </note>
@@ -54,7 +54,7 @@ module Aws::Connect
54
54
  autoload :EndpointProvider, 'aws-sdk-connect/endpoint_provider'
55
55
  autoload :Endpoints, 'aws-sdk-connect/endpoints'
56
56
 
57
- GEM_VERSION = '1.213.0'
57
+ GEM_VERSION = '1.215.0'
58
58
 
59
59
  end
60
60
 
data/sig/client.rbs CHANGED
@@ -1907,9 +1907,10 @@ module Aws
1907
1907
  queues: Array[::String]?,
1908
1908
  channels: Array[("VOICE" | "CHAT" | "TASK" | "EMAIL")]?,
1909
1909
  routing_profiles: Array[::String]?,
1910
- routing_step_expressions: Array[::String]?
1910
+ routing_step_expressions: Array[::String]?,
1911
+ agent_statuses: Array[::String]?
1911
1912
  },
1912
- ?groupings: Array[("QUEUE" | "CHANNEL" | "ROUTING_PROFILE" | "ROUTING_STEP_EXPRESSION")],
1913
+ ?groupings: Array[("QUEUE" | "CHANNEL" | "ROUTING_PROFILE" | "ROUTING_STEP_EXPRESSION" | "AGENT_STATUS")],
1913
1914
  current_metrics: Array[
1914
1915
  {
1915
1916
  name: ("AGENTS_ONLINE" | "AGENTS_AVAILABLE" | "AGENTS_ON_CALL" | "AGENTS_NON_PRODUCTIVE" | "AGENTS_AFTER_CONTACT_WORK" | "AGENTS_ERROR" | "AGENTS_STAFFED" | "CONTACTS_IN_QUEUE" | "OLDEST_CONTACT_AGE" | "CONTACTS_SCHEDULED" | "AGENTS_ON_CONTACT" | "SLOTS_ACTIVE" | "SLOTS_AVAILABLE")?,
@@ -2005,9 +2006,10 @@ module Aws
2005
2006
  queues: Array[::String]?,
2006
2007
  channels: Array[("VOICE" | "CHAT" | "TASK" | "EMAIL")]?,
2007
2008
  routing_profiles: Array[::String]?,
2008
- routing_step_expressions: Array[::String]?
2009
+ routing_step_expressions: Array[::String]?,
2010
+ agent_statuses: Array[::String]?
2009
2011
  },
2010
- ?groupings: Array[("QUEUE" | "CHANNEL" | "ROUTING_PROFILE" | "ROUTING_STEP_EXPRESSION")],
2012
+ ?groupings: Array[("QUEUE" | "CHANNEL" | "ROUTING_PROFILE" | "ROUTING_STEP_EXPRESSION" | "AGENT_STATUS")],
2011
2013
  historical_metrics: Array[
2012
2014
  {
2013
2015
  name: ("CONTACTS_QUEUED" | "CONTACTS_HANDLED" | "CONTACTS_ABANDONED" | "CONTACTS_CONSULTED" | "CONTACTS_AGENT_HUNG_UP_FIRST" | "CONTACTS_HANDLED_INCOMING" | "CONTACTS_HANDLED_OUTBOUND" | "CONTACTS_HOLD_ABANDONS" | "CONTACTS_TRANSFERRED_IN" | "CONTACTS_TRANSFERRED_OUT" | "CONTACTS_TRANSFERRED_IN_FROM_QUEUE" | "CONTACTS_TRANSFERRED_OUT_FROM_QUEUE" | "CONTACTS_MISSED" | "CALLBACK_CONTACTS_HANDLED" | "API_CONTACTS_HANDLED" | "OCCUPANCY" | "HANDLE_TIME" | "AFTER_CONTACT_WORK_TIME" | "QUEUED_TIME" | "ABANDON_TIME" | "QUEUE_ANSWER_TIME" | "HOLD_TIME" | "INTERACTION_TIME" | "INTERACTION_AND_HOLD_TIME" | "SERVICE_LEVEL")?,
data/sig/types.rbs CHANGED
@@ -102,6 +102,12 @@ module Aws::Connect
102
102
  SENSITIVE: []
103
103
  end
104
104
 
105
+ class AgentStatusIdentifier
106
+ attr_accessor arn: ::String
107
+ attr_accessor id: ::String
108
+ SENSITIVE: []
109
+ end
110
+
105
111
  class AgentStatusReference
106
112
  attr_accessor status_start_timestamp: ::Time
107
113
  attr_accessor status_arn: ::String
@@ -1978,6 +1984,7 @@ module Aws::Connect
1978
1984
  attr_accessor channel: ("VOICE" | "CHAT" | "TASK" | "EMAIL")
1979
1985
  attr_accessor routing_profile: Types::RoutingProfileReference
1980
1986
  attr_accessor routing_step_expression: ::String
1987
+ attr_accessor agent_status: Types::AgentStatusIdentifier
1981
1988
  SENSITIVE: []
1982
1989
  end
1983
1990
 
@@ -2501,6 +2508,7 @@ module Aws::Connect
2501
2508
  attr_accessor channels: ::Array[("VOICE" | "CHAT" | "TASK" | "EMAIL")]
2502
2509
  attr_accessor routing_profiles: ::Array[::String]
2503
2510
  attr_accessor routing_step_expressions: ::Array[::String]
2511
+ attr_accessor agent_statuses: ::Array[::String]
2504
2512
  SENSITIVE: []
2505
2513
  end
2506
2514
 
@@ -2562,7 +2570,7 @@ module Aws::Connect
2562
2570
  class GetCurrentMetricDataRequest
2563
2571
  attr_accessor instance_id: ::String
2564
2572
  attr_accessor filters: Types::Filters
2565
- attr_accessor groupings: ::Array[("QUEUE" | "CHANNEL" | "ROUTING_PROFILE" | "ROUTING_STEP_EXPRESSION")]
2573
+ attr_accessor groupings: ::Array[("QUEUE" | "CHANNEL" | "ROUTING_PROFILE" | "ROUTING_STEP_EXPRESSION" | "AGENT_STATUS")]
2566
2574
  attr_accessor current_metrics: ::Array[Types::CurrentMetric]
2567
2575
  attr_accessor next_token: ::String
2568
2576
  attr_accessor max_results: ::Integer
@@ -2639,7 +2647,7 @@ module Aws::Connect
2639
2647
  attr_accessor start_time: ::Time
2640
2648
  attr_accessor end_time: ::Time
2641
2649
  attr_accessor filters: Types::Filters
2642
- attr_accessor groupings: ::Array[("QUEUE" | "CHANNEL" | "ROUTING_PROFILE" | "ROUTING_STEP_EXPRESSION")]
2650
+ attr_accessor groupings: ::Array[("QUEUE" | "CHANNEL" | "ROUTING_PROFILE" | "ROUTING_STEP_EXPRESSION" | "AGENT_STATUS")]
2643
2651
  attr_accessor historical_metrics: ::Array[Types::HistoricalMetric]
2644
2652
  attr_accessor next_token: ::String
2645
2653
  attr_accessor max_results: ::Integer
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-connect
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.213.0
4
+ version: 1.215.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
@@ -18,7 +18,7 @@ dependencies:
18
18
  version: '3'
19
19
  - - ">="
20
20
  - !ruby/object:Gem::Version
21
- version: 3.228.0
21
+ version: 3.231.0
22
22
  type: :runtime
23
23
  prerelease: false
24
24
  version_requirements: !ruby/object:Gem::Requirement
@@ -28,7 +28,7 @@ dependencies:
28
28
  version: '3'
29
29
  - - ">="
30
30
  - !ruby/object:Gem::Version
31
- version: 3.228.0
31
+ version: 3.231.0
32
32
  - !ruby/object:Gem::Dependency
33
33
  name: aws-sigv4
34
34
  requirement: !ruby/object:Gem::Requirement