aws-sdk-connect 1.214.0 → 1.216.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb1b94f86f8a709dc06e6d040bfea92bfa8888dc53c564afab6c006e16293e17
-  data.tar.gz: 2bf2db07d70fe8d9c2ab21cfd836c662e69199a3b25098344f4114834b32c0ca
+  metadata.gz: f7ed8ace334e08f00b6707940a6769168630f90c2cef75196078549ea97c5860
+  data.tar.gz: 252fd84f609f82043d5da26ae897bfa2048c4484ac2f0d673b75171dc80bc84e
 SHA512:
-  metadata.gz: 7a26d73ccd9ff6a59c4ff205f029b1e46717e7020b2758a825c625d457899aae84285af75f894415c38657544770d2fbb660fc1d2345659eb7e59e5dd8921667
-  data.tar.gz: 3d8159b3815554a1a199238092cdc5faf1d5b7e3eb22ecfa64439f51e6a39b388ba85a1fe5524dd7e8675beb8f1f17df33a99073395476f4a132fe612f091279
+  metadata.gz: '090afef8ddb9d683196eefab1fe427344cea0604f8aee543950d7d14d82286876991dfcf5358abf9bfbd565afa6392fe4b1fb2584b5ed4fced5feb2277c4eb14'
+  data.tar.gz: 101245afc14ce431358f7434bbe78675173e3570dd7012bdddf1ac25ac5a16cf96eb9cf7655c1e3c346090d1e556243eaba8fe96472588e8285bb2f24388eec1

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.216.0 (2025-09-09)
+------------------
+
+* Feature - SDK release for user defined predefined attributes.
+
+1.215.0 (2025-08-28)
+------------------
+
+* Feature - AgentStatusDrillDown feature in GetCurrentMetricData API. Adding AGENT_STATUS as filter and grouping in GetCurrentMetricData API
+
 1.214.0 (2025-08-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.214.0
+1.216.0

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

@@ -1938,6 +1938,12 @@ module Aws::Connect
     #           },
     #         },
     #         value_integer: 1,
+    #         value_list: [
+    #           {
+    #             # recursive SegmentAttributeValue
+    #           },
+    #         ],
+    #         value_arn: "SegmentAttributeValueString",
     #       },
     #     },
     #     previous_contact_id: "ContactId",
@@ -2872,14 +2878,34 @@ module Aws::Connect
     end
 
     # Creates a new predefined attribute 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].
+    # instance. A *predefined attribute* is made up of a name and a value.
     #
+    # For the predefined attributes per instance quota, see [Amazon Connect
+    # quotas][1].
     #
+    # **Use cases**
     #
-    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
+    # Following are common uses cases for this API:
+    #
+    # * Create an attribute for routing proficiency (for example, agent
+    #   certification) that has predefined values (for example, a list of
+    #   possible certifications). For more information, see [Create
+    #   predefined attributes for routing contacts to agents][2].
+    #
+    # * Create an attribute for business unit name that has a list of
+    #   predefined business unit names used in your organization. This is a
+    #   use case where information for a contact varies between transfers or
+    #   conferences. For more information, see [Use contact segment
+    #   attributes][3].
+    #
+    # **Endpoints**: See [Amazon Connect endpoints and quotas][4].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#connect-quotas
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
+    # [3]: https://docs.aws.amazon.com/connect/latest/adminguide/use-contact-segment-attributes.html
+    # [4]: https://docs.aws.amazon.com/general/latest/gr/connect_region.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can find the
@@ -2888,9 +2914,19 @@ module Aws::Connect
     # @option params [required, String] :name
     #   The name of the predefined attribute.
     #
-    # @option params [required, Types::PredefinedAttributeValues] :values
+    # @option params [Types::PredefinedAttributeValues] :values
     #   The values of the predefined attribute.
     #
+    # @option params [Array<String>] :purposes
+    #   Values that enable you to categorize your predefined attributes. You
+    #   can use them in custom UI elements across the Amazon Connect admin
+    #   website.
+    #
+    # @option params [Types::InputPredefinedAttributeConfiguration] :attribute_configuration
+    #   Custom metadata that is associated to predefined attributes to control
+    #   behavior in upstream services, such as controlling how a predefined
+    #   attribute should be displayed in the Amazon Connect admin website.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -2898,9 +2934,13 @@ module Aws::Connect
     #   resp = client.create_predefined_attribute({
     #     instance_id: "InstanceId", # required
     #     name: "PredefinedAttributeName", # required
-    #     values: { # required
+    #     values: {
     #       string_list: ["PredefinedAttributeStringValue"],
     #     },
+    #     purposes: ["PredefinedAttributePurposeName"],
+    #     attribute_configuration: {
+    #       enable_value_validation_on_association: false,
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/CreatePredefinedAttribute AWS API Documentation
@@ -5320,8 +5360,8 @@ module Aws::Connect
     end
 
     # This API is in preview release for Amazon Connect and is subject to
-    # change. To request access to this API, contact Amazon Web
-    # ServicesSupport.
+    # change. To request access to this API, contact Amazon Web Services
+    # Support.
     #
     # Describes the target authentication profile.
     #
@@ -5543,6 +5583,9 @@ module Aws::Connect
     #   resp.contact.segment_attributes["SegmentAttributeName"].value_map #=> Hash
     #   resp.contact.segment_attributes["SegmentAttributeName"].value_map["SegmentAttributeName"] #=> Types::SegmentAttributeValue
     #   resp.contact.segment_attributes["SegmentAttributeName"].value_integer #=> Integer
+    #   resp.contact.segment_attributes["SegmentAttributeName"].value_list #=> Array
+    #   resp.contact.segment_attributes["SegmentAttributeName"].value_list[0] #=> Types::SegmentAttributeValue
+    #   resp.contact.segment_attributes["SegmentAttributeName"].value_arn #=> String
     #   resp.contact.recordings #=> Array
     #   resp.contact.recordings[0].storage_type #=> String, one of "S3", "KINESIS_VIDEO_STREAM", "KINESIS_STREAM", "KINESIS_FIREHOSE"
     #   resp.contact.recordings[0].location #=> String
@@ -6246,14 +6289,29 @@ module Aws::Connect
     end
 
     # Describes a predefined attribute 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].
+    # instance. A *predefined attribute* is made up of a name and a value.
+    # You can use predefined attributes for:
+    #
+    # * Routing proficiency (for example, agent certification) that has
+    #   predefined values (for example, a list of possible certifications).
+    #   For more information, see [Create predefined attributes for routing
+    #   contacts to agents][1].
+    #
+    # * Contact information that varies between transfers or conferences,
+    #   such as the name of the business unit handling the contact. For more
+    #   information, see [Use contact segment attributes][2].
+    #
+    # For the predefined attributes per instance quota, see [Amazon Connect
+    # quotas][3].
+    #
+    # **Endpoints**: See [Amazon Connect endpoints and quotas][4].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/use-contact-segment-attributes.html
+    # [3]: https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#connect-quotas
+    # [4]: https://docs.aws.amazon.com/general/latest/gr/connect_region.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can find the
@@ -6278,6 +6336,10 @@ module Aws::Connect
     #   resp.predefined_attribute.name #=> String
     #   resp.predefined_attribute.values.string_list #=> Array
     #   resp.predefined_attribute.values.string_list[0] #=> String
+    #   resp.predefined_attribute.purposes #=> Array
+    #   resp.predefined_attribute.purposes[0] #=> String
+    #   resp.predefined_attribute.attribute_configuration.enable_value_validation_on_association #=> Boolean
+    #   resp.predefined_attribute.attribute_configuration.is_read_only #=> Boolean
     #   resp.predefined_attribute.last_modified_time #=> Time
     #   resp.predefined_attribute.last_modified_region #=> String
     #
@@ -7847,11 +7909,16 @@ module Aws::Connect
     #
     #   * RoutingStepExpressions: 50
     #
+    #   * AgentStatuses: 50
+    #
     #   Metric data is retrieved only for the resources associated with the
     #   queues or routing profiles, and by any channels included in the
     #   filter. (You cannot filter by both queue AND routing profile.) You can
     #   include both resource IDs and resource ARNs in the same request.
     #
+    #   When using `AgentStatuses` as filter make sure Queues is added as
+    #   primary filter.
+    #
     #   When using the `RoutingStepExpression` filter, you need to pass
     #   exactly one `QueueId`. The filter is also case sensitive so when using
     #   the `RoutingStepExpression` filter, grouping by
@@ -7861,21 +7928,29 @@ module Aws::Connect
     #   in the filter.
     #
     # @option params [Array<String>] :groupings
-    #   The grouping applied to the metrics returned. For example, when
-    #   grouped by `QUEUE`, the metrics returned apply to each queue rather
-    #   than aggregated for all queues.
+    #   Defines the level of aggregation for metrics data by a dimension(s).
+    #   Its similar to sorting items into buckets based on a common
+    #   characteristic, then counting or calculating something for each
+    #   bucket. For example, when grouped by `QUEUE`, the metrics returned
+    #   apply to each queue rather than aggregated for all queues.
+    #
+    #   The grouping list is an ordered list, with the first item in the list
+    #   defined as the primary grouping. If no grouping is included in the
+    #   request, the aggregation happens at the instance-level.
     #
     #   * If you group by `CHANNEL`, you should include a Channels filter.
     #     VOICE, CHAT, and TASK channels are supported.
     #
+    #   * If you group by `AGENT_STATUS`, you must include the `QUEUE` as the
+    #     primary grouping and use queue filter. When you group by
+    #     `AGENT_STATUS`, the only metric available is the `AGENTS_ONLINE`
+    #     metric.
+    #
     #   * If you group by `ROUTING_PROFILE`, you must include either a queue
     #     or routing profile filter. In addition, a routing profile filter is
     #     required for metrics `CONTACTS_SCHEDULED`, `CONTACTS_IN_QUEUE`, and
     #     ` OLDEST_CONTACT_AGE`.
     #
-    #   * If no `Grouping` is included in the request, a summary of metrics is
-    #     returned.
-    #
     #   * When using the `RoutingStepExpression` filter, group by
     #     `ROUTING_STEP_EXPRESSION` is required.
     #
@@ -8039,8 +8114,9 @@ module Aws::Connect
     #       channels: ["VOICE"], # accepts VOICE, CHAT, TASK, EMAIL
     #       routing_profiles: ["RoutingProfileId"],
     #       routing_step_expressions: ["RoutingExpression"],
+    #       agent_statuses: ["AgentStatusId"],
     #     },
-    #     groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE, ROUTING_STEP_EXPRESSION
+    #     groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE, ROUTING_STEP_EXPRESSION, AGENT_STATUS
     #     current_metrics: [ # required
     #       {
     #         name: "AGENTS_ONLINE", # accepts AGENTS_ONLINE, AGENTS_AVAILABLE, AGENTS_ON_CALL, AGENTS_NON_PRODUCTIVE, AGENTS_AFTER_CONTACT_WORK, AGENTS_ERROR, AGENTS_STAFFED, CONTACTS_IN_QUEUE, OLDEST_CONTACT_AGE, CONTACTS_SCHEDULED, AGENTS_ON_CONTACT, SLOTS_ACTIVE, SLOTS_AVAILABLE
@@ -8067,6 +8143,8 @@ module Aws::Connect
     #   resp.metric_results[0].dimensions.routing_profile.id #=> String
     #   resp.metric_results[0].dimensions.routing_profile.arn #=> String
     #   resp.metric_results[0].dimensions.routing_step_expression #=> String
+    #   resp.metric_results[0].dimensions.agent_status.arn #=> String
+    #   resp.metric_results[0].dimensions.agent_status.id #=> String
     #   resp.metric_results[0].collections #=> Array
     #   resp.metric_results[0].collections[0].metric.name #=> String, one of "AGENTS_ONLINE", "AGENTS_AVAILABLE", "AGENTS_ON_CALL", "AGENTS_NON_PRODUCTIVE", "AGENTS_AFTER_CONTACT_WORK", "AGENTS_ERROR", "AGENTS_STAFFED", "CONTACTS_IN_QUEUE", "OLDEST_CONTACT_AGE", "CONTACTS_SCHEDULED", "AGENTS_ON_CONTACT", "SLOTS_ACTIVE", "SLOTS_AVAILABLE"
     #   resp.metric_results[0].collections[0].metric.unit #=> String, one of "SECONDS", "COUNT", "PERCENT"
@@ -8701,8 +8779,9 @@ module Aws::Connect
     #       channels: ["VOICE"], # accepts VOICE, CHAT, TASK, EMAIL
     #       routing_profiles: ["RoutingProfileId"],
     #       routing_step_expressions: ["RoutingExpression"],
+    #       agent_statuses: ["AgentStatusId"],
     #     },
-    #     groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE, ROUTING_STEP_EXPRESSION
+    #     groupings: ["QUEUE"], # accepts QUEUE, CHANNEL, ROUTING_PROFILE, ROUTING_STEP_EXPRESSION, AGENT_STATUS
     #     historical_metrics: [ # required
     #       {
     #         name: "CONTACTS_QUEUED", # accepts CONTACTS_QUEUED, CONTACTS_HANDLED, CONTACTS_ABANDONED, CONTACTS_CONSULTED, CONTACTS_AGENT_HUNG_UP_FIRST, CONTACTS_HANDLED_INCOMING, CONTACTS_HANDLED_OUTBOUND, CONTACTS_HOLD_ABANDONS, CONTACTS_TRANSFERRED_IN, CONTACTS_TRANSFERRED_OUT, CONTACTS_TRANSFERRED_IN_FROM_QUEUE, CONTACTS_TRANSFERRED_OUT_FROM_QUEUE, CONTACTS_MISSED, CALLBACK_CONTACTS_HANDLED, API_CONTACTS_HANDLED, OCCUPANCY, HANDLE_TIME, AFTER_CONTACT_WORK_TIME, QUEUED_TIME, ABANDON_TIME, QUEUE_ANSWER_TIME, HOLD_TIME, INTERACTION_TIME, INTERACTION_AND_HOLD_TIME, SERVICE_LEVEL
@@ -8728,6 +8807,8 @@ module Aws::Connect
     #   resp.metric_results[0].dimensions.routing_profile.id #=> String
     #   resp.metric_results[0].dimensions.routing_profile.arn #=> String
     #   resp.metric_results[0].dimensions.routing_step_expression #=> String
+    #   resp.metric_results[0].dimensions.agent_status.arn #=> String
+    #   resp.metric_results[0].dimensions.agent_status.id #=> String
     #   resp.metric_results[0].collections #=> Array
     #   resp.metric_results[0].collections[0].metric.name #=> String, one of "CONTACTS_QUEUED", "CONTACTS_HANDLED", "CONTACTS_ABANDONED", "CONTACTS_CONSULTED", "CONTACTS_AGENT_HUNG_UP_FIRST", "CONTACTS_HANDLED_INCOMING", "CONTACTS_HANDLED_OUTBOUND", "CONTACTS_HOLD_ABANDONS", "CONTACTS_TRANSFERRED_IN", "CONTACTS_TRANSFERRED_OUT", "CONTACTS_TRANSFERRED_IN_FROM_QUEUE", "CONTACTS_TRANSFERRED_OUT_FROM_QUEUE", "CONTACTS_MISSED", "CALLBACK_CONTACTS_HANDLED", "API_CONTACTS_HANDLED", "OCCUPANCY", "HANDLE_TIME", "AFTER_CONTACT_WORK_TIME", "QUEUED_TIME", "ABANDON_TIME", "QUEUE_ANSWER_TIME", "HOLD_TIME", "INTERACTION_TIME", "INTERACTION_AND_HOLD_TIME", "SERVICE_LEVEL"
     #   resp.metric_results[0].collections[0].metric.threshold.comparison #=> String, one of "LT"
@@ -10791,7 +10872,7 @@ module Aws::Connect
     # service level quota of 99 phone numbers, and in any 180 day period you
     # release 99, claim 99, and then release 99, you will have exceeded the
     # 200% limit. At that point you are blocked from claiming any more
-    # numbers until you open an Amazon Web ServicesSupport ticket.
+    # numbers until you open an Amazon Web Services Support ticket.
     #
     #
     #
@@ -11135,8 +11216,8 @@ module Aws::Connect
     end
 
     # This API is in preview release for Amazon Connect and is subject to
-    # change. To request access to this API, contact Amazon Web
-    # ServicesSupport.
+    # change. To request access to this API, contact Amazon Web Services
+    # Support.
     #
     # Provides summary information about the authentication profiles in a
     # specified Amazon Connect instance.
@@ -12470,14 +12551,29 @@ 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].
+    # A *predefined attribute* is made up of a name and a value. You can use
+    # predefined attributes for:
+    #
+    # * Routing proficiency (for example, agent certification) that has
+    #   predefined values (for example, a list of possible certifications).
+    #   For more information, see [Create predefined attributes for routing
+    #   contacts to agents][1].
+    #
+    # * Contact information that varies between transfers or conferences,
+    #   such as the name of the business unit handling the contact. For more
+    #   information, see [Use contact segment attributes][2].
+    #
+    # For the predefined attributes per instance quota, see [Amazon Connect
+    # quotas][3].
+    #
+    # **Endpoints**: See [Amazon Connect endpoints and quotas][4].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/use-contact-segment-attributes.html
+    # [3]: https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#connect-quotas
+    # [4]: https://docs.aws.amazon.com/general/latest/gr/connect_region.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can find the
@@ -14008,7 +14104,7 @@ module Aws::Connect
     #  After releasing a phone number, the phone number enters into a
     # cooldown period for up to 180 days. It cannot be searched for or
     # claimed again until the period has ended. If you accidentally release
-    # a phone number, contact Amazon Web ServicesSupport.
+    # a phone number, contact Amazon Web Services Support.
     #
     # If you plan to claim and release numbers frequently, contact us for a
     # service quota exception. Otherwise, it is possible you will be blocked
@@ -15051,15 +15147,30 @@ module Aws::Connect
       req.send_request(options)
     end
 
-    # 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].
+    # Searches predefined attributes that meet certain criteria. A
+    # *predefined attribute* is made up of a name and a value. You can use
+    # predefined attributes for:
+    #
+    # * Routing proficiency (for example, agent certification) that has
+    #   predefined values (for example, a list of possible certifications).
+    #   For more information, see [Create predefined attributes for routing
+    #   contacts to agents][1].
+    #
+    # * Contact information that varies between transfers or conferences,
+    #   such as the name of the business unit handling the contact. For more
+    #   information, see [Use contact segment attributes][2].
+    #
+    # For the predefined attributes per instance quota, see [Amazon Connect
+    # quotas][3].
+    #
+    # **Endpoints**: See [Amazon Connect endpoints and quotas][4].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/use-contact-segment-attributes.html
+    # [3]: https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#connect-quotas
+    # [4]: https://docs.aws.amazon.com/general/latest/gr/connect_region.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can find the
@@ -15115,6 +15226,10 @@ module Aws::Connect
     #   resp.predefined_attributes[0].name #=> String
     #   resp.predefined_attributes[0].values.string_list #=> Array
     #   resp.predefined_attributes[0].values.string_list[0] #=> String
+    #   resp.predefined_attributes[0].purposes #=> Array
+    #   resp.predefined_attributes[0].purposes[0] #=> String
+    #   resp.predefined_attributes[0].attribute_configuration.enable_value_validation_on_association #=> Boolean
+    #   resp.predefined_attributes[0].attribute_configuration.is_read_only #=> Boolean
     #   resp.predefined_attributes[0].last_modified_time #=> Time
     #   resp.predefined_attributes[0].last_modified_region #=> String
     #   resp.next_token #=> String
@@ -16513,8 +16628,8 @@ module Aws::Connect
     #
     # If you use the `ChatDurationInMinutes` parameter and receive a 400
     # error, your account may not support the ability to configure custom
-    # chat durations. For more information, contact Amazon Web
-    # ServicesSupport.
+    # chat durations. For more information, contact Amazon Web Services
+    # Support.
     #
     # For more information about chat, see the following topics in the
     # *Amazon Connect Administrator Guide*:
@@ -16683,6 +16798,12 @@ module Aws::Connect
     #           },
     #         },
     #         value_integer: 1,
+    #         value_list: [
+    #           {
+    #             # recursive SegmentAttributeValue
+    #           },
+    #         ],
+    #         value_arn: "SegmentAttributeValueString",
     #       },
     #     },
     #     customer_id: "CustomerIdNonEmpty",
@@ -17079,6 +17200,12 @@ module Aws::Connect
     #           },
     #         },
     #         value_integer: 1,
+    #         value_list: [
+    #           {
+    #             # recursive SegmentAttributeValue
+    #           },
+    #         ],
+    #         value_arn: "SegmentAttributeValueString",
     #       },
     #     },
     #     client_token: "ClientToken",
@@ -17239,6 +17366,12 @@ module Aws::Connect
     #           },
     #         },
     #         value_integer: 1,
+    #         value_list: [
+    #           {
+    #             # recursive SegmentAttributeValue
+    #           },
+    #         ],
+    #         value_arn: "SegmentAttributeValueString",
     #       },
     #     },
     #     attributes: {
@@ -17800,6 +17933,12 @@ module Aws::Connect
     #           },
     #         },
     #         value_integer: 1,
+    #         value_list: [
+    #           {
+    #             # recursive SegmentAttributeValue
+    #           },
+    #         ],
+    #         value_arn: "SegmentAttributeValueString",
     #       },
     #     },
     #   })
@@ -18511,8 +18650,8 @@ module Aws::Connect
     end
 
     # This API is in preview release for Amazon Connect and is subject to
-    # change. To request access to this API, contact Amazon Web
-    # ServicesSupport.
+    # change. To request access to this API, contact Amazon Web Services
+    # Support.
     #
     # Updates the selected authentication profile.
     #
@@ -18630,8 +18769,9 @@ module Aws::Connect
     #   This field can be used to show channel subtype, such as
     #   `connect:Guide`.
     #
-    #   Currently Contact Expiry is the only segment attribute which can be
-    #   updated by using the UpdateContact API.
+    #   Contact Expiry, and user-defined attributes (String - String) that are
+    #   defined in predefined attributes, can be updated by using the
+    #   UpdateContact API.
     #
     # @option params [Types::QueueInfoInput] :queue_info
     #   Information about the queue associated with a contact. This parameter
@@ -18704,6 +18844,12 @@ module Aws::Connect
     #           },
     #         },
     #         value_integer: 1,
+    #         value_list: [
+    #           {
+    #             # recursive SegmentAttributeValue
+    #           },
+    #         ],
+    #         value_arn: "SegmentAttributeValueString",
     #       },
     #     },
     #     queue_info: {
@@ -19608,7 +19754,7 @@ module Aws::Connect
     #   The type of attribute.
     #
     #   <note markdown="1"> Only allowlisted customers can consume USE\_CUSTOM\_TTS\_VOICES. To
-    #   access this feature, contact Amazon Web ServicesSupport for
+    #   access this feature, contact Amazon Web Services Support for
     #   allowlisting.
     #
     #    </note>
