aws-sdk-connect 1.67.0 → 1.70.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: fe5fe6fc3975de22364cd0e1c90e727851634c881bf615bc5430ca5802e84493
4
- data.tar.gz: 8cf499683773b2e21b03e7ebc3bc829d004f42e739ba4cd2a8ad6b4bd1ee3d32
3
+ metadata.gz: 665620a6399d6a10c27d60fd8a285be1b72a3d79b6b74ca03dbd6fa4a1b5299b
4
+ data.tar.gz: c8661d83bbfd1c11c2d578e9ddc7893fd97237775a05bf670b6abfb71f86d3c3
5
5
  SHA512:
6
- metadata.gz: f7fde0574c2897e88e9b90b4c4f974f7f8ae2588de567c5f588672897b6a52b7ebe79539a44795ac1930b1631aecffa084944f63fb41a8653f71aa02f2104114
7
- data.tar.gz: ad171091580af25be6ff687a96bfadaffd0cd8518bb1339d7306121115fa343dd0570b8a2e919fda30d7933b52ccdc442818dddb1faef0d84d452c0821969f98
6
+ metadata.gz: df80e32e78d0c80a531a84962f1b430dd5801c5ea357c8c4f21e3d78a1bb61114467530fb995588a4ccf9e98399e0079798857c6efa6e3df63cd117d8ff9115f
7
+ data.tar.gz: 16f47eabd44d22e1d07fcec51e56756f12b889613963dd901e87d5c51fda7f23630deb55b7757cc2cf617c9b1fae32b84afac1481d9d8a8b0888c317e3e8c682
data/CHANGELOG.md CHANGED
@@ -1,6 +1,21 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.70.0 (2022-04-25)
5
+ ------------------
6
+
7
+ * Feature - This release adds SearchUsers API which can be used to search for users with a Connect Instance
8
+
9
+ 1.69.0 (2022-04-20)
10
+ ------------------
11
+
12
+ * Feature - This release adds APIs to search, claim, release, list, update, and describe phone numbers. You can also use them to associate and disassociate contact flows to phone numbers.
13
+
14
+ 1.68.0 (2022-04-01)
15
+ ------------------
16
+
17
+ * Feature - This release updates these APIs: UpdateInstanceAttribute, DescribeInstanceAttribute and ListInstanceAttributes. You can use it to programmatically enable/disable multi-party conferencing using attribute type MULTI_PARTY_CONFERENCING on the specified Amazon Connect instance.
18
+
4
19
  1.67.0 (2022-03-11)
5
20
  ------------------
6
21
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.67.0
1
+ 1.70.0
@@ -600,6 +600,38 @@ module Aws::Connect
600
600
  req.send_request(options)
601
601
  end
602
602
 
603
+ # Associates a contact flow with a phone number claimed to your Amazon
604
+ # Connect instance.
605
+ #
606
+ # @option params [required, String] :phone_number_id
607
+ # A unique identifier for the phone number.
608
+ #
609
+ # @option params [required, String] :instance_id
610
+ # The identifier of the Amazon Connect instance. You can find the
611
+ # instanceId in the ARN of the instance.
612
+ #
613
+ # @option params [required, String] :contact_flow_id
614
+ # The identifier of the contact flow.
615
+ #
616
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
617
+ #
618
+ # @example Request syntax with placeholder values
619
+ #
620
+ # resp = client.associate_phone_number_contact_flow({
621
+ # phone_number_id: "PhoneNumberId", # required
622
+ # instance_id: "InstanceId", # required
623
+ # contact_flow_id: "ContactFlowId", # required
624
+ # })
625
+ #
626
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/AssociatePhoneNumberContactFlow AWS API Documentation
627
+ #
628
+ # @overload associate_phone_number_contact_flow(params = {})
629
+ # @param [Hash] params ({})
630
+ def associate_phone_number_contact_flow(params = {}, options = {})
631
+ req = build_request(:associate_phone_number_contact_flow, params)
632
+ req.send_request(options)
633
+ end
634
+
603
635
  # This API is in preview release for Amazon Connect and is subject to
