AWS cli documentation change
Summary
Updated CLI command documentation for create-related-item, including parameter reordering, added 'connectCase' and 'custom' related item types, enhanced field validation patterns, and structural changes to JSON syntax examples
Security assessment
The changes introduce documentation for new 'custom' type with userArnValue field to track auditing users, which enhances security visibility. However, there is no evidence of addressing a specific security vulnerability. Validation pattern improvements (e.g., .*[\S] for non-empty strings) improve input sanitization but aren't explicitly tied to a disclosed security issue.
Diff
diff --git a/cli/latest/reference/connectcases/create-related-item.md b/cli/latest/reference/connectcases/create-related-item.md index 487e66432..0dac5a876 100644 --- a//cli/latest/reference/connectcases/create-related-item.md +++ b//cli/latest/reference/connectcases/create-related-item.md @@ -15 +15 @@ - * [AWS CLI 2.31.3 Command Reference](../../index.html) » + * [AWS CLI 2.31.5 Command Reference](../../index.html) » @@ -74,0 +75 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec + --domain-id <value> @@ -75,0 +77 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec + --type <value> @@ -77 +78,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec - --domain-id <value> @@ -79 +79,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec - --type <value> @@ -103,0 +104,11 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec +`--domain-id` (string) [required] + +> The unique identifier of the Cases domain. +> +> Constraints: +> +> * min: `1` +> * max: `500` +> + + @@ -114,0 +126,15 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec +`--type` (string) [required] + +> The type of a related item. +> +> Possible values: +> +> * `Contact` +> * `Comment` +> * `File` +> * `Sla` +> * `ConnectCase` +> * `Custom` +> + + @@ -121 +147,16 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec -> This is a Tagged Union structure. Only one of the following top level keys can be set: `comment`, `contact`, `file`, `sla`. +> This is a Tagged Union structure. Only one of the following top level keys can be set: `contact`, `comment`, `file`, `sla`, `connectCase`, `custom`. +> +> contact -> (structure) +> +>> Object representing a contact in Amazon Connect as an API request field. +>> +>> contactArn -> (string) [required] +>> +>>> A unique identifier of a contact in Amazon Connect. +>>> +>>> Constraints: +>>> +>>> * min: `1` +>>> * max: `500` +>>> + @@ -147,15 +187,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec -> -> contact -> (structure) -> ->> Object representing a contact in Amazon Connect as an API request field. ->> ->> contactArn -> (string) [required] ->> ->>> A unique identifier of a contact in Amazon Connect. ->>> ->>> Constraints: ->>> ->>> * min: `1` ->>> * max: `500` ->>> - @@ -190 +216 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec ->>> fieldId -> (string) +>>> name -> (string) [required] @@ -192 +218 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec ->>>> Unique identifier of a field. +>>>> Name of an SLA. @@ -197,0 +224 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec +>>>> * pattern: `.*[\S]` @@ -201 +228 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec ->>> name -> (string) [required] +>>> type -> (string) [required] @@ -203 +230,11 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec ->>>> Name of an SLA. +>>>> Type of SLA. +>>>> +>>>> Possible values: +>>>> +>>>> * `CaseField` +>>>> + +>>> +>>> fieldId -> (string) +>>> +>>>> Unique identifier of a field. @@ -209 +245,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec ->>>> * pattern: `^.*[\S]$` @@ -234,13 +270 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec ->>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `booleanValue`, `doubleValue`, `emptyValue`, `stringValue`, `userArnValue`. ->>>>> ->>>>> booleanValue -> (boolean) ->>>>> ->>>>>> Can be either null, or have a Boolean value type. Only one value can be provided. ->>>>> ->>>>> doubleValue -> (double) ->>>>> ->>>>>> Can be either null, or have a Double number value type. Only one value can be provided. ->>>>> ->>>>> emptyValue -> (structure) ->>>>> ->>>>>> An empty value. +>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `stringValue`, `doubleValue`, `booleanValue`, `emptyValue`, `userArnValue`. @@ -257,0 +282,12 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec +>>>>> +>>>>> doubleValue -> (double) +>>>>> +>>>>>> Can be either null, or have a Double number value type. Only one value can be provided. +>>>>> +>>>>> booleanValue -> (boolean) +>>>>> +>>>>>> Can be either null, or have a Boolean value type. Only one value can be provided. +>>>>> +>>>>> emptyValue -> (structure) +>>>>> +>>>>>> An empty value. @@ -272,0 +309,8 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec +> +> connectCase -> (structure) +> +>> Input content for a related Connect case +>> +>> caseId -> (string) [required] +>> +>>> The unique identifier of the case to be related @@ -274 +318 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec ->>> type -> (string) [required] +>>> Constraints: @@ -276 +320,23 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec ->>>> Type of SLA. +>>> * min: `1` +>>> * max: `500` +>>> + +> +> custom -> (structure) +> +>> Input content for a custom related item +>> +>> fields -> (list) [required] +>> +>>> List of field values for the custom related item +>>> +>>> Constraints: +>>> +>>> * min: `1` +>>> * max: `50` +>>> + +>>> +>>> (structure) +>>> +>>>> Object for case field values. @@ -278 +344 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec ->>>> Possible values: +>>>> id -> (string) [required] @@ -280 +346,10 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec ->>>> * `CaseField` +>>>>> Unique identifier of a field. +>>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `1` +>>>>> * max: `500` +>>>>> + +>>>> +>>>> value -> (tagged union structure) [required] @@ -281,0 +357,15 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec +>>>>> Union of potential field value types. +>>>>> +>>>>> ### Note +>>>>> +>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `stringValue`, `doubleValue`, `booleanValue`, `emptyValue`, `userArnValue`. +>>>>> +>>>>> stringValue -> (string) +>>>>> +>>>>>> String value type. +>>>>>> +>>>>>> Constraints: +>>>>>> +>>>>>> * min: `0` +>>>>>> * max: `3000` +>>>>>> @@ -282,0 +373,16 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec