aws-sdk-connect 1.68.0 → 1.71.0

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

@@ -382,6 +382,38 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass AssociatePhoneNumberContactFlowRequest
+    #   data as a hash:
+    #
+    #       {
+    #         phone_number_id: "PhoneNumberId", # required
+    #         instance_id: "InstanceId", # required
+    #         contact_flow_id: "ContactFlowId", # required
+    #       }
+    #
+    # @!attribute [rw] phone_number_id
+    #   A unique identifier for the phone number.
+    #   @return [String]
+    #
+    # @!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] contact_flow_id
+    #   The identifier of the contact flow.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/AssociatePhoneNumberContactFlowRequest AWS API Documentation
+    #
+    class AssociatePhoneNumberContactFlowRequest < Struct.new(
+      :phone_number_id,
+      :instance_id,
+      :contact_flow_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass AssociateQueueQuickConnectsRequest
     #   data as a hash:
     #
@@ -538,6 +570,31 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # Information about available phone numbers.
+    #
+    # @!attribute [rw] phone_number
+    #   The phone number. Phone numbers are formatted `[+] [country code]
+    #   [subscriber number including area code]`.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_country_code
+    #   The ISO country code.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_type
+    #   The type of phone number.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/AvailableNumberSummary AWS API Documentation
+    #
+    class AvailableNumberSummary < Struct.new(
+      :phone_number,
+      :phone_number_country_code,
+      :phone_number_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A chat message.
     #
     # @note When making an API call, you may pass ChatMessage
@@ -589,6 +646,133 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ClaimPhoneNumberRequest
+    #   data as a hash:
+    #
+    #       {
+    #         target_arn: "ARN", # required
+    #         phone_number: "PhoneNumber", # required
+    #         phone_number_description: "PhoneNumberDescription",
+    #         tags: {
+    #           "TagKey" => "TagValue",
+    #         },
+    #         client_token: "ClientToken",
+    #       }
+    #
+    # @!attribute [rw] target_arn
+    #   The Amazon Resource Name (ARN) for Amazon Connect instances that
+    #   phone numbers are claimed to.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number
+    #   The phone number you want to claim. Phone numbers are formatted `[+]
+    #   [country code] [subscriber number including area code]`.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_description
+    #   The description of the phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] tags
+    #   The tags used to organize, track, or control access for this
+    #   resource.
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] client_token
+    #   A unique, case-sensitive identifier that you provide to ensure the
+    #   idempotency of the request.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ClaimPhoneNumberRequest AWS API Documentation
+    #
+    class ClaimPhoneNumberRequest < Struct.new(
+      :target_arn,
+      :phone_number,
+      :phone_number_description,
+      :tags,
+      :client_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] phone_number_id
+    #   A unique identifier for the phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_arn
+    #   The Amazon Resource Name (ARN) of the phone number.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ClaimPhoneNumberResponse AWS API Documentation
+    #
+    class ClaimPhoneNumberResponse < Struct.new(
+      :phone_number_id,
+      :phone_number_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Information about a phone number that has been claimed to your Amazon
+    # Connect instance.
+    #
+    # @!attribute [rw] phone_number_id
+    #   A unique identifier for the phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_arn
+    #   The Amazon Resource Name (ARN) of the phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number
+    #   The phone number. Phone numbers are formatted `[+] [country code]
+    #   [subscriber number including area code]`.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_country_code
+    #   The ISO country code.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_type
+    #   The type of phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_description
+    #   The description of the phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] target_arn
+    #   The Amazon Resource Name (ARN) for Amazon Connect instances that
+    #   phone numbers are claimed to.
+    #   @return [String]
+    #
+    # @!attribute [rw] tags
+    #   The tags used to organize, track, or control access for this
+    #   resource.
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] phone_number_status
+    #   The status of the phone number.
+    #   @return [Types::PhoneNumberStatus]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ClaimedPhoneNumberSummary AWS API Documentation
+    #
+    class ClaimedPhoneNumberSummary < Struct.new(
+      :phone_number_id,
+      :phone_number_arn,
+      :phone_number,
+      :phone_number_country_code,
+      :phone_number_type,
+      :phone_number_description,
+      :target_arn,
+      :tags,
+      :phone_number_status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains information about a contact.
     #
     # @!attribute [rw] arn
@@ -880,6 +1064,64 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # An object that can be used to specify Tag conditions inside the
+    # `SearchFilter`. This accepts an `OR` of `AND` (List of List) input
+    # where:
+    #
+    # * Top level list specifies conditions that need to be applied with
+    #   `OR` operator
+    #
+    # * Inner list specifies conditions that need to be applied with `AND`
+    #   operator.
+    #
+    # @note When making an API call, you may pass ControlPlaneTagFilter
+    #   data as a hash:
+    #
+    #       {
+    #         or_conditions: [
+    #           [
+    #             {
+    #               tag_key: "String",
+    #               tag_value: "String",
+    #             },
+    #           ],
+    #         ],
+    #         and_conditions: [
+    #           {
+    #             tag_key: "String",
+    #             tag_value: "String",
+    #           },
+    #         ],
+    #         tag_condition: {
+    #           tag_key: "String",
+    #           tag_value: "String",
+    #         },
+    #       }
+    #
+    # @!attribute [rw] or_conditions
+    #   A list of conditions which would be applied together with an `OR`
+    #   condition.
+    #   @return [Array<Array<Types::TagCondition>>]
+    #
+    # @!attribute [rw] and_conditions
+    #   A list of conditions which would be applied together with an `AND`
+    #   condition.
+    #   @return [Array<Types::TagCondition>]
+    #
+    # @!attribute [rw] tag_condition
+    #   A leaf node condition which can be used to specify a tag condition.
+    #   @return [Types::TagCondition]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ControlPlaneTagFilter AWS API Documentation
+    #
+    class ControlPlaneTagFilter < Struct.new(
+      :or_conditions,
+      :and_conditions,
+      :tag_condition)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass CreateAgentStatusRequest
     #   data as a hash:
     #
@@ -2736,6 +2978,38 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribePhoneNumberRequest
+    #   data as a hash:
+    #
+    #       {
+    #         phone_number_id: "PhoneNumberId", # required
+    #       }
+    #
+    # @!attribute [rw] phone_number_id
+    #   A unique identifier for the phone number.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DescribePhoneNumberRequest AWS API Documentation
+    #
+    class DescribePhoneNumberRequest < Struct.new(
+      :phone_number_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] claimed_phone_number_summary
+    #   Information about a phone number that's been claimed to your Amazon
+    #   Connect instance.
+    #   @return [Types::ClaimedPhoneNumberSummary]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DescribePhoneNumberResponse AWS API Documentation
+    #
+    class DescribePhoneNumberResponse < Struct.new(
+      :claimed_phone_number_summary)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeQueueRequest
     #   data as a hash:
     #
@@ -3225,6 +3499,32 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DisassociatePhoneNumberContactFlowRequest
+    #   data as a hash:
+    #
+    #       {
+    #         phone_number_id: "PhoneNumberId", # required
+    #         instance_id: "InstanceId", # required
+    #       }
+    #
+    # @!attribute [rw] phone_number_id
+    #   A unique identifier for the phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] instance_id
+    #   The identifier of the Amazon Connect instance. You can find the
+    #   instanceId in the ARN of the instance.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DisassociatePhoneNumberContactFlowRequest AWS API Documentation
+    #
+    class DisassociatePhoneNumberContactFlowRequest < Struct.new(
+      :phone_number_id,
+      :instance_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DisassociateQueueQuickConnectsRequest
     #   data as a hash:
     #
@@ -4014,6 +4314,34 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # A leaf node condition which can be used to specify a hierarchy group
+    # condition.
+    #
+    # @note When making an API call, you may pass HierarchyGroupCondition
+    #   data as a hash:
+    #
+    #       {
+    #         value: "String",
+    #         hierarchy_group_match_type: "EXACT", # accepts EXACT, WITH_CHILD_GROUPS
+    #       }
+    #
+    # @!attribute [rw] value
+    #   The value in the hierarchy group condition.
+    #   @return [String]
+    #
+    # @!attribute [rw] hierarchy_group_match_type
+    #   The type of hierarchy group match.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/HierarchyGroupCondition AWS API Documentation
+    #
+    class HierarchyGroupCondition < Struct.new(
+      :value,
+      :hierarchy_group_match_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains summary information about a hierarchy group.
     #
     # @!attribute [rw] id
@@ -5771,68 +6099,184 @@ module Aws::Connect
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass ListPromptsRequest
-    #   data as a hash:
-    #
-    #       {
-    #         instance_id: "InstanceId", # required
-    #         next_token: "NextToken",
-    #         max_results: 1,
-    #       }
+    # Information about phone numbers that have been claimed to your Amazon
+    # Connect instance.
     #
-    # @!attribute [rw] instance_id
-    #   The identifier of the Amazon Connect instance.
+    # @!attribute [rw] phone_number_id
+    #   A unique identifier for the phone number.
     #   @return [String]
     #
-    # @!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.
+    # @!attribute [rw] phone_number_arn
+    #   The Amazon Resource Name (ARN) of the phone number.
     #   @return [String]
     #
-    # @!attribute [rw] max_results
-    #   The maximum number of results to return per page.
-    #   @return [Integer]
+    # @!attribute [rw] phone_number
+    #   The phone number. Phone numbers are formatted `[+] [country code]
+    #   [subscriber number including area code]`.
+    #   @return [String]
     #
-    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListPromptsRequest AWS API Documentation
+    # @!attribute [rw] phone_number_country_code
+    #   The ISO country code.
+    #   @return [String]
     #
-    class ListPromptsRequest < Struct.new(
-      :instance_id,
-      :next_token,
-      :max_results)
-      SENSITIVE = []
-      include Aws::Structure
-    end
-
-    # @!attribute [rw] prompt_summary_list
-    #   Information about the prompts.
-    #   @return [Array<Types::PromptSummary>]
+    # @!attribute [rw] phone_number_type
+    #   The type of phone number.
+    #   @return [String]
     #
-    # @!attribute [rw] next_token
-    #   If there are additional results, this is the token for the next set
-    #   of results.
+    # @!attribute [rw] target_arn
+    #   The Amazon Resource Name (ARN) for Amazon Connect instances that
+    #   phone numbers are claimed to.
     #   @return [String]
     #
-    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListPromptsResponse AWS API Documentation
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListPhoneNumbersSummary AWS API Documentation
     #
-    class ListPromptsResponse < Struct.new(
-      :prompt_summary_list,
-      :next_token)
+    class ListPhoneNumbersSummary < Struct.new(
+      :phone_number_id,
+      :phone_number_arn,
+      :phone_number,
+      :phone_number_country_code,
+      :phone_number_type,
+      :target_arn)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass ListQueueQuickConnectsRequest
+    # @note When making an API call, you may pass ListPhoneNumbersV2Request
     #   data as a hash:
     #
     #       {
-    #         instance_id: "InstanceId", # required
-    #         queue_id: "QueueId", # required
-    #         next_token: "NextToken",
+    #         target_arn: "ARN",
     #         max_results: 1,
+    #         next_token: "LargeNextToken",
+    #         phone_number_country_codes: ["AF"], # accepts AF, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BA, BW, BR, IO, VG, BN, BG, BF, BI, KH, CM, CA, CV, KY, CF, TD, CL, CN, CX, CC, CO, KM, CK, CR, HR, CU, CW, CY, CZ, CD, DK, DJ, DM, DO, TL, EC, EG, SV, GQ, ER, EE, ET, FK, FO, FJ, FI, FR, PF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GU, GT, GG, GN, GW, GY, HT, HN, HK, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, CI, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MK, MG, MW, MY, MV, ML, MT, MH, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, AN, NC, NZ, NI, NE, NG, NU, KP, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, CG, RE, RO, RU, RW, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, KR, ES, LK, SD, SR, SJ, SZ, SE, CH, SY, TW, TJ, TZ, TH, TG, TK, TO, TT, TN, TR, TM, TC, TV, VI, UG, UA, AE, GB, US, UY, UZ, VU, VA, VE, VN, WF, EH, YE, ZM, ZW
+    #         phone_number_types: ["TOLL_FREE"], # accepts TOLL_FREE, DID
+    #         phone_number_prefix: "PhoneNumberPrefix",
     #       }
     #
-    # @!attribute [rw] instance_id
+    # @!attribute [rw] target_arn
+    #   The Amazon Resource Name (ARN) for Amazon Connect instances that
+    #   phone numbers are claimed to. If `TargetArn` input is not provided,
+    #   this API lists numbers claimed to all the Amazon Connect instances
+    #   belonging to your account.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return per page.
+    #   @return [Integer]
+    #
+    # @!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] phone_number_country_codes
+    #   The ISO country code.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] phone_number_types
+    #   The type of phone number.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] phone_number_prefix
+    #   The prefix of the phone number. If provided, it must contain `+` as
+    #   part of the country code.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListPhoneNumbersV2Request AWS API Documentation
+    #
+    class ListPhoneNumbersV2Request < Struct.new(
+      :target_arn,
+      :max_results,
+      :next_token,
+      :phone_number_country_codes,
+      :phone_number_types,
+      :phone_number_prefix)
+      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] list_phone_numbers_summary_list
+    #   Information about phone numbers that have been claimed to your
+    #   Amazon Connect instances.
+    #   @return [Array<Types::ListPhoneNumbersSummary>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListPhoneNumbersV2Response AWS API Documentation
+    #
+    class ListPhoneNumbersV2Response < Struct.new(
+      :next_token,
+      :list_phone_numbers_summary_list)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass ListPromptsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         instance_id: "InstanceId", # required
+    #         next_token: "NextToken",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] instance_id
+    #   The identifier of the Amazon Connect instance.
+    #   @return [String]
+    #
+    # @!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/ListPromptsRequest AWS API Documentation
+    #
+    class ListPromptsRequest < Struct.new(
+      :instance_id,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] prompt_summary_list
+    #   Information about the prompts.
+    #   @return [Array<Types::PromptSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   If there are additional results, this is the token for the next set
+    #   of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListPromptsResponse AWS API Documentation
+    #
+    class ListPromptsResponse < Struct.new(
+      :prompt_summary_list,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass ListQueueQuickConnectsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         instance_id: "InstanceId", # required
+    #         queue_id: "QueueId", # required
+    #         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]
@@ -6592,6 +7036,25 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # The status of the phone number.
+    #
+    # @!attribute [rw] status
+    #   The status.
+    #   @return [String]
+    #
+    # @!attribute [rw] message
+    #   The status message.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/PhoneNumberStatus AWS API Documentation
+    #
+    class PhoneNumberStatus < Struct.new(
+      :status,
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains summary information about a phone number for a contact
     # center.
     #
@@ -6665,6 +7128,42 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass PutUserStatusRequest
+    #   data as a hash:
+    #
+    #       {
+    #         user_id: "UserId", # required
+    #         instance_id: "InstanceId", # required
+    #         agent_status_id: "AgentStatusId", # required
+    #       }
+    #
+    # @!attribute [rw] user_id
+    #   The identifier of the user.
+    #   @return [String]
+    #
+    # @!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] agent_status_id
+    #   The identifier of the agent status.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/PutUserStatusRequest AWS API Documentation
+    #
+    class PutUserStatusRequest < Struct.new(
+      :user_id,
+      :instance_id,
+      :agent_status_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/PutUserStatusResponse AWS API Documentation
+    #
+    class PutUserStatusResponse < Aws::EmptyStructure; end
+
     # Contains information about a queue.
     #
     # @!attribute [rw] name
@@ -7004,6 +7503,35 @@ module Aws::Connect
       class Unknown < ReferenceSummary; end
     end
 
+    # @note When making an API call, you may pass ReleasePhoneNumberRequest
+    #   data as a hash:
+    #
+    #       {
+    #         phone_number_id: "PhoneNumberId", # required
+    #         client_token: "ClientToken",
+    #       }
+    #
+    # @!attribute [rw] phone_number_id
+    #   A unique identifier for the phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] client_token
+    #   A unique, case-sensitive identifier that you provide to ensure the
+    #   idempotency of the request.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ReleasePhoneNumberRequest AWS API Documentation
+    #
+    class ReleasePhoneNumberRequest < Struct.new(
+      :phone_number_id,
+      :client_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A resource already has that name.
     #
     # @!attribute [rw] message
@@ -7331,6 +7859,188 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass SearchAvailablePhoneNumbersRequest
+    #   data as a hash:
+    #
+    #       {
+    #         target_arn: "ARN", # required
+    #         phone_number_country_code: "AF", # required, accepts AF, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BA, BW, BR, IO, VG, BN, BG, BF, BI, KH, CM, CA, CV, KY, CF, TD, CL, CN, CX, CC, CO, KM, CK, CR, HR, CU, CW, CY, CZ, CD, DK, DJ, DM, DO, TL, EC, EG, SV, GQ, ER, EE, ET, FK, FO, FJ, FI, FR, PF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GU, GT, GG, GN, GW, GY, HT, HN, HK, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, CI, JM, JP, JE, JO, KZ, KE, KI, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MK, MG, MW, MY, MV, ML, MT, MH, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, AN, NC, NZ, NI, NE, NG, NU, KP, MP, NO, OM, PK, PW, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, CG, RE, RO, RU, RW, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, KR, ES, LK, SD, SR, SJ, SZ, SE, CH, SY, TW, TJ, TZ, TH, TG, TK, TO, TT, TN, TR, TM, TC, TV, VI, UG, UA, AE, GB, US, UY, UZ, VU, VA, VE, VN, WF, EH, YE, ZM, ZW
+    #         phone_number_type: "TOLL_FREE", # required, accepts TOLL_FREE, DID
+    #         phone_number_prefix: "PhoneNumberPrefix",
+    #         max_results: 1,
+    #         next_token: "LargeNextToken",
+    #       }
+    #
+    # @!attribute [rw] target_arn
+    #   The Amazon Resource Name (ARN) for Amazon Connect instances that
+    #   phone numbers are claimed to.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_country_code
+    #   The ISO country code.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_type
+    #   The type of phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_prefix
+    #   The prefix of the phone number. If provided, it must contain `+` as
+    #   part of the country code.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return per page.
+    #   @return [Integer]
+    #
+    # @!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]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SearchAvailablePhoneNumbersRequest AWS API Documentation
+    #
+    class SearchAvailablePhoneNumbersRequest < Struct.new(
+      :target_arn,
+      :phone_number_country_code,
+      :phone_number_type,
+      :phone_number_prefix,
+      :max_results,
+      :next_token)
+      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] available_numbers_list
+    #   A list of available phone numbers that you can claim for your Amazon
+    #   Connect instance.
+    #   @return [Array<Types::AvailableNumberSummary>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SearchAvailablePhoneNumbersResponse AWS API Documentation
+    #
+    class SearchAvailablePhoneNumbersResponse < Struct.new(
+      :next_token,
+      :available_numbers_list)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass SearchUsersRequest
+    #   data as a hash:
+    #
+    #       {
+    #         instance_id: "InstanceId",
+    #         next_token: "NextToken2500",
+    #         max_results: 1,
+    #         search_filter: {
+    #           tag_filter: {
+    #             or_conditions: [
+    #               [
+    #                 {
+    #                   tag_key: "String",
+    #                   tag_value: "String",
+    #                 },
+    #               ],
+    #             ],
+    #             and_conditions: [
+    #               {
+    #                 tag_key: "String",
+    #                 tag_value: "String",
+    #               },
+    #             ],
+    #             tag_condition: {
+    #               tag_key: "String",
+    #               tag_value: "String",
+    #             },
+    #           },
+    #         },
+    #         search_criteria: {
+    #           or_conditions: [
+    #             {
+    #               # recursive UserSearchCriteria
+    #             },
+    #           ],
+    #           and_conditions: [
+    #             {
+    #               # recursive UserSearchCriteria
+    #             },
+    #           ],
+    #           string_condition: {
+    #             field_name: "String",
+    #             value: "String",
+    #             comparison_type: "STARTS_WITH", # accepts STARTS_WITH, CONTAINS, EXACT
+    #           },
+    #           hierarchy_group_condition: {
+    #             value: "String",
+    #             hierarchy_group_match_type: "EXACT", # accepts EXACT, WITH_CHILD_GROUPS
+    #           },
+    #         },
+    #       }
+    #
+    # @!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] 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]
+    #
+    # @!attribute [rw] search_filter
+    #   Filters to be applied to search results.
+    #   @return [Types::UserSearchFilter]
+    #
+    # @!attribute [rw] search_criteria
+    #   The search criteria to be used to return users.
+    #   @return [Types::UserSearchCriteria]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SearchUsersRequest AWS API Documentation
+    #
+    class SearchUsersRequest < Struct.new(
+      :instance_id,
+      :next_token,
+      :max_results,
+      :search_filter,
+      :search_criteria)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] users
+    #   Information about the users.
+    #   @return [Array<Types::UserSearchSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   If there are additional results, this is the token for the next set
+    #   of results.
+    #   @return [String]
+    #
+    # @!attribute [rw] approximate_total_count
+    #   The total number of users who matched your search query.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SearchUsersResponse AWS API Documentation
+    #
+    class SearchUsersResponse < Struct.new(
+      :users,
+      :next_token,
+      :approximate_total_count)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass SearchVocabulariesRequest
     #   data as a hash:
     #
@@ -8065,6 +8775,41 @@ module Aws::Connect
     #
     class StopContactStreamingResponse < Aws::EmptyStructure; end
 
+    # A leaf node condition which can be used to specify a string condition,
+    # for example, `username = 'abc'`.
+    #
+    # @note When making an API call, you may pass StringCondition
+    #   data as a hash:
+    #
+    #       {
+    #         field_name: "String",
+    #         value: "String",
+    #         comparison_type: "STARTS_WITH", # accepts STARTS_WITH, CONTAINS, EXACT
+    #       }
+    #
+    # @!attribute [rw] field_name
+    #   The name of the field in the string condition.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   The value of the string.
+    #   @return [String]
+    #
+    # @!attribute [rw] comparison_type
+    #   The type of comparison to be made when evaluating the string
+    #   condition.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/StringCondition AWS API Documentation
+    #
+    class StringCondition < Struct.new(
+      :field_name,
+      :value,
+      :comparison_type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass SuspendContactRecordingRequest
     #   data as a hash:
     #
@@ -8102,6 +8847,34 @@ module Aws::Connect
     #
     class SuspendContactRecordingResponse < Aws::EmptyStructure; end
 
+    # A leaf node condition which can be used to specify a tag condition,
+    # for example, `HAVE BPO = 123`.
+    #
+    # @note When making an API call, you may pass TagCondition
+    #   data as a hash:
+    #
+    #       {
+    #         tag_key: "String",
+    #         tag_value: "String",
+    #       }
+    #
+    # @!attribute [rw] tag_key
+    #   The tag key in the tag condition.
+    #   @return [String]
+    #
+    # @!attribute [rw] tag_value
+    #   The tag value in the tag condition.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/TagCondition AWS API Documentation
+    #
+    class TagCondition < Struct.new(
+      :tag_key,
+      :tag_value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass TagResourceRequest
     #   data as a hash:
     #
@@ -8755,6 +9528,59 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass UpdatePhoneNumberRequest
+    #   data as a hash:
+    #
+    #       {
+    #         phone_number_id: "PhoneNumberId", # required
+    #         target_arn: "ARN", # required
+    #         client_token: "ClientToken",
+    #       }
+    #
+    # @!attribute [rw] phone_number_id
+    #   A unique identifier for the phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] target_arn
+    #   The Amazon Resource Name (ARN) for Amazon Connect instances that
+    #   phone numbers are claimed to.
+    #   @return [String]
+    #
+    # @!attribute [rw] client_token
+    #   A unique, case-sensitive identifier that you provide to ensure the
+    #   idempotency of the request.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdatePhoneNumberRequest AWS API Documentation
+    #
+    class UpdatePhoneNumberRequest < Struct.new(
+      :phone_number_id,
+      :target_arn,
+      :client_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] phone_number_id
+    #   A unique identifier for the phone number.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number_arn
+    #   The Amazon Resource Name (ARN) of the phone number.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdatePhoneNumberResponse AWS API Documentation
+    #
+    class UpdatePhoneNumberResponse < Struct.new(
+      :phone_number_id,
+      :phone_number_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass UpdateQueueHoursOfOperationRequest
     #   data as a hash:
     #
@@ -9586,6 +10412,25 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # The user's first name and last name.
+    #
+    # @!attribute [rw] first_name
+    #   The user's first name.
+    #   @return [String]
+    #
+    # @!attribute [rw] last_name
+    #   The user's last name.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UserIdentityInfoLite AWS API Documentation
+    #
+    class UserIdentityInfoLite < Struct.new(
+      :first_name,
+      :last_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # No user with the specified credentials was found in the Amazon Connect
     # instance.
     #
@@ -9668,6 +10513,201 @@ module Aws::Connect
       include Aws::Structure
     end
 
+    # The search criteria to be used to return users.
+    #
+    # @note When making an API call, you may pass UserSearchCriteria
+    #   data as a hash:
+    #
+    #       {
+    #         or_conditions: [
+    #           {
+    #             or_conditions: {
+    #               # recursive UserSearchConditionList
+    #             },
+    #             and_conditions: {
+    #               # recursive UserSearchConditionList
+    #             },
+    #             string_condition: {
+    #               field_name: "String",
+    #               value: "String",
+    #               comparison_type: "STARTS_WITH", # accepts STARTS_WITH, CONTAINS, EXACT
+    #             },
+    #             hierarchy_group_condition: {
+    #               value: "String",
+    #               hierarchy_group_match_type: "EXACT", # accepts EXACT, WITH_CHILD_GROUPS
+    #             },
+    #           },
+    #         ],
+    #         and_conditions: [
+    #           {
+    #             or_conditions: {
+    #               # recursive UserSearchConditionList
+    #             },
+    #             and_conditions: {
+    #               # recursive UserSearchConditionList
+    #             },
+    #             string_condition: {
+    #               field_name: "String",
+    #               value: "String",
+    #               comparison_type: "STARTS_WITH", # accepts STARTS_WITH, CONTAINS, EXACT
+    #             },
+    #             hierarchy_group_condition: {
+    #               value: "String",
+    #               hierarchy_group_match_type: "EXACT", # accepts EXACT, WITH_CHILD_GROUPS
+    #             },
+    #           },
+    #         ],
+    #         string_condition: {
+    #           field_name: "String",
+    #           value: "String",
+    #           comparison_type: "STARTS_WITH", # accepts STARTS_WITH, CONTAINS, EXACT
+    #         },
+    #         hierarchy_group_condition: {
+    #           value: "String",
+    #           hierarchy_group_match_type: "EXACT", # accepts EXACT, WITH_CHILD_GROUPS
+    #         },
+    #       }
+    #
+    # @!attribute [rw] or_conditions
+    #   A list of conditions which would be applied together with an `OR`
+    #   condition.
+    #   @return [Array<Types::UserSearchCriteria>]
+    #
+    # @!attribute [rw] and_conditions
+    #   A list of conditions which would be applied together with an `AND`
+    #   condition.
+    #   @return [Array<Types::UserSearchCriteria>]
+    #
+    # @!attribute [rw] string_condition
+    #   A leaf node condition which can be used to specify a string
+    #   condition.
+    #   @return [Types::StringCondition]
+    #
+    # @!attribute [rw] hierarchy_group_condition
+    #   A leaf node condition which can be used to specify a hierarchy group
+    #   condition.
+    #   @return [Types::HierarchyGroupCondition]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UserSearchCriteria AWS API Documentation
+    #
+    class UserSearchCriteria < Struct.new(
+      :or_conditions,
+      :and_conditions,
+      :string_condition,
+      :hierarchy_group_condition)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Filters to be applied to search results.
+    #
+    # @note When making an API call, you may pass UserSearchFilter
+    #   data as a hash:
+    #
+    #       {
+    #         tag_filter: {
+    #           or_conditions: [
+    #             [
+    #               {
+    #                 tag_key: "String",
+    #                 tag_value: "String",
+    #               },
+    #             ],
+    #           ],
+    #           and_conditions: [
+    #             {
+    #               tag_key: "String",
+    #               tag_value: "String",
+    #             },
+    #           ],
+    #           tag_condition: {
+    #             tag_key: "String",
+    #             tag_value: "String",
+    #           },
+    #         },
+    #       }
+    #
+    # @!attribute [rw] tag_filter
+    #   An object that can be used to specify Tag conditions inside the
+    #   `SearchFilter`. This accepts an `OR` of `AND` (List of List) input
+    #   where:
+    #
+    #   * Top level list specifies conditions that need to be applied with
+    #     `OR` operator
+    #
+    #   * Inner list specifies conditions that need to be applied with `AND`
+    #     operator.
+    #   @return [Types::ControlPlaneTagFilter]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UserSearchFilter AWS API Documentation
+    #
+    class UserSearchFilter < Struct.new(
+      :tag_filter)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Information about the returned users.
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) of the user.
+    #   @return [String]
+    #
+    # @!attribute [rw] directory_user_id
+    #   The directory identifier of the user.
+    #   @return [String]
+    #
+    # @!attribute [rw] hierarchy_group_id
+    #   The identifier of the user's hierarchy group.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   The identifier of the user's summary.
+    #   @return [String]
+    #
+    # @!attribute [rw] identity_info
+    #   The user's first name and last name.
+    #   @return [Types::UserIdentityInfoLite]
+    #
+    # @!attribute [rw] phone_config
+    #   Contains information about the phone configuration settings for a
+    #   user.
+    #   @return [Types::UserPhoneConfig]
+    #
+    # @!attribute [rw] routing_profile_id
+    #   The identifier of the user's routing profile.
+    #   @return [String]
+    #
+    # @!attribute [rw] security_profile_ids
+    #   The identifiers of the user's security profiles.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] tags
+    #   The tags used to organize, track, or control access for this
+    #   resource.
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] username
+    #   The name of the user.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UserSearchSummary AWS API Documentation
+    #
+    class UserSearchSummary < Struct.new(
+      :arn,
+      :directory_user_id,
+      :hierarchy_group_id,
+      :id,
+      :identity_info,
+      :phone_config,
+      :routing_profile_id,
+      :security_profile_ids,
+      :tags,
+      :username)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains summary information about a user.
     #
     # @!attribute [rw] id