604
636
  # change.
605
637
  #
@@ -710,6 +742,60 @@ module Aws::Connect
710
742
  req.send_request(options)
711
743
  end
712
744
 
745
+ # Claims an available phone number to your Amazon Connect instance.
746
+ #
747
+ # @option params [required, String] :target_arn
748
+ # The Amazon Resource Name (ARN) for Amazon Connect instances that phone
749
+ # numbers are claimed to.
750
+ #
751
+ # @option params [required, String] :phone_number
752
+ # The phone number you want to claim. Phone numbers are formatted `[+]
753
+ # [country code] [subscriber number including area code]`.
754
+ #
755
+ # @option params [String] :phone_number_description
756
+ # The description of the phone number.
757
+ #
758
+ # @option params [Hash<String,String>] :tags
759
+ # The tags used to organize, track, or control access for this resource.
760
+ #
761
+ # @option params [String] :client_token
762
+ # A unique, case-sensitive identifier that you provide to ensure the
763
+ # idempotency of the request.
764
+ #
765
+ # **A suitable default value is auto-generated.** You should normally
766
+ # not need to pass this option.**
767
+ #
768
+ # @return [Types::ClaimPhoneNumberResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
769
+ #
770
+ # * {Types::ClaimPhoneNumberResponse#phone_number_id #phone_number_id} => String
771
+ # * {Types::ClaimPhoneNumberResponse#phone_number_arn #phone_number_arn} => String
772
+ #
773
+ # @example Request syntax with placeholder values
774
+ #
775
+ # resp = client.claim_phone_number({
776
+ # target_arn: "ARN", # required
777
+ # phone_number: "PhoneNumber", # required
778
+ # phone_number_description: "PhoneNumberDescription",
779
+ # tags: {
780
+ # "TagKey" => "TagValue",
781
+ # },
782
+ # client_token: "ClientToken",
783
+ # })
784
+ #
785
+ # @example Response structure
786
+ #
787
+ # resp.phone_number_id #=> String
788
+ # resp.phone_number_arn #=> String
789
+ #
790
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ClaimPhoneNumber AWS API Documentation
791
+ #
792
+ # @overload claim_phone_number(params = {})
793
+ # @param [Hash] params ({})
794
+ def claim_phone_number(params = {}, options = {})
795
+ req = build_request(:claim_phone_number, params)
796
+ req.send_request(options)
797
+ end
798
+
713
799
  # This API is in preview release for Amazon Connect and is subject to
714
800
  # change.
715
801
  #
@@ -2248,12 +2334,12 @@ module Aws::Connect
2248
2334
  #
2249
2335
  # resp = client.describe_instance_attribute({
2250
2336
  # instance_id: "InstanceId", # required
2251
- # attribute_type: "INBOUND_CALLS", # required, accepts INBOUND_CALLS, OUTBOUND_CALLS, CONTACTFLOW_LOGS, CONTACT_LENS, AUTO_RESOLVE_BEST_VOICES, USE_CUSTOM_TTS_VOICES, EARLY_MEDIA
2337
+ # attribute_type: "INBOUND_CALLS", # required, accepts INBOUND_CALLS, OUTBOUND_CALLS, CONTACTFLOW_LOGS, CONTACT_LENS, AUTO_RESOLVE_BEST_VOICES, USE_CUSTOM_TTS_VOICES, EARLY_MEDIA, MULTI_PARTY_CONFERENCE
2252
2338
  # })
2253
2339
  #
2254
2340
  # @example Response structure
2255
2341
  #
