aws-sdk-connect 1.72.0 → 1.73.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 454e4e8747849568600cf3055d9a012687e646a4d4f610b9fa601a8e454f038a
-  data.tar.gz: 28020fedb226d7fe2d453546655cedc1f4a37c537944ebcdca87b6345b58a977
+  metadata.gz: 9bfe9fe7c29b4272b1deef88a97bb0d5f53dbb4ae936ddf5a8be1020ee5266a0
+  data.tar.gz: ee7f3ad382277b51fafea5c84e691139d559e39dfd96e463e6d7191f71e22f1f
 SHA512:
-  metadata.gz: 78d81c1a99ea39d9a20e59319d5e6215ce91142d97fabe42fdc60d3905bb5b1c2a99473dd5dcc54b8735282286bf5f3e119fabcc6ffb037e2eb9c2aeaaa641bc
-  data.tar.gz: e824efc927a4471b7b7d25d9faf2748bb0933aec97055470300a23292b601ff2dbf6963e829e1767064c50be331afef106182a383132c7cfa54ec14e9eead338
+  metadata.gz: 60953ce322f59650c946418b7f9966ff59ab83b63ebcebb87eccc843f8251c23d14dbcaf21fe502be08943be2eeefa6680caed1dc10bfddecc1421f7bb78ce88
+  data.tar.gz: 2ce7c8c821fe5f144e6731baa24ff548a55f366df71669a4975a62561865be92deec4d078840c31c90c69012cd06ae1d00978324b6ec6eece3255b6a4c4f4af4

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.73.0 (2022-06-06)
+------------------
+
+* Feature - This release adds a new API, GetCurrentUserData, which returns real-time details about users' current activity.
+
 1.72.0 (2022-06-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.72.0
+1.73.0

data/lib/aws-sdk-connect/client.rb

@@ -3488,6 +3488,92 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Gets the real-time active user data from the specified Amazon Connect
+    # instance.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can find the
+    #   instanceId in the ARN of the instance.
+    #
+    # @option params [required, Types::UserDataFilters] :filters
+    #   Filters up to 100 `Queues`, or up to 9 `ContactStates`. The user data
+    #   is retrieved only for those users who are associated with the queues
+    #   and have contacts that are in the specified `ContactState`.
+    #
+    # @option params [String] :next_token
+    #   The token for the next set of results. Use the value returned in the
+    #   previous response in the next request to retrieve the next set of
+    #   results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return per page.
+    #
+    # @return [Types::GetCurrentUserDataResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetCurrentUserDataResponse#next_token #next_token} => String
+    #   * {Types::GetCurrentUserDataResponse#user_data_list #user_data_list} => Array<Types::UserData>
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_current_user_data({
+    #     instance_id: "InstanceId", # required
+    #     filters: { # required
+    #       queues: ["QueueId"],
+    #       contact_filter: {
+    #         contact_states: ["INCOMING"], # accepts INCOMING, PENDING, CONNECTING, CONNECTED, CONNECTED_ONHOLD, MISSED, ERROR, ENDED, REJECTED
+    #       },
+    #     },
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.user_data_list #=> Array
+    #   resp.user_data_list[0].user.id #=> String
+    #   resp.user_data_list[0].user.arn #=> String
+    #   resp.user_data_list[0].routing_profile.id #=> String
+    #   resp.user_data_list[0].routing_profile.arn #=> String
+    #   resp.user_data_list[0].hierarchy_path.level_one.id #=> String
+    #   resp.user_data_list[0].hierarchy_path.level_one.arn #=> String
+    #   resp.user_data_list[0].hierarchy_path.level_two.id #=> String
+    #   resp.user_data_list[0].hierarchy_path.level_two.arn #=> String
+    #   resp.user_data_list[0].hierarchy_path.level_three.id #=> String
+    #   resp.user_data_list[0].hierarchy_path.level_three.arn #=> String
+    #   resp.user_data_list[0].hierarchy_path.level_four.id #=> String
+    #   resp.user_data_list[0].hierarchy_path.level_four.arn #=> String
+    #   resp.user_data_list[0].hierarchy_path.level_five.id #=> String
+    #   resp.user_data_list[0].hierarchy_path.level_five.arn #=> String
+    #   resp.user_data_list[0].status.status_start_timestamp #=> Time
+    #   resp.user_data_list[0].status.status_arn #=> String
+    #   resp.user_data_list[0].available_slots_by_channel #=> Hash
+    #   resp.user_data_list[0].available_slots_by_channel["Channel"] #=> Integer
+    #   resp.user_data_list[0].max_slots_by_channel #=> Hash
+    #   resp.user_data_list[0].max_slots_by_channel["Channel"] #=> Integer
+    #   resp.user_data_list[0].active_slots_by_channel #=> Hash
+    #   resp.user_data_list[0].active_slots_by_channel["Channel"] #=> Integer
+    #   resp.user_data_list[0].contacts #=> Array
+    #   resp.user_data_list[0].contacts[0].contact_id #=> String
+    #   resp.user_data_list[0].contacts[0].channel #=> String, one of "VOICE", "CHAT", "TASK"
+    #   resp.user_data_list[0].contacts[0].initiation_method #=> String, one of "INBOUND", "OUTBOUND", "TRANSFER", "QUEUE_TRANSFER", "CALLBACK", "API"
+    #   resp.user_data_list[0].contacts[0].agent_contact_state #=> String, one of "INCOMING", "PENDING", "CONNECTING", "CONNECTED", "CONNECTED_ONHOLD", "MISSED", "ERROR", "ENDED", "REJECTED"
+    #   resp.user_data_list[0].contacts[0].state_start_timestamp #=> Time
+    #   resp.user_data_list[0].contacts[0].connected_to_agent_timestamp #=> Time
+    #   resp.user_data_list[0].contacts[0].queue.id #=> String
+    #   resp.user_data_list[0].contacts[0].queue.arn #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetCurrentUserData AWS API Documentation
+    #
+    # @overload get_current_user_data(params = {})
+    # @param [Hash] params ({})
+    def get_current_user_data(params = {}, options = {})
+      req = build_request(:get_current_user_data, params)
+      req.send_request(options)
+    end
+
     # Retrieves a token for federation.
     #
     # <note markdown="1"> This API doesn't support root users. If you try to invoke
@@ -6559,7 +6645,7 @@ module Aws::Connect
     #   instanceId in the ARN of the instance.
     #
     # @option params [required, String] :contact_id
-    #   The identifier of the contact in this instance of Amazon Connect
+    #   The identifier of the contact in this instance of Amazon Connect.
     #
     # @option params [String] :queue_id
     #   The identifier for the queue.
@@ -8097,7 +8183,7 @@ module Aws::Connect
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.72.0'
+      context[:gem_version] = '1.73.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-connect/client_api.rb

@@ -16,6 +16,8 @@ module Aws::Connect
     ARN = Shapes::StringShape.new(name: 'ARN')
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
     AfterContactWorkTimeLimit = Shapes::IntegerShape.new(name: 'AfterContactWorkTimeLimit')
+    AgentContactReference = Shapes::StructureShape.new(name: 'AgentContactReference')
+    AgentContactReferenceList = Shapes::ListShape.new(name: 'AgentContactReferenceList')
     AgentFirstName = Shapes::StringShape.new(name: 'AgentFirstName')
     AgentInfo = Shapes::StructureShape.new(name: 'AgentInfo')
     AgentLastName = Shapes::StringShape.new(name: 'AgentLastName')
@@ -25,6 +27,7 @@ module Aws::Connect
     AgentStatusId = Shapes::StringShape.new(name: 'AgentStatusId')
     AgentStatusName = Shapes::StringShape.new(name: 'AgentStatusName')
     AgentStatusOrderNumber = Shapes::IntegerShape.new(name: 'AgentStatusOrderNumber')
+    AgentStatusReference = Shapes::StructureShape.new(name: 'AgentStatusReference')
     AgentStatusState = Shapes::StringShape.new(name: 'AgentStatusState')
     AgentStatusSummary = Shapes::StructureShape.new(name: 'AgentStatusSummary')
     AgentStatusSummaryList = Shapes::ListShape.new(name: 'AgentStatusSummaryList')
@@ -62,6 +65,7 @@ module Aws::Connect
     BucketName = Shapes::StringShape.new(name: 'BucketName')
     CampaignId = Shapes::StringShape.new(name: 'CampaignId')
     Channel = Shapes::StringShape.new(name: 'Channel')
+    ChannelToCountMap = Shapes::MapShape.new(name: 'ChannelToCountMap')
     Channels = Shapes::ListShape.new(name: 'Channels')
     ChatContent = Shapes::StringShape.new(name: 'ChatContent')
     ChatContentType = Shapes::StringShape.new(name: 'ChatContentType')
@@ -77,6 +81,7 @@ module Aws::Connect
     Comparison = Shapes::StringShape.new(name: 'Comparison')
     Concurrency = Shapes::IntegerShape.new(name: 'Concurrency')
     Contact = Shapes::StructureShape.new(name: 'Contact')
+    ContactFilter = Shapes::StructureShape.new(name: 'ContactFilter')
     ContactFlow = Shapes::StructureShape.new(name: 'ContactFlow')
     ContactFlowContent = Shapes::StringShape.new(name: 'ContactFlowContent')
     ContactFlowDescription = Shapes::StringShape.new(name: 'ContactFlowDescription')
@@ -101,6 +106,8 @@ module Aws::Connect
     ContactInitiationMethod = Shapes::StringShape.new(name: 'ContactInitiationMethod')
     ContactNotFoundException = Shapes::StructureShape.new(name: 'ContactNotFoundException')
     ContactReferences = Shapes::MapShape.new(name: 'ContactReferences')
+    ContactState = Shapes::StringShape.new(name: 'ContactState')
+    ContactStates = Shapes::ListShape.new(name: 'ContactStates')
     ControlPlaneTagFilter = Shapes::StructureShape.new(name: 'ControlPlaneTagFilter')
     CreateAgentStatusRequest = Shapes::StructureShape.new(name: 'CreateAgentStatusRequest')
     CreateAgentStatusResponse = Shapes::StructureShape.new(name: 'CreateAgentStatusResponse')
@@ -222,6 +229,8 @@ module Aws::Connect
     GetContactAttributesResponse = Shapes::StructureShape.new(name: 'GetContactAttributesResponse')
     GetCurrentMetricDataRequest = Shapes::StructureShape.new(name: 'GetCurrentMetricDataRequest')
     GetCurrentMetricDataResponse = Shapes::StructureShape.new(name: 'GetCurrentMetricDataResponse')
+    GetCurrentUserDataRequest = Shapes::StructureShape.new(name: 'GetCurrentUserDataRequest')
+    GetCurrentUserDataResponse = Shapes::StructureShape.new(name: 'GetCurrentUserDataResponse')
     GetFederationTokenRequest = Shapes::StructureShape.new(name: 'GetFederationTokenRequest')
     GetFederationTokenResponse = Shapes::StructureShape.new(name: 'GetFederationTokenResponse')
     GetMetricDataRequest = Shapes::StructureShape.new(name: 'GetMetricDataRequest')
@@ -237,11 +246,13 @@ module Aws::Connect
     HierarchyGroupName = Shapes::StringShape.new(name: 'HierarchyGroupName')
     HierarchyGroupSummary = Shapes::StructureShape.new(name: 'HierarchyGroupSummary')
     HierarchyGroupSummaryList = Shapes::ListShape.new(name: 'HierarchyGroupSummaryList')
+    HierarchyGroupSummaryReference = Shapes::StructureShape.new(name: 'HierarchyGroupSummaryReference')
     HierarchyLevel = Shapes::StructureShape.new(name: 'HierarchyLevel')
     HierarchyLevelId = Shapes::StringShape.new(name: 'HierarchyLevelId')
     HierarchyLevelName = Shapes::StringShape.new(name: 'HierarchyLevelName')
     HierarchyLevelUpdate = Shapes::StructureShape.new(name: 'HierarchyLevelUpdate')
     HierarchyPath = Shapes::StructureShape.new(name: 'HierarchyPath')
+    HierarchyPathReference = Shapes::StructureShape.new(name: 'HierarchyPathReference')
     HierarchyStructure = Shapes::StructureShape.new(name: 'HierarchyStructure')
     HierarchyStructureUpdate = Shapes::StructureShape.new(name: 'HierarchyStructureUpdate')
     HistoricalMetric = Shapes::StructureShape.new(name: 'HistoricalMetric')
@@ -276,6 +287,7 @@ module Aws::Connect
     InstanceStorageResourceType = Shapes::StringShape.new(name: 'InstanceStorageResourceType')
     InstanceSummary = Shapes::StructureShape.new(name: 'InstanceSummary')
     InstanceSummaryList = Shapes::ListShape.new(name: 'InstanceSummaryList')
+    IntegerCount = Shapes::IntegerShape.new(name: 'IntegerCount')
     IntegrationAssociationId = Shapes::StringShape.new(name: 'IntegrationAssociationId')
     IntegrationAssociationSummary = Shapes::StructureShape.new(name: 'IntegrationAssociationSummary')
     IntegrationAssociationSummaryList = Shapes::ListShape.new(name: 'IntegrationAssociationSummaryList')
@@ -471,6 +483,7 @@ module Aws::Connect
     RoutingProfileQueueConfigSummaryList = Shapes::ListShape.new(name: 'RoutingProfileQueueConfigSummaryList')
     RoutingProfileQueueReference = Shapes::StructureShape.new(name: 'RoutingProfileQueueReference')
     RoutingProfileQueueReferenceList = Shapes::ListShape.new(name: 'RoutingProfileQueueReferenceList')
+    RoutingProfileReference = Shapes::StructureShape.new(name: 'RoutingProfileReference')
     RoutingProfileSummary = Shapes::StructureShape.new(name: 'RoutingProfileSummary')
     RoutingProfileSummaryList = Shapes::ListShape.new(name: 'RoutingProfileSummaryList')
     S3Config = Shapes::StructureShape.new(name: 'S3Config')
@@ -610,12 +623,16 @@ module Aws::Connect
     UseCaseSummaryList = Shapes::ListShape.new(name: 'UseCaseSummaryList')
     UseCaseType = Shapes::StringShape.new(name: 'UseCaseType')
     User = Shapes::StructureShape.new(name: 'User')
+    UserData = Shapes::StructureShape.new(name: 'UserData')
+    UserDataFilters = Shapes::StructureShape.new(name: 'UserDataFilters')
+    UserDataList = Shapes::ListShape.new(name: 'UserDataList')
     UserId = Shapes::StringShape.new(name: 'UserId')
     UserIdentityInfo = Shapes::StructureShape.new(name: 'UserIdentityInfo')
     UserIdentityInfoLite = Shapes::StructureShape.new(name: 'UserIdentityInfoLite')
     UserNotFoundException = Shapes::StructureShape.new(name: 'UserNotFoundException')
     UserPhoneConfig = Shapes::StructureShape.new(name: 'UserPhoneConfig')
     UserQuickConnectConfig = Shapes::StructureShape.new(name: 'UserQuickConnectConfig')
+    UserReference = Shapes::StructureShape.new(name: 'UserReference')
     UserSearchConditionList = Shapes::ListShape.new(name: 'UserSearchConditionList')
     UserSearchCriteria = Shapes::StructureShape.new(name: 'UserSearchCriteria')
     UserSearchFilter = Shapes::StructureShape.new(name: 'UserSearchFilter')
@@ -642,6 +659,17 @@ module Aws::Connect
     AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: Message, location_name: "Message"))
     AccessDeniedException.struct_class = Types::AccessDeniedException
 
+    AgentContactReference.add_member(:contact_id, Shapes::ShapeRef.new(shape: ContactId, location_name: "ContactId"))
+    AgentContactReference.add_member(:channel, Shapes::ShapeRef.new(shape: Channel, location_name: "Channel"))
+    AgentContactReference.add_member(:initiation_method, Shapes::ShapeRef.new(shape: ContactInitiationMethod, location_name: "InitiationMethod"))
+    AgentContactReference.add_member(:agent_contact_state, Shapes::ShapeRef.new(shape: ContactState, location_name: "AgentContactState"))
+    AgentContactReference.add_member(:state_start_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "StateStartTimestamp"))
+    AgentContactReference.add_member(:connected_to_agent_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "ConnectedToAgentTimestamp"))
+    AgentContactReference.add_member(:queue, Shapes::ShapeRef.new(shape: QueueReference, location_name: "Queue"))
+    AgentContactReference.struct_class = Types::AgentContactReference
+
+    AgentContactReferenceList.member = Shapes::ShapeRef.new(shape: AgentContactReference)
+
     AgentInfo.add_member(:id, Shapes::ShapeRef.new(shape: AgentResourceId, location_name: "Id"))
     AgentInfo.add_member(:connected_to_agent_timestamp, Shapes::ShapeRef.new(shape: timestamp, location_name: "ConnectedToAgentTimestamp"))
     AgentInfo.struct_class = Types::AgentInfo
