aws-sdk-connect 1.169.0 → 1.179.0

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

@@ -32,11 +32,10 @@ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/request_compression.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
+require 'aws-sdk-core/plugins/telemetry.rb'
 require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
-Aws::Plugins::GlobalConfiguration.add_identifier(:connect)
-
 module Aws::Connect
   # An API client for Connect.  To construct a client, you need to configure a `:region` and `:credentials`.
   #
@@ -83,6 +82,7 @@ module Aws::Connect
     add_plugin(Aws::Plugins::RequestCompression)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
+    add_plugin(Aws::Plugins::Telemetry)
     add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::RestJson)
     add_plugin(Aws::Connect::Plugins::Endpoints)
@@ -128,13 +128,15 @@ module Aws::Connect
     #     locations will be searched for credentials:
     #
     #     * `Aws.config[:credentials]`
-    #     * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
-    #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
+    #     * The `:access_key_id`, `:secret_access_key`, `:session_token`, and
+    #       `:account_id` options.
+    #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY'],
+    #       ENV['AWS_SESSION_TOKEN'], and ENV['AWS_ACCOUNT_ID']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
     #       enable retries and extended timeouts. Instance profile credential
     #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
     #       to true.
@@ -153,6 +155,8 @@ module Aws::Connect
     #
     #   @option options [String] :access_key_id
     #
+    #   @option options [String] :account_id
+    #
     #   @option options [Boolean] :active_endpoint_cache (false)
     #     When set to `true`, a thread polling for endpoints will be running in
     #     the background every 60 secs (default). Defaults to `false`.
@@ -330,6 +334,16 @@ module Aws::Connect
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
+    #     Allows you to provide a telemetry provider, which is used to
+    #     emit telemetry data. By default, uses `NoOpTelemetryProvider` which
+    #     will not record or emit any telemetry data. The SDK supports the
+    #     following telemetry providers:
+    #
+    #     * OpenTelemetry (OTel) - To use the OTel provider, install and require the
+    #     `opentelemetry-sdk` gem and then, pass in an instance of a
+    #     `Aws::Telemetry::OTelProvider` for telemetry provider.
+    #
     #   @option options [Aws::TokenProvider] :token_provider
     #     A Bearer Token Provider. This can be an instance of any one of the
     #     following classes:
@@ -357,7 +371,9 @@ module Aws::Connect
     #     sending the request.
     #
     #   @option options [Aws::Connect::EndpointProvider] :endpoint_provider
-    #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::Connect::EndpointParameters`
+    #     The endpoint provider used to resolve endpoints. Any object that responds to
+    #     `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to
+    #     `Aws::Connect::EndpointParameters`.
     #
     #   @option options [Float] :http_continue_timeout (1)
     #     The number of seconds to wait for a 100-continue response before sending the
@@ -413,6 +429,12 @@ module Aws::Connect
     #   @option options [String] :ssl_ca_store
     #     Sets the X509::Store to verify peer certificate.
     #
+    #   @option options [OpenSSL::X509::Certificate] :ssl_cert
+    #     Sets a client certificate when creating http connections.
+    #
+    #   @option options [OpenSSL::PKey] :ssl_key
+    #     Sets a client key when creating http connections.
+    #
     #   @option options [Float] :ssl_timeout
     #     Sets the SSL timeout in seconds
     #
@@ -474,9 +496,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Associates the specified dataset for a Amazon Connect instance with
     # the target account. You can associate only one dataset in a single
     # call.
@@ -638,7 +657,7 @@ module Aws::Connect
     #
     #   resp = client.associate_default_vocabulary({
     #     instance_id: "InstanceId", # required
-    #     language_code: "ar-AE", # required, accepts ar-AE, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fr-CA, fr-FR, hi-IN, it-IT, ja-JP, ko-KR, pt-BR, pt-PT, zh-CN, en-NZ, en-ZA
+    #     language_code: "ar-AE", # required, accepts ar-AE, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fr-CA, fr-FR, hi-IN, it-IT, ja-JP, ko-KR, pt-BR, pt-PT, zh-CN, en-NZ, en-ZA, ca-ES, da-DK, fi-FI, id-ID, ms-MY, nl-NL, no-NO, pl-PL, sv-SE, tl-PH
     #     vocabulary_id: "VocabularyId",
     #   })
     #