@@ -19987,14 +20133,34 @@ module Aws::Connect
     end
 
     # Updates a predefined attribute 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].
+    # instance. A *predefined attribute* is made up of a name and a value.
     #
+    # For the predefined attributes per instance quota, see [Amazon Connect
+    # quotas][1].
     #
+    # **Use cases**
     #
-    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
+    # Following are common uses cases for this API:
+    #
+    # * Update routing proficiency (for example, agent certification) that
+    #   has predefined values (for example, a list of possible
+    #   certifications). For more information, see [Create predefined
+    #   attributes for routing contacts to agents][2].
+    #
+    # * Update an attribute for business unit name that has a list of
+    #   predefined business unit names used in your organization. This is a
+    #   use case where information for a contact varies between transfers or
+    #   conferences. For more information, see [Use contact segment
+    #   attributes][3].
+    #
+    # **Endpoints**: See [Amazon Connect endpoints and quotas][4].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#connect-quotas
+    # [2]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html
+    # [3]: https://docs.aws.amazon.com/connect/latest/adminguide/use-contact-segment-attributes.html
+    # [4]: https://docs.aws.amazon.com/general/latest/gr/connect_region.html
     #
     # @option params [required, String] :instance_id
     #   The identifier of the Amazon Connect instance. You can find the
@@ -20006,6 +20172,16 @@ module Aws::Connect
     # @option params [Types::PredefinedAttributeValues] :values
     #   The values of the predefined attribute.
     #
+    # @option params [Array<String>] :purposes
+    #   Values that enable you to categorize your predefined attributes. You
+    #   can use them in custom UI elements across the Amazon Connect admin
+    #   website.
+    #
+    # @option params [Types::InputPredefinedAttributeConfiguration] :attribute_configuration
+    #   Custom metadata that is associated to predefined attributes to control
+    #   behavior in upstream services, such as controlling how a predefined
+    #   attribute should be displayed in the Amazon Connect admin website.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -20016,6 +20192,10 @@ module Aws::Connect
     #     values: {
     #       string_list: ["PredefinedAttributeStringValue"],
     #     },
+    #     purposes: ["PredefinedAttributePurposeName"],
+    #     attribute_configuration: {
+    #       enable_value_validation_on_association: false,
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdatePredefinedAttribute AWS API Documentation
@@ -21543,7 +21723,7 @@ module Aws::Connect
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-connect'
-      context[:gem_version] = '1.214.0'
+      context[:gem_version] = '1.216.0'
       Seahorse::Client::Request.new(handlers, context)
     end