2256
- # resp.attribute.attribute_type #=> String, one of "INBOUND_CALLS", "OUTBOUND_CALLS", "CONTACTFLOW_LOGS", "CONTACT_LENS", "AUTO_RESOLVE_BEST_VOICES", "USE_CUSTOM_TTS_VOICES", "EARLY_MEDIA"
2342
+ # resp.attribute.attribute_type #=> String, one of "INBOUND_CALLS", "OUTBOUND_CALLS", "CONTACTFLOW_LOGS", "CONTACT_LENS", "AUTO_RESOLVE_BEST_VOICES", "USE_CUSTOM_TTS_VOICES", "EARLY_MEDIA", "MULTI_PARTY_CONFERENCE"
2257
2343
  # resp.attribute.value #=> String
2258
2344
  #
2259
2345
  # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DescribeInstanceAttribute AWS API Documentation
@@ -2318,6 +2404,45 @@ module Aws::Connect
2318
2404
  req.send_request(options)
2319
2405
  end
2320
2406
 
2407
+ # Gets details and status of a phone number that’s claimed to your
2408
+ # Amazon Connect instance
2409
+ #
2410
+ # @option params [required, String] :phone_number_id
2411
+ # A unique identifier for the phone number.
2412
+ #
2413
+ # @return [Types::DescribePhoneNumberResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2414
+ #
2415
+ # * {Types::DescribePhoneNumberResponse#claimed_phone_number_summary #claimed_phone_number_summary} => Types::ClaimedPhoneNumberSummary
2416
+ #
2417
+ # @example Request syntax with placeholder values
2418
+ #
2419
+ # resp = client.describe_phone_number({
2420
+ # phone_number_id: "PhoneNumberId", # required
2421
+ # })
2422
+ #
2423
+ # @example Response structure
2424
+ #
2425
+ # resp.claimed_phone_number_summary.phone_number_id #=> String
2426
+ # resp.claimed_phone_number_summary.phone_number_arn #=> String
2427
+ # resp.claimed_phone_number_summary.phone_number #=> String
2428
+ # resp.claimed_phone_number_summary.phone_number_country_code #=> String, one of "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"
2429
+ # resp.claimed_phone_number_summary.phone_number_type #=> String, one of "TOLL_FREE", "DID"
2430
+ # resp.claimed_phone_number_summary.phone_number_description #=> String
2431
+ # resp.claimed_phone_number_summary.target_arn #=> String
2432
+ # resp.claimed_phone_number_summary.tags #=> Hash
2433
+ # resp.claimed_phone_number_summary.tags["TagKey"] #=> String
2434
+ # resp.claimed_phone_number_summary.phone_number_status.status #=> String, one of "CLAIMED", "IN_PROGRESS", "FAILED"
2435
+ # resp.claimed_phone_number_summary.phone_number_status.message #=> String
2436
+ #
2437
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DescribePhoneNumber AWS API Documentation
2438
+ #
2439
+ # @overload describe_phone_number(params = {})
2440
+ # @param [Hash] params ({})
2441
+ def describe_phone_number(params = {}, options = {})
2442
+ req = build_request(:describe_phone_number, params)
2443
+ req.send_request(options)
2444
+ end
2445
+
2321
2446
  # This API is in preview release for Amazon Connect and is subject to
2322
2447
  # change.
2323
2448
  #
@@ -2858,6 +2983,34 @@ module Aws::Connect
2858
2983
  req.send_request(options)
2859
2984
  end
2860
2985
 