@@ -656,6 +684,10 @@ module Aws::Connect
     AgentStatus.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
     AgentStatus.struct_class = Types::AgentStatus
 
+    AgentStatusReference.add_member(:status_start_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "StatusStartTimestamp"))
+    AgentStatusReference.add_member(:status_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "StatusArn"))
+    AgentStatusReference.struct_class = Types::AgentStatusReference
+
     AgentStatusSummary.add_member(:id, Shapes::ShapeRef.new(shape: AgentStatusId, location_name: "Id"))
     AgentStatusSummary.add_member(:arn, Shapes::ShapeRef.new(shape: ARN, location_name: "Arn"))
     AgentStatusSummary.add_member(:name, Shapes::ShapeRef.new(shape: AgentStatusName, location_name: "Name"))
@@ -745,6 +777,9 @@ module Aws::Connect
 
     AvailableNumbersList.member = Shapes::ShapeRef.new(shape: AvailableNumberSummary)
 
+    ChannelToCountMap.key = Shapes::ShapeRef.new(shape: Channel)
+    ChannelToCountMap.value = Shapes::ShapeRef.new(shape: IntegerCount)
+
     Channels.member = Shapes::ShapeRef.new(shape: Channel)
 
     ChatMessage.add_member(:content_type, Shapes::ShapeRef.new(shape: ChatContentType, required: true, location_name: "ContentType"))
@@ -792,6 +827,9 @@ module Aws::Connect
     Contact.add_member(:scheduled_timestamp, Shapes::ShapeRef.new(shape: timestamp, location_name: "ScheduledTimestamp"))
     Contact.struct_class = Types::Contact
 
+    ContactFilter.add_member(:contact_states, Shapes::ShapeRef.new(shape: ContactStates, location_name: "ContactStates"))
+    ContactFilter.struct_class = Types::ContactFilter
+
     ContactFlow.add_member(:arn, Shapes::ShapeRef.new(shape: ARN, location_name: "Arn"))
     ContactFlow.add_member(:id, Shapes::ShapeRef.new(shape: ContactFlowId, location_name: "Id"))
     ContactFlow.add_member(:name, Shapes::ShapeRef.new(shape: ContactFlowName, location_name: "Name"))
@@ -840,6 +878,8 @@ module Aws::Connect
     ContactReferences.key = Shapes::ShapeRef.new(shape: ReferenceKey)
     ContactReferences.value = Shapes::ShapeRef.new(shape: Reference)
 
+    ContactStates.member = Shapes::ShapeRef.new(shape: ContactState)
+
     ControlPlaneTagFilter.add_member(:or_conditions, Shapes::ShapeRef.new(shape: TagOrConditionList, location_name: "OrConditions"))
     ControlPlaneTagFilter.add_member(:and_conditions, Shapes::ShapeRef.new(shape: TagAndConditionList, location_name: "AndConditions"))
     ControlPlaneTagFilter.add_member(:tag_condition, Shapes::ShapeRef.new(shape: TagCondition, location_name: "TagCondition"))