@@ -1005,7 +1024,7 @@ module Aws::Connect
     #   [1]: https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html
     #
     # @option params [required, String] :key
-    #   A valid security key in PEM format.
+    #   A valid security key in PEM format as a String.
     #
     # @return [Types::AssociateSecurityKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1107,9 +1126,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Associates a list of analytics datasets for a given Amazon Connect
     # instance to a target account. You can associate multiple datasets in a
     # single call.
@@ -1164,9 +1180,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Removes a list of analytics datasets associated with a given Amazon
     # Connect instance. You can disassociate multiple datasets in a single
     # call.
@@ -1380,11 +1393,11 @@ module Aws::Connect
     #     contact_data_request_list: [ # required
     #       {
     #         system_endpoint: {
-    #           type: "TELEPHONE_NUMBER", # accepts TELEPHONE_NUMBER, VOIP, CONTACT_FLOW
+    #           type: "TELEPHONE_NUMBER", # accepts TELEPHONE_NUMBER, VOIP, CONTACT_FLOW, CONNECT_PHONENUMBER_ARN
     #           address: "EndpointAddress",
     #         },
     #         customer_endpoint: {
-    #           type: "TELEPHONE_NUMBER", # accepts TELEPHONE_NUMBER, VOIP, CONTACT_FLOW
+    #           type: "TELEPHONE_NUMBER", # accepts TELEPHONE_NUMBER, VOIP, CONTACT_FLOW, CONNECT_PHONENUMBER_ARN
     #           address: "EndpointAddress",
     #         },
     #         request_identifier: "RequestIdentifier",
@@ -2007,6 +2020,9 @@ module Aws::Connect
     # Service (Amazon S3) or Amazon Kinesis. It also does not allow for any
     # configurations on features, such as Contact Lens for Amazon Connect.
     #
+    # For more information, see [Create an Amazon Connect instance][1] in
+    # the *Amazon Connect Administrator Guide*.
+    #
     # Amazon Connect enforces a limit on the total number of instances that
     # you can create or delete in 30 days. If you exceed this limit, you
     # will get an error message indicating there has been an excessive
@@ -2014,6 +2030,10 @@ module Aws::Connect
     # days before you can restart creating and deleting instances in your
     # account.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-instances.html
+    #
     # @option params [String] :client_token
     #   The idempotency token.
     #
@@ -2339,7 +2359,14 @@ module Aws::Connect
     end
 
     # Creates a new predefined attribute for the specified Amazon Connect
-    # instance.
+    # instance. *Predefined attributes* are attributes in an Amazon Connect
+    # instance that can be used to route contacts to an agent or pools of
+    # agents within a queue. For more information, see [Create predefined
+    # attributes for routing contacts to agents][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can find the
@@ -2854,6 +2881,16 @@ module Aws::Connect
 
     # Creates a security profile.
     #
+    # For information about security profiles, see [Security Profiles][1] in
+    # the *Amazon Connect Administrator Guide*. For a mapping of the API
+    # name and user interface name of the security profile permissions, see
+    # [List of security profile permissions][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html
+    #
     # @option params [required, String] :security_profile_name
     #   The name of the security profile.
     #
@@ -3600,7 +3637,7 @@ module Aws::Connect
     #     client_token: "ClientToken",
     #     instance_id: "InstanceId", # required
     #     vocabulary_name: "VocabularyName", # required
-    #     language_code: "ar-AE", # required, accepts ar-AE, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fr-CA, fr-FR, hi-IN, it-IT, ja-JP, ko-KR, pt-BR, pt-PT, zh-CN, en-NZ, en-ZA
+    #     language_code: "ar-AE", # required, accepts ar-AE, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fr-CA, fr-FR, hi-IN, it-IT, ja-JP, ko-KR, pt-BR, pt-PT, zh-CN, en-NZ, en-ZA, ca-ES, da-DK, fi-FI, id-ID, ms-MY, nl-NL, no-NO, pl-PL, sv-SE, tl-PH
     #     content: "VocabularyContent", # required
     #     tags: {
     #       "TagKey" => "TagValue",