2986
+ # Removes the contact flow association from a phone number claimed to
2987
+ # your Amazon Connect instance, if a contact flow association exists.
2988
+ #
2989
+ # @option params [required, String] :phone_number_id
2990
+ # A unique identifier for the phone number.
2991
+ #
2992
+ # @option params [required, String] :instance_id
2993
+ # The identifier of the Amazon Connect instance. You can find the
2994
+ # instanceId in the ARN of the instance.
2995
+ #
2996
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2997
+ #
2998
+ # @example Request syntax with placeholder values
2999
+ #
3000
+ # resp = client.disassociate_phone_number_contact_flow({
3001
+ # phone_number_id: "PhoneNumberId", # required
3002
+ # instance_id: "InstanceId", # required
3003
+ # })
3004
+ #
3005
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DisassociatePhoneNumberContactFlow AWS API Documentation
3006
+ #
3007
+ # @overload disassociate_phone_number_contact_flow(params = {})
3008
+ # @param [Hash] params ({})
3009
+ def disassociate_phone_number_contact_flow(params = {}, options = {})
3010
+ req = build_request(:disassociate_phone_number_contact_flow, params)
3011
+ req.send_request(options)
3012
+ end
3013
+
2861
3014
  # This API is in preview release for Amazon Connect and is subject to
2862
3015
  # change.
2863
3016
  #
@@ -4005,7 +4158,7 @@ module Aws::Connect
4005
4158
  # @example Response structure
4006
4159
  #
4007
4160
  # resp.attributes #=> Array
4008
- # resp.attributes[0].attribute_type #=> String, one of "INBOUND_CALLS", "OUTBOUND_CALLS", "CONTACTFLOW_LOGS", "CONTACT_LENS", "AUTO_RESOLVE_BEST_VOICES", "USE_CUSTOM_TTS_VOICES", "EARLY_MEDIA"
4161
+ # resp.attributes[0].attribute_type #=> String, one of "INBOUND_CALLS", "OUTBOUND_CALLS", "CONTACTFLOW_LOGS", "CONTACT_LENS", "AUTO_RESOLVE_BEST_VOICES", "USE_CUSTOM_TTS_VOICES", "EARLY_MEDIA", "MULTI_PARTY_CONFERENCE"
4009
4162
  # resp.attributes[0].value #=> String
4010
4163
  # resp.next_token #=> String
4011
4164
  #
@@ -4353,6 +4506,78 @@ module Aws::Connect
4353
4506
  req.send_request(options)
4354
4507
  end
4355
4508
 
4509
+ # Lists phone numbers claimed to your Amazon Connect instance.
4510
+ #
4511
+ # For more information about phone numbers, see [Set Up Phone Numbers
4512
+ # for Your Contact Center][1] in the *Amazon Connect Administrator
4513
+ # Guide*.
4514
+ #
4515
+ #
4516
+ #
4517
+ # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/contact-center-phone-number.html
4518
+ #
4519
+ # @option params [String] :target_arn
4520
+ # The Amazon Resource Name (ARN) for Amazon Connect instances that phone
4521
+ # numbers are claimed to. If `TargetArn` input is not provided, this API
4522
+ # lists numbers claimed to all the Amazon Connect instances belonging to
4523
+ # your account.
4524
+ #
4525
+ # @option params [Integer] :max_results
4526
+ # The maximum number of results to return per page.
4527
+ #
4528
+ # @option params [String] :next_token
4529
+ # The token for the next set of results. Use the value returned in the
4530
+ # previous response in the next request to retrieve the next set of
4531
+ # results.
4532
+ #
4533
+ # @option params [Array<String>] :phone_number_country_codes
4534
+ # The ISO country code.
4535
+ #
4536
+ # @option params [Array<String>] :phone_number_types
4537
+ # The type of phone number.
4538
+ #
4539
+ # @option params [String] :phone_number_prefix
4540
+ # The prefix of the phone number. If provided, it must contain `+` as
4541
+ # part of the country code.
4542
+ #
4543
+ # @return [Types::ListPhoneNumbersV2Response] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4544
+ #
4545
+ # * {Types::ListPhoneNumbersV2Response#next_token #next_token} => String
4546
+ # * {Types::ListPhoneNumbersV2Response#list_phone_numbers_summary_list #list_phone_numbers_summary_list} => Array&lt;Types::ListPhoneNumbersSummary&gt;
4547
+ #
4548
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4549
+ #
4550
+ # @example Request syntax with placeholder values
4551
+ #
4552
+ # resp = client.list_phone_numbers_v2({
4553
+ # target_arn: "ARN",
4554
+ # max_results: 1,
4555
+ # next_token: "LargeNextToken",
4556
+ # 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
4557
+ # phone_number_types: ["TOLL_FREE"], # accepts TOLL_FREE, DID
4558
+ # phone_number_prefix: "PhoneNumberPrefix",
4559
+ # })
4560
+ #
4561
+ # @example Response structure
4562
+ #
4563
+ # resp.next_token #=> String
4564
+ # resp.list_phone_numbers_summary_list #=> Array
4565
+ # resp.list_phone_numbers_summary_list[0].phone_number_id #=> String
4566
+ # resp.list_phone_numbers_summary_list[0].phone_number_arn #=> String
4567
+ # resp.list_phone_numbers_summary_list[0].phone_number #=> String
4568
+ # resp.list_phone_numbers_summary_list[0].phone_number_country_code #=> String, one of "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"
4569
+ # resp.list_phone_numbers_summary_list[0].phone_number_type #=> String, one of "TOLL_FREE", "DID"
4570
+ # resp.list_phone_numbers_summary_list[0].target_arn #=> String
4571
+ #
4572
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ListPhoneNumbersV2 AWS API Documentation
4573
+ #
4574
+ # @overload list_phone_numbers_v2(params = {})
4575
+ # @param [Hash] params ({})
4576
+ def list_phone_numbers_v2(params = {}, options = {})
4577
+ req = build_request(:list_phone_numbers_v2, params)
4578
+ req.send_request(options)
4579
+ end
4580
+
4356
4581
  # Provides information about the prompts for the specified Amazon
4357
4582
  # Connect instance.
4358
4583
  #
@@ -5023,6 +5248,37 @@ module Aws::Connect
5023
5248
  req.send_request(options)
5024
5249
  end
5025
5250
 
5251
+ # Releases a phone number previously claimed to an Amazon Connect
5252
+ # instance.
5253
+ #
5254
+ # @option params [required, String] :phone_number_id
5255
+ # A unique identifier for the phone number.
5256
+ #
5257
+ # @option params [String] :client_token
5258
+ # A unique, case-sensitive identifier that you provide to ensure the
5259
+ # idempotency of the request.
5260
+ #
5261
+ # **A suitable default value is auto-generated.** You should normally
5262
+ # not need to pass this option.**
5263
+ #
5264
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
5265
+ #
5266
+ # @example Request syntax with placeholder values
5267
+ #
5268
+ # resp = client.release_phone_number({
5269
+ # phone_number_id: "PhoneNumberId", # required
5270
+ # client_token: "ClientToken",
5271
+ # })
5272
+ #
5273
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/ReleasePhoneNumber AWS API Documentation
5274
+ #
5275
+ # @overload release_phone_number(params = {})
5276
+ # @param [Hash] params ({})
5277
+ def release_phone_number(params = {}, options = {})
5278
+ req = build_request(:release_phone_number, params)
5279
+ req.send_request(options)
5280
+ end
5281
+
5026
5282
  # When a contact is being recorded, and the recording has been suspended
5027
5283
  # using SuspendContactRecording, this API resumes recording the call.
5028
5284
  #
@@ -5058,6 +5314,176 @@ module Aws::Connect
5058
5314
  req.send_request(options)
5059
5315
  end
5060
5316
 