@@ -1326,6 +1366,16 @@ module Aws::Connect
     GetCurrentMetricDataResponse.add_member(:data_snapshot_time, Shapes::ShapeRef.new(shape: timestamp, location_name: "DataSnapshotTime"))
     GetCurrentMetricDataResponse.struct_class = Types::GetCurrentMetricDataResponse
 
+    GetCurrentUserDataRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location: "uri", location_name: "InstanceId"))
+    GetCurrentUserDataRequest.add_member(:filters, Shapes::ShapeRef.new(shape: UserDataFilters, required: true, location_name: "Filters"))
+    GetCurrentUserDataRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    GetCurrentUserDataRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResult100, location_name: "MaxResults", metadata: {"box"=>true}))
+    GetCurrentUserDataRequest.struct_class = Types::GetCurrentUserDataRequest
+
+    GetCurrentUserDataResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    GetCurrentUserDataResponse.add_member(:user_data_list, Shapes::ShapeRef.new(shape: UserDataList, location_name: "UserDataList"))
+    GetCurrentUserDataResponse.struct_class = Types::GetCurrentUserDataResponse
+
     GetFederationTokenRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location: "uri", location_name: "InstanceId"))
     GetFederationTokenRequest.struct_class = Types::GetFederationTokenRequest
 