@@ -3883,7 +3920,9 @@ module Aws::Connect
     # This API is in preview release for Amazon Connect and is subject to
     # change.
     #
-    # Deletes the Amazon Connect instance.
+    # Deletes the Amazon Connect instance. For more information, see [Delete
+    # your Amazon Connect instance][1] in the *Amazon Connect Administrator
+    # Guide*.
     #
     # Amazon Connect enforces a limit on the total number of instances that
     # you can create or delete in 30 days. If you exceed this limit, you
@@ -3892,6 +3931,10 @@ module Aws::Connect
     # days before you can restart creating and deleting instances in your
     # account.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/delete-connect-instance.html
+    #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can [find the
     #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
@@ -4009,7 +4052,8 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # Deletes a queue.
+    # Deletes a queue. It isn't possible to delete a queue by using the
+    # Amazon Connect admin website.
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can [find the
@@ -4576,10 +4620,10 @@ module Aws::Connect
     #
     # Describes the specified contact.
     #
-    # Contact information remains available in Amazon Connect for 24 months,
-    # and then it is deleted.
-    #
-    #  Only data from November 12, 2021, and later is returned by this API.
+    # Contact information remains available in Amazon Connect for 24 months
+    # from the InitiationTimestamp, and then it is deleted. Only contact
+    # information that is available in Amazon Connect is returned by this
+    # API
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can [find the
@@ -5060,6 +5104,7 @@ module Aws::Connect
     # @return [Types::DescribeInstanceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeInstanceResponse#instance #instance} => Types::Instance
+    #   * {Types::DescribeInstanceResponse#replication_configuration #replication_configuration} => Types::ReplicationConfiguration
     #
     # @example Request syntax with placeholder values
     #
@@ -5082,6 +5127,12 @@ module Aws::Connect
     #   resp.instance.instance_access_url #=> String
     #   resp.instance.tags #=> Hash
     #   resp.instance.tags["TagKey"] #=> String
+    #   resp.replication_configuration.replication_status_summary_list #=> Array
+    #   resp.replication_configuration.replication_status_summary_list[0].region #=> String
+    #   resp.replication_configuration.replication_status_summary_list[0].replication_status #=> String, one of "INSTANCE_REPLICATION_COMPLETE", "INSTANCE_REPLICATION_IN_PROGRESS", "INSTANCE_REPLICATION_FAILED", "INSTANCE_REPLICA_DELETING", "INSTANCE_REPLICATION_DELETION_FAILED", "RESOURCE_REPLICATION_NOT_STARTED"
+    #   resp.replication_configuration.replication_status_summary_list[0].replication_status_reason #=> String
+    #   resp.replication_configuration.source_region #=> String
+    #   resp.replication_configuration.global_sign_in_endpoint #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/DescribeInstance AWS API Documentation
     #
@@ -5242,7 +5293,14 @@ module Aws::Connect
     end
 
     # Describes a predefined attribute for the specified Amazon Connect
-    # instance.
+    # instance. *Predefined attributes* are attributes in an Amazon Connect
+    # instance that can be used to route contacts to an agent or pools of
+    # agents within a queue. For more information, see [Create predefined
+    # attributes for routing contacts to agents][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can find the
@@ -5559,7 +5617,17 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # Gets basic information about the security profle.
+    # Gets basic information about the security profile.
+    #
+    # For information about security profiles, see [Security Profiles][1] in
+    # the *Amazon Connect Administrator Guide*. For a mapping of the API
+    # name and user interface name of the security profile permissions, see
+    # [List of security profile permissions][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html
     #
     # @option params [required, String] :security_profile_id
     #   The identifier for the security profle.
@@ -5932,7 +6000,7 @@ module Aws::Connect
     #   resp.vocabulary.name #=> String
     #   resp.vocabulary.id #=> String
     #   resp.vocabulary.arn #=> String
-    #   resp.vocabulary.language_code #=> String, one of "ar-AE", "de-CH", "de-DE", "en-AB", "en-AU", "en-GB", "en-IE", "en-IN", "en-US", "en-WL", "es-ES", "es-US", "fr-CA", "fr-FR", "hi-IN", "it-IT", "ja-JP", "ko-KR", "pt-BR", "pt-PT", "zh-CN", "en-NZ", "en-ZA"
+    #   resp.vocabulary.language_code #=> String, one of "ar-AE", "de-CH", "de-DE", "en-AB", "en-AU", "en-GB", "en-IE", "en-IN", "en-US", "en-WL", "es-ES", "es-US", "fr-CA", "fr-FR", "hi-IN", "it-IT", "ja-JP", "ko-KR", "pt-BR", "pt-PT", "zh-CN", "en-NZ", "en-ZA", "ca-ES", "da-DK", "fi-FI", "id-ID", "ms-MY", "nl-NL", "no-NO", "pl-PL", "sv-SE", "tl-PH"
     #   resp.vocabulary.state #=> String, one of "CREATION_IN_PROGRESS", "ACTIVE", "CREATION_FAILED", "DELETE_IN_PROGRESS"
     #   resp.vocabulary.last_modified_time #=> Time
     #   resp.vocabulary.failure_reason #=> String
@@ -5949,9 +6017,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Removes the dataset ID associated with a given Amazon Connect
     # instance.
     #
@@ -8165,8 +8230,8 @@ module Aws::Connect
     #     Connect
     #
     #     Threshold: For `ThresholdValue`, enter any whole number from 1 to
-    #     604800 (inclusive), in seconds. For `Comparison`, you must enter
-    #     `LT` (for "Less than").
+    #     604800 (inclusive), in seconds. For `Comparison`, you can use `LT`
+    #     (for "Less than") or `LTE` (for "Less than equal").
     #
     #     UI name: [Contacts removed from queue in X seconds][51]
     #
@@ -8178,8 +8243,8 @@ module Aws::Connect
     #     contact/segmentAttributes/connect:Subtype, Q in Connect
     #
     #     Threshold: For `ThresholdValue` enter any whole number from 1 to
-    #     604800 (inclusive), in seconds. For `Comparison`, you must enter
-    #     `LT` (for "Less than").
+    #     604800 (inclusive), in seconds. For `Comparison`, you can use `LT`
+    #     (for "Less than") or `LTE` (for "Less than equal").
     #
     #     UI name: [Contacts resolved in X][52]
     #
@@ -8460,8 +8525,8 @@ module Aws::Connect
     #     Connect
     #
     #     Threshold: For `ThresholdValue`, enter any whole number from 1 to
-    #     604800 (inclusive), in seconds. For `Comparison`, you must enter
-    #     `LT` (for "Less than").
+    #     604800 (inclusive), in seconds. For `Comparison`, you can use `LT`
+    #     (for "Less than") or `LTE` (for "Less than equal").
     #
     #     UI name: [Service level X][72]
     #
@@ -8501,7 +8566,7 @@ module Aws::Connect
     #
     #      </note>
     #
-    #   SUM\_CONTACTS\_ABANDONED
+    #   CONTACTS\_ABANDONED
     #
     #   : Unit: Count
     #
@@ -8526,8 +8591,8 @@ module Aws::Connect
     #     contact/segmentAttributes/connect:Subtype, Q in Connect
     #
     #     Threshold: For `ThresholdValue`, enter any whole number from 1 to
-    #     604800 (inclusive), in seconds. For `Comparison`, you must enter
-    #     `LT` (for "Less than").
+    #     604800 (inclusive), in seconds. For `Comparison`, you can use `LT`
+    #     (for "Less than") or `LTE` (for "Less than equal").
     #
     #     UI name: [Contacts abandoned in X seconds][76]
     #
@@ -8539,8 +8604,8 @@ module Aws::Connect
     #     contact/segmentAttributes/connect:Subtype, Q in Connect
     #
     #     Threshold: For `ThresholdValue`, enter any whole number from 1 to
-    #     604800 (inclusive), in seconds. For `Comparison`, you must enter
-    #     `LT` (for "Less than").
+    #     604800 (inclusive), in seconds. For `Comparison`, you can use `LT`
+    #     (for "Less than") or `LTE` (for "Less than equal").
     #
     #     UI name: [Contacts answered in X seconds][77]
     #
@@ -9149,9 +9214,6 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # This API is in preview release for Amazon Connect and is subject to
-    # change.
-    #
     # Lists the association status of requested dataset ID for a given
     # Amazon Connect instance.
     #
@@ -9673,7 +9735,7 @@ module Aws::Connect
     #
     #   resp = client.list_default_vocabularies({
     #     instance_id: "InstanceId", # required
-    #     language_code: "ar-AE", # accepts ar-AE, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fr-CA, fr-FR, hi-IN, it-IT, ja-JP, ko-KR, pt-BR, pt-PT, zh-CN, en-NZ, en-ZA
+    #     language_code: "ar-AE", # accepts ar-AE, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fr-CA, fr-FR, hi-IN, it-IT, ja-JP, ko-KR, pt-BR, pt-PT, zh-CN, en-NZ, en-ZA, ca-ES, da-DK, fi-FI, id-ID, ms-MY, nl-NL, no-NO, pl-PL, sv-SE, tl-PH
     #     max_results: 1,
     #     next_token: "VocabularyNextToken",
     #   })
@@ -9682,7 +9744,7 @@ module Aws::Connect
     #
     #   resp.default_vocabulary_list #=> Array
     #   resp.default_vocabulary_list[0].instance_id #=> String
-    #   resp.default_vocabulary_list[0].language_code #=> String, one of "ar-AE", "de-CH", "de-DE", "en-AB", "en-AU", "en-GB", "en-IE", "en-IN", "en-US", "en-WL", "es-ES", "es-US", "fr-CA", "fr-FR", "hi-IN", "it-IT", "ja-JP", "ko-KR", "pt-BR", "pt-PT", "zh-CN", "en-NZ", "en-ZA"
+    #   resp.default_vocabulary_list[0].language_code #=> String, one of "ar-AE", "de-CH", "de-DE", "en-AB", "en-AU", "en-GB", "en-IE", "en-IN", "en-US", "en-WL", "es-ES", "es-US", "fr-CA", "fr-FR", "hi-IN", "it-IT", "ja-JP", "ko-KR", "pt-BR", "pt-PT", "zh-CN", "en-NZ", "en-ZA", "ca-ES", "da-DK", "fi-FI", "id-ID", "ms-MY", "nl-NL", "no-NO", "pl-PL", "sv-SE", "tl-PH"
     #   resp.default_vocabulary_list[0].vocabulary_id #=> String
     #   resp.default_vocabulary_list[0].vocabulary_name #=> String
     #   resp.next_token #=> String
@@ -10477,6 +10539,14 @@ module Aws::Connect
     end
 
     # Lists predefined attributes for the specified Amazon Connect instance.
+    # *Predefined attributes* are attributes in an Amazon Connect instance
+    # that can be used to route contacts to an agent or pools of agents
+    # within a queue. For more information, see [Create predefined
+    # attributes for routing contacts to agents][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can find the
@@ -11181,6 +11251,16 @@ module Aws::Connect
 
     # Lists the permissions granted to a security profile.
     #
+    # For information about security profiles, see [Security Profiles][1] in
+    # the *Amazon Connect Administrator Guide*. For a mapping of the API
+    # name and user interface name of the security profile permissions, see
+    # [List of security profile permissions][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html
+    #
     # @option params [required, String] :security_profile_id
     #   The identifier for the security profle.
     #
@@ -11239,11 +11319,14 @@ module Aws::Connect
     # specified Amazon Connect instance.
     #
     # For more information about security profiles, see [Security
-    # Profiles][1] in the *Amazon Connect Administrator Guide*.
+    # Profiles][1] in the *Amazon Connect Administrator Guide*. For a
+    # mapping of the API name and user interface name of the security
+    # profile permissions, see [List of security profile permissions][2].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can [find the
@@ -12809,7 +12892,15 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # Predefined attributes that meet certain criteria.
+    # Searches predefined attributes that meet certain criteria. *Predefined
+    # attributes* are attributes in an Amazon Connect instance that can be
+    # used to route contacts to an agent or pools of agents within a queue.
+    # For more information, see [Create predefined attributes for routing
+    # contacts to agents][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can find the
@@ -13414,6 +13505,16 @@ module Aws::Connect
     # Searches security profiles in an Amazon Connect instance, with
     # optional filtering.
     #
+    # For information about security profiles, see [Security Profiles][1] in
+    # the *Amazon Connect Administrator Guide*. For a mapping of the API
+    # name and user interface name of the security profile permissions, see
+    # [List of security profile permissions][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html
+    #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can [find the
     #   instance ID][1] in the Amazon Resource Name (ARN) of the instance.
@@ -13888,7 +13989,7 @@ module Aws::Connect
     #     next_token: "VocabularyNextToken",
     #     state: "CREATION_IN_PROGRESS", # accepts CREATION_IN_PROGRESS, ACTIVE, CREATION_FAILED, DELETE_IN_PROGRESS
     #     name_starts_with: "VocabularyName",
-    #     language_code: "ar-AE", # accepts ar-AE, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fr-CA, fr-FR, hi-IN, it-IT, ja-JP, ko-KR, pt-BR, pt-PT, zh-CN, en-NZ, en-ZA
+    #     language_code: "ar-AE", # accepts ar-AE, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fr-CA, fr-FR, hi-IN, it-IT, ja-JP, ko-KR, pt-BR, pt-PT, zh-CN, en-NZ, en-ZA, ca-ES, da-DK, fi-FI, id-ID, ms-MY, nl-NL, no-NO, pl-PL, sv-SE, tl-PH
     #   })
     #
     # @example Response structure
@@ -13897,7 +13998,7 @@ module Aws::Connect
     #   resp.vocabulary_summary_list[0].name #=> String
     #   resp.vocabulary_summary_list[0].id #=> String
     #   resp.vocabulary_summary_list[0].arn #=> String
-    #   resp.vocabulary_summary_list[0].language_code #=> String, one of "ar-AE", "de-CH", "de-DE", "en-AB", "en-AU", "en-GB", "en-IE", "en-IN", "en-US", "en-WL", "es-ES", "es-US", "fr-CA", "fr-FR", "hi-IN", "it-IT", "ja-JP", "ko-KR", "pt-BR", "pt-PT", "zh-CN", "en-NZ", "en-ZA"
+    #   resp.vocabulary_summary_list[0].language_code #=> String, one of "ar-AE", "de-CH", "de-DE", "en-AB", "en-AU", "en-GB", "en-IE", "en-IN", "en-US", "en-WL", "es-ES", "es-US", "fr-CA", "fr-FR", "hi-IN", "it-IT", "ja-JP", "ko-KR", "pt-BR", "pt-PT", "zh-CN", "en-NZ", "en-ZA", "ca-ES", "da-DK", "fi-FI", "id-ID", "ms-MY", "nl-NL", "no-NO", "pl-PL", "sv-SE", "tl-PH"
     #   resp.vocabulary_summary_list[0].state #=> String, one of "CREATION_IN_PROGRESS", "ACTIVE", "CREATION_FAILED", "DELETE_IN_PROGRESS"
     #   resp.vocabulary_summary_list[0].last_modified_time #=> Time
     #   resp.vocabulary_summary_list[0].failure_reason #=> String
@@ -14514,6 +14615,174 @@ module Aws::Connect
       req.send_request(options)
     end
 
+    # Initiates a new outbound SMS contact to a customer. Response of this
+    # API provides the ContactId of the outbound SMS contact created.
+    #
+    # **SourceEndpoint** only supports Endpoints with
+    # `CONNECT_PHONENUMBER_ARN` as Type and **DestinationEndpoint** only
+    # supports Endpoints with `TELEPHONE_NUMBER` as Type. **ContactFlowId**
+    # initiates the flow to manage the new SMS contact created.
+    #
+    # This API can be used to initiate outbound SMS contacts for an agent or
+    # it can also deflect an ongoing contact to an outbound SMS contact by
+    # using the [StartOutboundChatContact][1] Flow Action.
+    #
+    # For more information about using SMS in Amazon Connect, see the
+    # following topics in the *Amazon Connect Administrator Guide*:
+    #
+    # * [Set up SMS messaging][2]
+    #
+    # * [Request an SMS-enabled phone number through AWS End User Messaging
+    #   SMS][3]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundChatContact.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/setup-sms-messaging.html
+    # [3]: https://docs.aws.amazon.com/connect/latest/adminguide/sms-number.html
+    #
+    # @option params [required, Types::Endpoint] :source_endpoint
+    #   Information about the endpoint.
+    #
+    # @option params [required, Types::Endpoint] :destination_endpoint
+    #   Information about the endpoint.
+    #
+    # @option params [required, String] :instance_id
+    #   The identifier of the Amazon Connect instance. You can find the
+    #   instance ID in the Amazon Resource Name (ARN) of the instance.
+    #
+    # @option params [required, Hash<String,Types::SegmentAttributeValue>] :segment_attributes
+    #   A set of system defined key-value pairs stored on individual contact
+    #   segments using an attribute map. The attributes are standard Amazon
+    #   Connect attributes. They can be accessed in flows.
+    #
+    #   * Attribute keys can include only alphanumeric, `-`, and `_`.
+    #
+    #   * This field can be used to show channel subtype, such as
+    #     `connect:Guide` and `connect:SMS`.
+    #
+    # @option params [Hash<String,String>] :attributes
+    #   A custom key-value pair using an attribute map. The attributes are
+    #   standard Amazon Connect attributes, and can be accessed in flows just
+    #   like any other contact attributes.
+    #
+    # @option params [required, String] :contact_flow_id
+    #   The identifier of the flow for the call. To see the ContactFlowId in
+    #   the Amazon Connect console user interface, on the navigation menu go
+    #   to **Routing, Contact Flows**. Choose the flow. On the flow page,
+    #   under the name of the flow, choose **Show additional flow
+    #   information**. The ContactFlowId is the last part of the ARN, shown
+    #   here in bold:
+    #
+    #   * arn:aws:connect:us-west-2:xxxxxxxxxxxx:instance/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/contact-flow/**123ec456-a007-89c0-1234-xxxxxxxxxxxx**
+    #
+    #   ^
+    #
+    # @option params [Integer] :chat_duration_in_minutes
+    #   The total duration of the newly started chat session. If not
+    #   specified, the chat session duration defaults to 25 hour. The minimum
+    #   configurable time is 60 minutes. The maximum configurable time is
+    #   10,080 minutes (7 days).
+    #
+    # @option params [Types::ParticipantDetails] :participant_details
+    #   The customer's details.
+    #
+    # @option params [Types::ChatMessage] :initial_system_message
+    #   A chat message.
+    #
+    # @option params [String] :related_contact_id
+    #   The unique identifier for an Amazon Connect contact. This identifier
+    #   is related to the contact starting.
+    #
+    # @option params [Array<String>] :supported_messaging_content_types
+    #   The supported chat message content types. Supported types are:
+    #
+    #   * `text/plain`
+    #
+    #   * `text/markdown`
+    #
+    #   * `application/json,
+    #     application/vnd.amazonaws.connect.message.interactive`
+    #
+    #   * `application/vnd.amazonaws.connect.message.interactive.response`
+    #
+    #   Content types must always contain `text/plain`. You can then put any
+    #   other supported type in the list. For example, all the following lists
+    #   are valid because they contain `text/plain`:
+    #
+    #   * `[text/plain, text/markdown, application/json]`
+    #
+    #   * `[text/markdown, text/plain]`
+    #
+    #   * `[text/plain, application/json,
+    #     application/vnd.amazonaws.connect.message.interactive.response]`
+    #
+    # @option params [String] :client_token
+    #   A unique, case-sensitive identifier that you provide to ensure the
+    #   idempotency of the request. If not provided, the AWS SDK populates
+    #   this field. For more information about idempotency, see [Making
+    #   retries safe with idempotent APIs][1]. The token is valid for 7 days
+    #   after creation. If a contact is already started, the contact ID is
+    #   returned.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #
+    # @return [Types::StartOutboundChatContactResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartOutboundChatContactResponse#contact_id #contact_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_outbound_chat_contact({
+    #     source_endpoint: { # required
+    #       type: "TELEPHONE_NUMBER", # accepts TELEPHONE_NUMBER, VOIP, CONTACT_FLOW, CONNECT_PHONENUMBER_ARN
+    #       address: "EndpointAddress",
+    #     },
+    #     destination_endpoint: { # required
+    #       type: "TELEPHONE_NUMBER", # accepts TELEPHONE_NUMBER, VOIP, CONTACT_FLOW, CONNECT_PHONENUMBER_ARN
+    #       address: "EndpointAddress",
+    #     },
+    #     instance_id: "InstanceId", # required
+    #     segment_attributes: { # required
+    #       "SegmentAttributeName" => {
+    #         value_string: "SegmentAttributeValueString",
+    #       },
+    #     },
+    #     attributes: {
+    #       "AttributeName" => "AttributeValue",
+    #     },
+    #     contact_flow_id: "ContactFlowId", # required
+    #     chat_duration_in_minutes: 1,
+    #     participant_details: {
+    #       display_name: "DisplayName", # required
+    #     },
+    #     initial_system_message: {
+    #       content_type: "ChatContentType", # required
+    #       content: "ChatContent", # required
+    #     },
+    #     related_contact_id: "ContactId",
+    #     supported_messaging_content_types: ["SupportedMessagingContentType"],
+    #     client_token: "ClientToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.contact_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/StartOutboundChatContact AWS API Documentation
+    #
+    # @overload start_outbound_chat_contact(params = {})
+    # @param [Hash] params ({})
+    def start_outbound_chat_contact(params = {}, options = {})
+      req = build_request(:start_outbound_chat_contact, params)
+      req.send_request(options)
+    end
+
     # Places an outbound call to a contact, and then initiates the flow. It
     # performs the actions in the flow that's specified (in
     # `ContactFlowId`).
@@ -16091,6 +16360,10 @@ module Aws::Connect
     #   other contacts in the queue by assigning them a higher priority, such
     #   as 1 or 2.
     #
+    # @option params [Types::RoutingCriteriaInput] :routing_criteria
+    #   Updates the routing criteria on the contact. These properties can be
+    #   used to change how a
 contact is routed within the queue.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -16100,6 +16373,38 @@ module Aws::Connect
     #     contact_id: "ContactId", # required
     #     queue_time_adjustment_seconds: 1,
     #     queue_priority: 1,
+    #     routing_criteria: {
+    #       steps: [
+    #         {
+    #           expiry: {
+    #             duration_in_seconds: 1,
+    #           },
+    #           expression: {
+    #             attribute_condition: {
+    #               name: "PredefinedAttributeName",
+    #               value: "ProficiencyValue",
+    #               proficiency_level: 1.0,
+    #               match_criteria: {
+    #                 agents_criteria: {
+    #                   agent_ids: ["AgentId"],
+    #                 },
+    #               },
+    #               comparison_operator: "ComparisonOperator",
+    #             },
+    #             and_expression: [
+    #               {
+    #                 # recursive Expression
+    #               },
+    #             ],
+    #             or_expression: [
+    #               {
+    #                 # recursive Expression
+    #               },
+    #             ],
+    #           },
+    #         },
+    #       ],
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdateContactRoutingData AWS API Documentation
@@ -16666,7 +16971,14 @@ module Aws::Connect
     end
 
     # Updates a predefined attribute for the specified Amazon Connect
-    # instance.
+    # instance. *Predefined attributes* are attributes in an Amazon Connect
+    # instance that can be used to route contacts to an agent or pools of
+    # agents within a queue. For more information, see [Create predefined
+    # attributes for routing contacts to agents][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can find the
@@ -17406,6 +17718,16 @@ module Aws::Connect
 
     # Updates a security profile.
     #
+    # For information about security profiles, see [Security Profiles][1] in
+    # the *Amazon Connect Administrator Guide*. For a mapping of the API
+    # name and user interface name of the security profile permissions, see
+    # [List of security profile permissions][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html
+    #
     # @option params [String] :description
     #   The description of the security profile.
     #
@@ -18138,14 +18460,19 @@ module Aws::Connect
     # @api private
     def build_request(operation_name, params = {})
       handlers = @handlers.for(operation_name)
+      tracer = config.telemetry_provider.tracer_provider.tracer(
+        Aws::Telemetry.module_to_tracer_name('Aws::Connect')
+      )
       context = Seahorse::Client::RequestContext.new(
         operation_name: operation_name,
         operation: config.api.operation(operation_name),
         client: self,
         params: params,
-        config: config)
+        config: config,
+        tracer: tracer
+      )
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.169.0'
+      context[:gem_version] = '1.179.0'
       Seahorse::Client::Request.new(handlers, context)
     end