5317
+ # Searches for available phone numbers that you can claim to your Amazon
5318
+ # Connect instance.
5319
+ #
5320
+ # @option params [required, String] :target_arn
5321
+ # The Amazon Resource Name (ARN) for Amazon Connect instances that phone
5322
+ # numbers are claimed to.
5323
+ #
5324
+ # @option params [required, String] :phone_number_country_code
5325
+ # The ISO country code.
5326
+ #
5327
+ # @option params [required, String] :phone_number_type
5328
+ # The type of phone number.
5329
+ #
5330
+ # @option params [String] :phone_number_prefix
5331
+ # The prefix of the phone number. If provided, it must contain `+` as
5332
+ # part of the country code.
5333
+ #
5334
+ # @option params [Integer] :max_results
5335
+ # The maximum number of results to return per page.
5336
+ #
5337
+ # @option params [String] :next_token
5338
+ # The token for the next set of results. Use the value returned in the
5339
+ # previous response in the next request to retrieve the next set of
5340
+ # results.
5341
+ #
5342
+ # @return [Types::SearchAvailablePhoneNumbersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5343
+ #
5344
+ # * {Types::SearchAvailablePhoneNumbersResponse#next_token #next_token} => String
5345
+ # * {Types::SearchAvailablePhoneNumbersResponse#available_numbers_list #available_numbers_list} => Array&lt;Types::AvailableNumberSummary&gt;
5346
+ #
5347
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
5348
+ #
5349
+ # @example Request syntax with placeholder values
5350
+ #
5351
+ # resp = client.search_available_phone_numbers({
5352
+ # target_arn: "ARN", # required
5353
+ # 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
5354
+ # phone_number_type: "TOLL_FREE", # required, accepts TOLL_FREE, DID
5355
+ # phone_number_prefix: "PhoneNumberPrefix",
5356
+ # max_results: 1,
5357
+ # next_token: "LargeNextToken",
5358
+ # })
5359
+ #
5360
+ # @example Response structure
5361
+ #
5362
+ # resp.next_token #=> String
5363
+ # resp.available_numbers_list #=> Array
5364
+ # resp.available_numbers_list[0].phone_number #=> String
5365
+ # resp.available_numbers_list[0].phone_number_country_code #=> String, one of "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"
5366
+ # resp.available_numbers_list[0].phone_number_type #=> String, one of "TOLL_FREE", "DID"
5367
+ #
5368
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SearchAvailablePhoneNumbers AWS API Documentation
5369
+ #
5370
+ # @overload search_available_phone_numbers(params = {})
5371
+ # @param [Hash] params ({})
5372
+ def search_available_phone_numbers(params = {}, options = {})
5373
+ req = build_request(:search_available_phone_numbers, params)
5374
+ req.send_request(options)
5375
+ end
5376
+
5377
+ # Searches users in an Amazon Connect instance, with optional filtering.
5378
+ #
5379
+ # @option params [String] :instance_id
5380
+ # The identifier of the Amazon Connect instance. You can find the
5381
+ # instanceId in the ARN of the instance.
5382
+ #
5383
+ # @option params [String] :next_token
5384
+ # The token for the next set of results. Use the value returned in the
5385
+ # previous response in the next request to retrieve the next set of
5386
+ # results.
5387
+ #
5388
+ # @option params [Integer] :max_results
5389
+ # The maximum number of results to return per page.
5390
+ #
5391
+ # @option params [Types::UserSearchFilter] :search_filter
5392
+ # Filters to be applied to search results.
5393
+ #
5394
+ # @option params [Types::UserSearchCriteria] :search_criteria
5395
+ # The search criteria to be used to return users.
5396
+ #
5397
+ # @return [Types::SearchUsersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5398
+ #
5399
+ # * {Types::SearchUsersResponse#users #users} => Array&lt;Types::UserSearchSummary&gt;
5400
+ # * {Types::SearchUsersResponse#next_token #next_token} => String
5401
+ # * {Types::SearchUsersResponse#approximate_total_count #approximate_total_count} => Integer
5402
+ #
5403
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
5404
+ #
5405
+ # @example Request syntax with placeholder values
5406
+ #
5407
+ # resp = client.search_users({
5408
+ # instance_id: "InstanceId",
5409
+ # next_token: "NextToken2500",
5410
+ # max_results: 1,
5411
+ # search_filter: {
5412
+ # tag_filter: {
5413
+ # or_conditions: [
5414
+ # [
5415
+ # {
5416
+ # tag_key: "String",
5417
+ # tag_value: "String",
5418
+ # },
5419
+ # ],
5420
+ # ],
5421
+ # and_conditions: [
5422
+ # {
5423
+ # tag_key: "String",
5424
+ # tag_value: "String",
5425
+ # },
5426
+ # ],
5427
+ # tag_condition: {
5428
+ # tag_key: "String",
5429
+ # tag_value: "String",
5430
+ # },
5431
+ # },
5432
+ # },
5433
+ # search_criteria: {
5434
+ # or_conditions: [
5435
+ # {
5436
+ # # recursive UserSearchCriteria
5437
+ # },
5438
+ # ],
5439
+ # and_conditions: [
5440
+ # {
5441
+ # # recursive UserSearchCriteria
5442
+ # },
5443
+ # ],
5444
+ # string_condition: {
5445
+ # field_name: "String",
5446
+ # value: "String",
5447
+ # comparison_type: "STARTS_WITH", # accepts STARTS_WITH, CONTAINS, EXACT
5448
+ # },
5449
+ # hierarchy_group_condition: {
5450
+ # value: "String",
5451
+ # hierarchy_group_match_type: "EXACT", # accepts EXACT, WITH_CHILD_GROUPS
5452
+ # },
5453
+ # },
5454
+ # })
5455
+ #
5456
+ # @example Response structure
5457
+ #
5458
+ # resp.users #=> Array
5459
+ # resp.users[0].arn #=> String
5460
+ # resp.users[0].directory_user_id #=> String
5461
+ # resp.users[0].hierarchy_group_id #=> String
5462
+ # resp.users[0].id #=> String
5463
+ # resp.users[0].identity_info.first_name #=> String
5464
+ # resp.users[0].identity_info.last_name #=> String
5465
+ # resp.users[0].phone_config.phone_type #=> String, one of "SOFT_PHONE", "DESK_PHONE"
5466
+ # resp.users[0].phone_config.auto_accept #=> Boolean
5467
+ # resp.users[0].phone_config.after_contact_work_time_limit #=> Integer
5468
+ # resp.users[0].phone_config.desk_phone_number #=> String
5469
+ # resp.users[0].routing_profile_id #=> String
5470
+ # resp.users[0].security_profile_ids #=> Array
5471
+ # resp.users[0].security_profile_ids[0] #=> String
5472
+ # resp.users[0].tags #=> Hash
5473
+ # resp.users[0].tags["TagKey"] #=> String
5474
+ # resp.users[0].username #=> String
5475
+ # resp.next_token #=> String
5476
+ # resp.approximate_total_count #=> Integer
5477
+ #
5478
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SearchUsers AWS API Documentation
5479
+ #
5480
+ # @overload search_users(params = {})
5481
+ # @param [Hash] params ({})
5482
+ def search_users(params = {}, options = {})
5483
+ req = build_request(:search_users, params)
5484
+ req.send_request(options)
5485
+ end
5486
+
5061
5487
  # Searches for vocabularies within a specific Amazon Connect instance
