AWS cli documentation change
Summary
Added documentation for new parameters (--purposes, --attribute-configuration) and expanded use cases for predefined attributes
Security assessment
Introduces EnableValueValidationOnAssociation configuration that enforces strict validation of predefined attribute values, helping prevent invalid/malformed data storage. While not addressing a specific vulnerability, this adds security documentation about validation controls.
Diff
diff --git a/cli/latest/reference/connect/create-predefined-attribute.md b/cli/latest/reference/connect/create-predefined-attribute.md index 2b06b9342..d7a16b150 100644 --- a//cli/latest/reference/connect/create-predefined-attribute.md +++ b//cli/latest/reference/connect/create-predefined-attribute.md @@ -15 +15 @@ - * [AWS CLI 2.28.25 Command Reference](../../index.html) » + * [AWS CLI 2.29.0 Command Reference](../../index.html) » @@ -59 +59,14 @@ First time using the AWS CLI? See the [User Guide](https://docs.aws.amazon.com/c -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](https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html) . +Creates a new predefined attribute for the specified Amazon Connect instance. A _predefined attribute_ is made up of a name and a value. + +For the predefined attributes per instance quota, see [Amazon Connect quotas](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#connect-quotas) . + +> **Use cases** + +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](https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html) . + * 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](https://docs.aws.amazon.com/connect/latest/adminguide/use-contact-segment-attributes.html) . + + + +> **Endpoints** : See [Amazon Connect endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/connect_region.html) . @@ -69 +82,3 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec - --values <value> + [--values <value>] + [--purposes <value>] + [--attribute-configuration <value>] @@ -129,0 +145,34 @@ JSON Syntax: +`--purposes` (list) + +> Values that enable you to categorize your predefined attributes. You can use them in custom UI elements across the Amazon Connect admin website. +> +> (string) + +Syntax: + + + "string" "string" ... + + +`--attribute-configuration` (structure) + +> 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. +> +> EnableValueValidationOnAssociation -> (boolean) +> +>> When this parameter is set to true, Amazon Connect enforces strict validation on the specific values, if the values are predefined in attributes. The contact will store only valid and predefined values for the predefined attribute key. + +Shorthand Syntax: + + + EnableValueValidationOnAssociation=boolean + + +JSON Syntax: + + + { + "EnableValueValidationOnAssociation": true|false + } + + @@ -241 +290 @@ None - * [AWS CLI 2.28.25 Command Reference](../../index.html) » + * [AWS CLI 2.29.0 Command Reference](../../index.html) »