@@ -1387,6 +1437,10 @@ module Aws::Connect
 
     HierarchyGroupSummaryList.member = Shapes::ShapeRef.new(shape: HierarchyGroupSummary)
 
+    HierarchyGroupSummaryReference.add_member(:id, Shapes::ShapeRef.new(shape: HierarchyGroupId, location_name: "Id"))
+    HierarchyGroupSummaryReference.add_member(:arn, Shapes::ShapeRef.new(shape: ARN, location_name: "Arn"))
+    HierarchyGroupSummaryReference.struct_class = Types::HierarchyGroupSummaryReference
+
     HierarchyLevel.add_member(:id, Shapes::ShapeRef.new(shape: HierarchyLevelId, location_name: "Id"))
     HierarchyLevel.add_member(:arn, Shapes::ShapeRef.new(shape: ARN, location_name: "Arn"))
     HierarchyLevel.add_member(:name, Shapes::ShapeRef.new(shape: HierarchyLevelName, location_name: "Name"))
@@ -1402,6 +1456,13 @@ module Aws::Connect
     HierarchyPath.add_member(:level_five, Shapes::ShapeRef.new(shape: HierarchyGroupSummary, location_name: "LevelFive"))
     HierarchyPath.struct_class = Types::HierarchyPath
 
+    HierarchyPathReference.add_member(:level_one, Shapes::ShapeRef.new(shape: HierarchyGroupSummaryReference, location_name: "LevelOne"))
+    HierarchyPathReference.add_member(:level_two, Shapes::ShapeRef.new(shape: HierarchyGroupSummaryReference, location_name: "LevelTwo"))
+    HierarchyPathReference.add_member(:level_three, Shapes::ShapeRef.new(shape: HierarchyGroupSummaryReference, location_name: "LevelThree"))
+    HierarchyPathReference.add_member(:level_four, Shapes::ShapeRef.new(shape: HierarchyGroupSummaryReference, location_name: "LevelFour"))
+    HierarchyPathReference.add_member(:level_five, Shapes::ShapeRef.new(shape: HierarchyGroupSummaryReference, location_name: "LevelFive"))
+    HierarchyPathReference.struct_class = Types::HierarchyPathReference
+
     HierarchyStructure.add_member(:level_one, Shapes::ShapeRef.new(shape: HierarchyLevel, location_name: "LevelOne"))
     HierarchyStructure.add_member(:level_two, Shapes::ShapeRef.new(shape: HierarchyLevel, location_name: "LevelTwo"))
     HierarchyStructure.add_member(:level_three, Shapes::ShapeRef.new(shape: HierarchyLevel, location_name: "LevelThree"))
@@ -2087,6 +2148,10 @@ module Aws::Connect
 
     RoutingProfileQueueReferenceList.member = Shapes::ShapeRef.new(shape: RoutingProfileQueueReference)
 
+    RoutingProfileReference.add_member(:id, Shapes::ShapeRef.new(shape: RoutingProfileId, location_name: "Id"))
+    RoutingProfileReference.add_member(:arn, Shapes::ShapeRef.new(shape: ARN, location_name: "Arn"))
+    RoutingProfileReference.struct_class = Types::RoutingProfileReference
+
     RoutingProfileSummary.add_member(:id, Shapes::ShapeRef.new(shape: RoutingProfileId, location_name: "Id"))
     RoutingProfileSummary.add_member(:arn, Shapes::ShapeRef.new(shape: ARN, location_name: "Arn"))
     RoutingProfileSummary.add_member(:name, Shapes::ShapeRef.new(shape: RoutingProfileName, location_name: "Name"))