5062
5488
  # using `State`, `NameStartsWith`, and `LanguageCode`.
5063
5489
  #
@@ -5582,8 +6008,6 @@ module Aws::Connect
5582
6008
  # Ends the specified contact. This call does not work for the following
5583
6009
  # initiation methods:
5584
6010
  #
5585
- # * CALLBACK
5586
- #
5587
6011
  # * DISCONNECT
5588
6012
  #
5589
6013
  # * TRANSFER
@@ -5735,7 +6159,8 @@ module Aws::Connect
5735
6159
  # Adds the specified tags to the specified resource.
5736
6160
  #
5737
6161
  # The supported resource types are users, routing profiles, queues,
5738
- # quick connects, contact flows, agent status, and hours of operation.
6162
+ # quick connects, contact flows, agent status, hours of operation, and
6163
+ # phone number.
5739
6164
  #
5740
6165
  # For sample policies that use tags, see [Amazon Connect Identity-Based
5741
6166
  # Policy Examples][1] in the *Amazon Connect Administrator Guide*.
@@ -6282,7 +6707,7 @@ module Aws::Connect
6282
6707
  #
6283
6708
  # resp = client.update_instance_attribute({
6284
6709
  # instance_id: "InstanceId", # required
6285
- # attribute_type: "INBOUND_CALLS", # required, accepts INBOUND_CALLS, OUTBOUND_CALLS, CONTACTFLOW_LOGS, CONTACT_LENS, AUTO_RESOLVE_BEST_VOICES, USE_CUSTOM_TTS_VOICES, EARLY_MEDIA
6710
+ # attribute_type: "INBOUND_CALLS", # required, accepts INBOUND_CALLS, OUTBOUND_CALLS, CONTACTFLOW_LOGS, CONTACT_LENS, AUTO_RESOLVE_BEST_VOICES, USE_CUSTOM_TTS_VOICES, EARLY_MEDIA, MULTI_PARTY_CONFERENCE
6286
6711
  # value: "InstanceAttributeValue", # required
