AWS cli documentation change
Summary
Updated command syntax, parameter ordering, field constraints, and documentation structure for AWS CLI 2.31.5. Changes include reordering parameters (--template-id became required before --client-token), modifying domain-id constraints (min:1, max:500), adjusting regex patterns for userArn validation, and correcting output field names (caseArn/caseId swap).
Security assessment
No explicit security vulnerability or incident is referenced. Changes involve documentation corrections (parameter order, regex pattern adjustments), validation tightening (domain-id min constraint), and output field labeling fixes. While domain-id min:1 prevents empty values, there's no evidence this addressed a security flaw. Regex pattern changes removed start/end anchors but lack context about security implications.
Diff
diff --git a/cli/latest/reference/connectcases/create-case.md b/cli/latest/reference/connectcases/create-case.md index 11dd77e2d..7900d494a 100644 --- a//cli/latest/reference/connectcases/create-case.md +++ b//cli/latest/reference/connectcases/create-case.md @@ -15 +15 @@ - * [AWS CLI 2.31.3 Command Reference](../../index.html) » + * [AWS CLI 2.31.5 Command Reference](../../index.html) » @@ -78 +77,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec - [--client-token <value>] @@ -79,0 +79 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec + --template-id <value> @@ -80,0 +81 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec + [--client-token <value>] @@ -82 +82,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec - --template-id <value> @@ -107 +107 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec -`--client-token` (string) +`--domain-id` (string) [required] @@ -109 +109 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec -> A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see [Making retries safe with idempotent APIs](https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/) . +> The unique identifier of the Cases domain. @@ -113,2 +113,2 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec -> * min: `0` -> * max: `64` +> * min: `1` +> * max: `500` @@ -118 +118 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec -`--domain-id` (string) [required] +`--template-id` (string) [required] @@ -120 +120 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/connec -> The unique identifier of the Cases domain. +> A unique identifier of a template. @@ -161,13 +161 @@ 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`. @@ -184,0 +173,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. @@ -193 +193 @@ Shorthand Syntax: - id=string,value={booleanValue=boolean,doubleValue=double,emptyValue={},stringValue=string,userArnValue=string} ... + id=string,value={stringValue=string,doubleValue=double,booleanValue=boolean,emptyValue={},userArnValue=string} ... @@ -203 +203 @@ JSON Syntax: - "booleanValue": true|false, + "stringValue": "string", @@ -204,0 +205 @@ JSON Syntax: + "booleanValue": true|false, @@ -208 +208,0 @@ JSON Syntax: - "stringValue": "string", @@ -215,0 +216,11 @@ JSON Syntax: +`--client-token` (string) + +> A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see [Making retries safe with idempotent APIs](https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/) . +> +> Constraints: +> +> * min: `0` +> * max: `64` +> + + @@ -222 +233 @@ JSON Syntax: -> This is a Tagged Union structure. Only one of the following top level keys can be set: `customEntity`, `userArn`. +> This is a Tagged Union structure. Only one of the following top level keys can be set: `userArn`, `customEntity`. @@ -224 +235 @@ JSON Syntax: -> customEntity -> (string) +> userArn -> (string) @@ -226 +237 @@ JSON Syntax: ->> Any provided entity. +>> Represents the Amazon Connect ARN of the user. @@ -232 +242,0 @@ JSON Syntax: ->> * pattern: `^[a-zA-Z0-9_\-\.@:/ ]*[a-zA-Z0-9_\-\.@:/]$` @@ -236 +246 @@ JSON Syntax: -> userArn -> (string) +> customEntity -> (string) @@ -238 +248 @@ JSON Syntax: ->> Represents the Amazon Connect ARN of the user. +>> Any provided entity. @@ -243,0 +254 @@ JSON Syntax: +>> * pattern: `[a-zA-Z0-9_\-\.@:/ ]*[a-zA-Z0-9_\-\.@:/]` @@ -250 +261 @@ Shorthand Syntax: - customEntity=string,userArn=string + userArn=string,customEntity=string @@ -257,2 +268,2 @@ JSON Syntax: - "customEntity": "string", - "userArn": "string" + "userArn": "string", + "customEntity": "string" @@ -262,11 +272,0 @@ JSON Syntax: -`--template-id` (string) [required] - -> A unique identifier of a template. -> -> Constraints: -> -> * min: `1` -> * max: `500` -> - - @@ -372 +372 @@ Disable automatically prompt for CLI input parameters. -caseArn -> (string) +caseId -> (string) @@ -374 +374 @@ caseArn -> (string) -> The Amazon Resource Name (ARN) of the case. +> A unique identifier of the case. @@ -383 +383 @@ caseArn -> (string) -caseId -> (string) +caseArn -> (string) @@ -385 +385 @@ caseId -> (string) -> A unique identifier of the case. +> The Amazon Resource Name (ARN) of the case. @@ -404 +404 @@ caseId -> (string) - * [AWS CLI 2.31.3 Command Reference](../../index.html) » + * [AWS CLI 2.31.5 Command Reference](../../index.html) »