@@ -2581,6 +2646,22 @@ module Aws::Connect
     User.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
     User.struct_class = Types::User
 
+    UserData.add_member(:user, Shapes::ShapeRef.new(shape: UserReference, location_name: "User"))
+    UserData.add_member(:routing_profile, Shapes::ShapeRef.new(shape: RoutingProfileReference, location_name: "RoutingProfile"))
+    UserData.add_member(:hierarchy_path, Shapes::ShapeRef.new(shape: HierarchyPathReference, location_name: "HierarchyPath"))
+    UserData.add_member(:status, Shapes::ShapeRef.new(shape: AgentStatusReference, location_name: "Status"))
+    UserData.add_member(:available_slots_by_channel, Shapes::ShapeRef.new(shape: ChannelToCountMap, location_name: "AvailableSlotsByChannel"))
+    UserData.add_member(:max_slots_by_channel, Shapes::ShapeRef.new(shape: ChannelToCountMap, location_name: "MaxSlotsByChannel"))
+    UserData.add_member(:active_slots_by_channel, Shapes::ShapeRef.new(shape: ChannelToCountMap, location_name: "ActiveSlotsByChannel"))
+    UserData.add_member(:contacts, Shapes::ShapeRef.new(shape: AgentContactReferenceList, location_name: "Contacts"))
+    UserData.struct_class = Types::UserData
+
+    UserDataFilters.add_member(:queues, Shapes::ShapeRef.new(shape: Queues, location_name: "Queues"))
+    UserDataFilters.add_member(:contact_filter, Shapes::ShapeRef.new(shape: ContactFilter, location_name: "ContactFilter"))
+    UserDataFilters.struct_class = Types::UserDataFilters
+
+    UserDataList.member = Shapes::ShapeRef.new(shape: UserData)
+
     UserIdentityInfo.add_member(:first_name, Shapes::ShapeRef.new(shape: AgentFirstName, location_name: "FirstName"))
     UserIdentityInfo.add_member(:last_name, Shapes::ShapeRef.new(shape: AgentLastName, location_name: "LastName"))
     UserIdentityInfo.add_member(:email, Shapes::ShapeRef.new(shape: Email, location_name: "Email"))
@@ -2603,6 +2684,10 @@ module Aws::Connect
     UserQuickConnectConfig.add_member(:contact_flow_id, Shapes::ShapeRef.new(shape: ContactFlowId, required: true, location_name: "ContactFlowId"))
     UserQuickConnectConfig.struct_class = Types::UserQuickConnectConfig
 
+    UserReference.add_member(:id, Shapes::ShapeRef.new(shape: UserId, location_name: "Id"))
+    UserReference.add_member(:arn, Shapes::ShapeRef.new(shape: ARN, location_name: "Arn"))
+    UserReference.struct_class = Types::UserReference
+
     UserSearchConditionList.member = Shapes::ShapeRef.new(shape: UserSearchCriteria)
 
     UserSearchCriteria.add_member(:or_conditions, Shapes::ShapeRef.new(shape: UserSearchConditionList, location_name: "OrConditions"))
@@ -3582,6 +3667,25 @@ module Aws::Connect
         )
       end)
 
+      api.add_operation(:get_current_user_data, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetCurrentUserData"
+        o.http_method = "POST"
+        o.http_request_uri = "/metrics/userdata/{InstanceId}"
+        o.input = Shapes::ShapeRef.new(shape: GetCurrentUserDataRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetCurrentUserDataResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:get_federation_token, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetFederationToken"
         o.http_method = "GET"

data/lib/aws-sdk-connect/types.rb

@@ -23,6 +23,59 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Information about the [contact][1] associated to the user.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_Contact.html
+    #
+    # @!attribute [rw] contact_id
+    #   The identifier of the contact in this instance of Amazon Connect.
+    #   @return [String]
+    #
+    # @!attribute [rw] channel
+    #   The channel of the contact.
+    #   @return [String]
+    #
+    # @!attribute [rw] initiation_method
+    #   How the contact was initiated.
+    #   @return [String]
+    #
+    # @!attribute [rw] agent_contact_state
+    #   The [state of the contact][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/about-contact-states.html
+    #   @return [String]
+    #
+    # @!attribute [rw] state_start_timestamp
+    #   The epoch timestamp when the contact state started.
+    #   @return [Time]
+    #
+    # @!attribute [rw] connected_to_agent_timestamp
+    #   The time at which the contact was connected to an agent.
+    #   @return [Time]
+    #
+    # @!attribute [rw] queue
+    #   Contains information about a queue resource for which metrics are
+    #   returned.
+    #   @return [Types::QueueReference]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/AgentContactReference AWS API Documentation
+    #
+    class AgentContactReference < Struct.new(
+      :contact_id,
+      :channel,
+      :initiation_method,
+      :agent_contact_state,
+      :state_start_timestamp,
+      :connected_to_agent_timestamp,
+      :queue)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Information about the agent who accepted the contact.
     #
     # @!attribute [rw] id
@@ -92,6 +145,25 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Information about the agent's status.
+    #
+    # @!attribute [rw] status_start_timestamp
+    #   The start timestamp of the agent's status.
+    #   @return [Time]
+    #
+    # @!attribute [rw] status_arn
+    #   The Amazon Resource Name (ARN) of the agent's status.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/AgentStatusReference AWS API Documentation
+    #
+    class AgentStatusReference < Struct.new(
+      :status_start_timestamp,
+      :status_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Summary information for an agent status.
     #
     # @!attribute [rw] id
@@ -862,6 +934,36 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Filters user data based on the contact information that is associated
+    # to the users. It contains a list of [contact states][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/about-contact-states.html
+    #
+    # @note When making an API call, you may pass ContactFilter
+    #   data as a hash:
+    #
+    #       {
+    #         contact_states: ["INCOMING"], # accepts INCOMING, PENDING, CONNECTING, CONNECTED, CONNECTED_ONHOLD, MISSED, ERROR, ENDED, REJECTED
+    #       }
+    #
+    # @!attribute [rw] contact_states
+    #   A list of up to 9 [contact states][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/about-contact-states.html
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ContactFilter AWS API Documentation
+    #
+    class ContactFilter < Struct.new(
+      :contact_states)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains information about a contact flow.
     #
     # @!attribute [rw] arn
@@ -4149,6 +4251,71 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetCurrentUserDataRequest
+    #   data as a hash:
+    #
+    #       {
+    #         instance_id: "InstanceId", # required
+    #         filters: { # required
+    #           queues: ["QueueId"],
+    #           contact_filter: {
+    #             contact_states: ["INCOMING"], # accepts INCOMING, PENDING, CONNECTING, CONNECTED, CONNECTED_ONHOLD, MISSED, ERROR, ENDED, REJECTED
+    #           },
+    #         },
+    #         next_token: "NextToken",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] instance_id
+    #   The identifier of the Amazon Connect instance. You can find the
+    #   instanceId in the ARN of the instance.
+    #   @return [String]
+    #
+    # @!attribute [rw] filters
+    #   Filters up to 100 `Queues`, or up to 9 `ContactStates`. The user
+    #   data is retrieved only for those users who are associated with the
+    #   queues and have contacts that are in the specified `ContactState`.
+    #   @return [Types::UserDataFilters]
+    #
+    # @!attribute [rw] next_token
+    #   The token for the next set of results. Use the value returned in the
+    #   previous response in the next request to retrieve the next set of
+    #   results.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return per page.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetCurrentUserDataRequest AWS API Documentation
+    #
+    class GetCurrentUserDataRequest < Struct.new(
+      :instance_id,
+      :filters,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] next_token
+    #   If there are additional results, this is the token for the next set
+    #   of results.
+    #   @return [String]
+    #
+    # @!attribute [rw] user_data_list
+    #   A list of the user data that is returned.
+    #   @return [Array<Types::UserData>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetCurrentUserDataResponse AWS API Documentation
+    #
+    class GetCurrentUserDataResponse < Struct.new(
+      :next_token,
+      :user_data_list)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetFederationTokenRequest
     #   data as a hash:
     #
@@ -4682,6 +4849,25 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Information about the hierarchy group.
+    #
+    # @!attribute [rw] id
+    #   The unique identifier for the hierarchy group.
+    #   @return [String]
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) for the hierarchy group.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/HierarchyGroupSummaryReference AWS API Documentation
+    #
+    class HierarchyGroupSummaryReference < Struct.new(
+      :id,
+      :arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains information about a hierarchy level.
     #
     # @!attribute [rw] id
@@ -4762,6 +4948,40 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Information about the levels in the hierarchy group.
+    #
+    # @!attribute [rw] level_one
+    #   Information about level one.
+    #   @return [Types::HierarchyGroupSummaryReference]
+    #
+    # @!attribute [rw] level_two
+    #   Information about level two.
+    #   @return [Types::HierarchyGroupSummaryReference]
+    #
+    # @!attribute [rw] level_three
+    #   Information about level three.
+    #   @return [Types::HierarchyGroupSummaryReference]
+    #
+    # @!attribute [rw] level_four
+    #   Information about level four.
+    #   @return [Types::HierarchyGroupSummaryReference]
+    #
+    # @!attribute [rw] level_five
+    #   Information about level five.
+    #   @return [Types::HierarchyGroupSummaryReference]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/HierarchyPathReference AWS API Documentation
+    #
+    class HierarchyPathReference < Struct.new(
+      :level_one,
+      :level_two,
+      :level_three,
+      :level_four,
+      :level_five)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains information about a hierarchy structure.
     #
     # @!attribute [rw] level_one
@@ -8345,6 +8565,25 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Information about the routing profile assigned to the user.
+    #
+    # @!attribute [rw] id
+    #   The identifier of the routing profile.
+    #   @return [String]
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) of the routing profile.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/RoutingProfileReference AWS API Documentation
+    #
+    class RoutingProfileReference < Struct.new(
+      :id,
+      :arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains summary information about a routing profile.
     #
     # @!attribute [rw] id
@@ -9758,7 +9997,7 @@ module Aws::Connect
     #   @return [String]
     #
     # @!attribute [rw] contact_id
-    #   The identifier of the contact in this instance of Amazon Connect
+    #   The identifier of the contact in this instance of Amazon Connect.
     #   @return [String]
     #
     # @!attribute [rw] queue_id
@@ -9795,7 +10034,7 @@ module Aws::Connect
     end
 
     # @!attribute [rw] contact_id
-    #   The identifier of the contact in this instance of Amazon Connect
+    #   The identifier of the contact in this instance of Amazon Connect.
     #   @return [String]
     #
     # @!attribute [rw] contact_arn
@@ -11429,6 +11668,99 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Data for a user.
+    #
+    # @!attribute [rw] user
+    #   Information about the user for the data that is returned. It
+    #   contains resourceId and ARN of the user.
+    #   @return [Types::UserReference]
+    #
+    # @!attribute [rw] routing_profile
+    #   Information about the routing profile that is assigned to the user.
+    #   @return [Types::RoutingProfileReference]
+    #
+    # @!attribute [rw] hierarchy_path
+    #   Contains information about the levels of a hierarchy group assigned
+    #   to a user.
+    #   @return [Types::HierarchyPathReference]
+    #
+    # @!attribute [rw] status
+    #   The status of the agent that they manually set in their Contact
+    #   Control Panel (CCP), or that the supervisor manually changes in the
+    #   real-time metrics report.
+    #   @return [Types::AgentStatusReference]
+    #
+    # @!attribute [rw] available_slots_by_channel
+    #   A map of available slots by channel. The key is a channel name. The
+    #   value is an integer: the available number of slots.
+    #   @return [Hash<String,Integer>]
+    #
+    # @!attribute [rw] max_slots_by_channel
+    #   A map of maximum slots by channel. The key is a channel name. The
+    #   value is an integer: the maximum number of slots. This is calculated
+    #   from [MediaConcurrency][1] of the RoutingProfile assigned to the
+    #   agent.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_MediaConcurrency.html
+    #   @return [Hash<String,Integer>]
+    #
+    # @!attribute [rw] active_slots_by_channel
+    #   A map of active slots by channel. The key is a channel name. The
+    #   value is an integer: the number of active slots.
+    #   @return [Hash<String,Integer>]
+    #
+    # @!attribute [rw] contacts
+    #   A list of contact reference information.
+    #   @return [Array<Types::AgentContactReference>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UserData AWS API Documentation
+    #
+    class UserData < Struct.new(
+      :user,
+      :routing_profile,
+      :hierarchy_path,
+      :status,
+      :available_slots_by_channel,
+      :max_slots_by_channel,
+      :active_slots_by_channel,
+      :contacts)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A filter for the user data.
+    #
+    # @note When making an API call, you may pass UserDataFilters
+    #   data as a hash:
+    #
+    #       {
+    #         queues: ["QueueId"],
+    #         contact_filter: {
+    #           contact_states: ["INCOMING"], # accepts INCOMING, PENDING, CONNECTING, CONNECTED, CONNECTED_ONHOLD, MISSED, ERROR, ENDED, REJECTED
+    #         },
+    #       }
+    #
+    # @!attribute [rw] queues
+    #   Contains information about a queue resource for which metrics are
+    #   returned.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] contact_filter
+    #   A filter for the user data based on the contact information that is
+    #   associated to the user. It contains a list of contact states.
+    #   @return [Types::ContactFilter]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UserDataFilters AWS API Documentation
+    #
+    class UserDataFilters < Struct.new(
+      :queues,
+      :contact_filter)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains information about the identity of a user.
     #
     # @note When making an API call, you may pass UserIdentityInfo
@@ -11566,6 +11898,25 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Information about the user.
+    #
+    # @!attribute [rw] id
+    #   The unique identifier for the user.
+    #   @return [String]
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) for the user.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UserReference AWS API Documentation
+    #
+    class UserReference < Struct.new(
+      :id,
+      :arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The search criteria to be used to return users.
     #
     # @note When making an API call, you may pass UserSearchCriteria

data/lib/aws-sdk-connect.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-connect/customizations'
 # @!group service
 module Aws::Connect
 
-  GEM_VERSION = '1.72.0'
+  GEM_VERSION = '1.73.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-connect
 version: !ruby/object:Gem::Version
-  version: 1.72.0
+  version: 1.73.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-02 00:00:00.000000000 Z
+date: 2022-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core