6287
6712
  # })
6288
6713
  #
@@ -6360,6 +6785,50 @@ module Aws::Connect
6360
6785
  req.send_request(options)
6361
6786
  end
6362
6787
 
6788
+ # Updates your claimed phone number from its current Amazon Connect
6789
+ # instance to another Amazon Connect instance in the same Region.
6790
+ #
6791
+ # @option params [required, String] :phone_number_id
6792
+ # A unique identifier for the phone number.
6793
+ #
6794
+ # @option params [required, String] :target_arn
6795
+ # The Amazon Resource Name (ARN) for Amazon Connect instances that phone
6796
+ # numbers are claimed to.
6797
+ #
6798
+ # @option params [String] :client_token
6799
+ # A unique, case-sensitive identifier that you provide to ensure the
6800
+ # idempotency of the request.
6801
+ #
6802
+ # **A suitable default value is auto-generated.** You should normally
6803
+ # not need to pass this option.**
6804
+ #
6805
+ # @return [Types::UpdatePhoneNumberResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6806
+ #
6807
+ # * {Types::UpdatePhoneNumberResponse#phone_number_id #phone_number_id} => String
6808
+ # * {Types::UpdatePhoneNumberResponse#phone_number_arn #phone_number_arn} => String
6809
+ #
6810
+ # @example Request syntax with placeholder values
6811
+ #
6812
+ # resp = client.update_phone_number({
6813
+ # phone_number_id: "PhoneNumberId", # required
6814
+ # target_arn: "ARN", # required
6815
+ # client_token: "ClientToken",
6816
+ # })
6817
+ #
6818
+ # @example Response structure
6819
+ #
6820
+ # resp.phone_number_id #=> String
6821
+ # resp.phone_number_arn #=> String
6822
+ #
6823
+ # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdatePhoneNumber AWS API Documentation
6824
+ #
6825
+ # @overload update_phone_number(params = {})
6826
+ # @param [Hash] params ({})
6827
+ def update_phone_number(params = {}, options = {})
6828
+ req = build_request(:update_phone_number, params)
6829
+ req.send_request(options)
6830
+ end
6831
+
6363
6832
  # This API is in preview release for Amazon Connect and is subject to
6364
6833
  # change.
6365
6834
  #
@@ -7075,7 +7544,7 @@ module Aws::Connect
7075
7544
  params: params,
7076
7545
  config: config)
7077
7546
  context[:gem_name] = 'aws-sdk-connect'
7078
- context[:gem_version] = '1.67.0'
7547
+ context[:gem_version] = '1.70.0'
7079
7548
  Seahorse::Client::Request.new(handlers, context)
7080
7549
  end
7081
7550