AWS cli documentation change
Summary
Updated CLI reference documentation for list-flow-execution-events command with parameter reordering, pattern constraint changes, and expanded event type definitions including detailed tracing structures for flow executions.
Security assessment
The changes primarily involve structural reorganization of parameters, updated regex patterns for input validation, and expanded documentation of event types and tracing capabilities. While pattern constraints (e.g., arn formats) improve input validation, there's no explicit evidence of addressing a specific security vulnerability. The added tracing features support observability but aren't explicitly security-focused.
Diff
diff --git a/cli/latest/reference/bedrock-agent-runtime/list-flow-execution-events.md b/cli/latest/reference/bedrock-agent-runtime/list-flow-execution-events.md index 5cbe70676..1ddfcd5c8 100644 --- a//cli/latest/reference/bedrock-agent-runtime/list-flow-execution-events.md +++ b//cli/latest/reference/bedrock-agent-runtime/list-flow-execution-events.md @@ -15 +15 @@ - * [AWS CLI 2.31.1 Command Reference](../../index.html) » + * [AWS CLI 2.31.3 Command Reference](../../index.html) » @@ -75,3 +74,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc - --event-type <value> - --execution-identifier <value> - --flow-alias-identifier <value> @@ -78,0 +76,3 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc + --flow-alias-identifier <value> + --execution-identifier <value> + --event-type <value> @@ -106 +106 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -`--event-type` (string) [required] +`--flow-identifier` (string) [required] @@ -108 +108 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> The type of events to retrieve. Specify `Node` for node-level events or `Flow` for flow-level events. +> The unique identifier of the flow. @@ -110 +110 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> Possible values: +> Constraints: @@ -112,2 +112,3 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> * `Node` -> * `Flow` +> * min: `0` +> * max: `2048` +> * pattern: `(arn:aws:bedrock:[a-z0-9-]{1,20}:[0-9]{12}:flow/[0-9a-zA-Z]{10})|([0-9a-zA-Z]{10})` @@ -117 +118 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -`--execution-identifier` (string) [required] +`--flow-alias-identifier` (string) [required] @@ -119 +120 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> The unique identifier of the flow execution. +> The unique identifier of the flow alias used for the execution. @@ -125 +126 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> * pattern: `^[a-zA-Z0-9-]{1,36}$|^(arn:aws:bedrock:[a-z0-9-]{1,20}:[0-9]{12}:flow/[0-9a-zA-Z]{10}/alias/[0-9a-zA-Z]{10}/execution/[a-zA-Z0-9-]{1,36})$` +> * pattern: `(arn:aws:bedrock:[a-z0-9-]{1,20}:[0-9]{12}:flow/[0-9a-zA-Z]{10}/alias/[0-9a-zA-Z]{10})|(\bTSTALIASID\b|[0-9a-zA-Z]+)` @@ -129 +130 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -`--flow-alias-identifier` (string) [required] +`--execution-identifier` (string) [required] @@ -131 +132 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> The unique identifier of the flow alias used for the execution. +> The unique identifier of the flow execution. @@ -137 +138 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> * pattern: `^(arn:aws:bedrock:[a-z0-9-]{1,20}:[0-9]{12}:flow/[0-9a-zA-Z]{10}/alias/[0-9a-zA-Z]{10})|(\bTSTALIASID\b|[0-9a-zA-Z]+)$` +> * pattern: `[a-zA-Z0-9-]{1,36}$|^(arn:aws:bedrock:[a-z0-9-]{1,20}:[0-9]{12}:flow/[0-9a-zA-Z]{10}/alias/[0-9a-zA-Z]{10}/execution/[a-zA-Z0-9-]{1,36})` @@ -141 +142 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -`--flow-identifier` (string) [required] +`--event-type` (string) [required] @@ -143 +144 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> The unique identifier of the flow. +> The type of events to retrieve. Specify `Node` for node-level events or `Flow` for flow-level events. @@ -145 +146 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> Constraints: +> Possible values: @@ -147,3 +148,2 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/bedroc -> * min: `0` -> * max: `2048` -> * pattern: `^(arn:aws:bedrock:[a-z0-9-]{1,20}:[0-9]{12}:flow/[0-9a-zA-Z]{10})|([0-9a-zA-Z]{10})$` +> * `Node` +> * `Flow` @@ -291 +291 @@ flowExecutionEvents -> (list) ->> This is a Tagged Union structure. Only one of the following top level keys can be set: `conditionResultEvent`, `flowFailureEvent`, `flowInputEvent`, `flowOutputEvent`, `nodeFailureEvent`, `nodeInputEvent`, `nodeOutputEvent`. +>> This is a Tagged Union structure. Only one of the following top level keys can be set: `flowInputEvent`, `flowOutputEvent`, `nodeInputEvent`, `nodeOutputEvent`, `conditionResultEvent`, `nodeFailureEvent`, `flowFailureEvent`, `nodeActionEvent`, `nodeDependencyEvent`. @@ -293 +293 @@ flowExecutionEvents -> (list) ->> conditionResultEvent -> (structure) +>> flowInputEvent -> (structure) @@ -295 +295 @@ flowExecutionEvents -> (list) ->>> Contains information about a condition evaluation result during the flow execution. This event is generated when a condition node in the flow evaluates its conditions. +>>> Contains information about the inputs provided to the flow at the start of execution. @@ -299 +299 @@ flowExecutionEvents -> (list) ->>>> The name of the condition node that evaluated the conditions. +>>>> The name of the node that receives the inputs. @@ -303 +303 @@ flowExecutionEvents -> (list) ->>>> * pattern: `^[a-zA-Z]([_]?[0-9a-zA-Z]){0,99}$` +>>>> * pattern: `[a-zA-Z]([_]?[0-9a-zA-Z]){0,99}` @@ -307 +307 @@ flowExecutionEvents -> (list) ->>> satisfiedConditions -> (list) [required] +>>> timestamp -> (timestamp) [required] @@ -309 +309,5 @@ flowExecutionEvents -> (list) ->>>> A list of conditions that were satisfied during the evaluation. +>>>> The timestamp when the inputs are provided. +>>> +>>> fields -> (list) [required] +>>> +>>>> A list of input fields provided to the flow. @@ -320 +324 @@ flowExecutionEvents -> (list) ->>>>> Represents a condition that was satisfied during a condition node evaluation in a flow execution. +>>>>> Represents an input field provided to a flow during a flow execution. @@ -326 +330 @@ flowExecutionEvents -> (list) ->>>>> conditionName -> (string) [required] +>>>>> name -> (string) [required] @@ -328,5 +332,19 @@ flowExecutionEvents -> (list) ->>>>>> The name of the condition that was satisfied. ->>> ->>> timestamp -> (timestamp) [required] ->>> ->>>> The timestamp when the condition evaluation occurred. +>>>>>> The name of the input field as defined in the flow’s input schema. +>>>>>> +>>>>>> Constraints: +>>>>>> +>>>>>> * pattern: `[a-zA-Z]([_]?[0-9a-zA-Z]){0,99}` +>>>>>> + +>>>>> +>>>>> content -> (tagged union structure) [required] +>>>>> +>>>>>> The content of the input field, which can contain text or structured data. +>>>>>> +>>>>>> ### Note +>>>>>> +>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `document`. +>>>>>> +>>>>>> document -> (document) +>>>>>> +>>>>>>> The document content of the field, which can contain text or structured data. @@ -334 +352 @@ flowExecutionEvents -> (list) ->> flowFailureEvent -> (structure) +>> flowOutputEvent -> (structure) @@ -336 +354 @@ flowExecutionEvents -> (list) ->>> Contains information about a failure that occurred at the flow level during execution. +>>> Contains information about the outputs produced by the flow at the end of execution. @@ -338 +356 @@ flowExecutionEvents -> (list) ->>> errorCode -> (string) [required] +>>> nodeName -> (string) [required] @@ -340 +358 @@ flowExecutionEvents -> (list) ->>>> The error code that identifies the type of failure that occurred. +>>>> The name of the node that produces the outputs. @@ -342 +360 @@ flowExecutionEvents -> (list) ->>>> Possible values: +>>>> Constraints: @@ -344,3 +362 @@ flowExecutionEvents -> (list) ->>>> * `VALIDATION` ->>>> * `INTERNAL_SERVER` ->>>> * `NODE_EXECUTION_FAILED` +>>>> * pattern: `[a-zA-Z]([_]?[0-9a-zA-Z]){0,99}` @@ -349,4 +364,0 @@ flowExecutionEvents -> (list) ->>> ->>> errorMessage -> (string) [required] ->>> ->>>> A descriptive message that provides details about the failure. @@ -356,5 +368 @@ flowExecutionEvents -> (list) ->>>> The timestamp when the failure occurred. ->> ->> flowInputEvent -> (structure) ->> ->>> Contains information about the inputs provided to the flow at the start of execution. +>>>> The timestamp when the outputs are produced. @@ -364 +372 @@ flowExecutionEvents -> (list) ->>>> A list of input fields provided to the flow. +>>>> A list of output fields produced by the flow. @@ -375 +383 @@ flowExecutionEvents -> (list) ->>>>> Represents an input field provided to a flow during a flow execution. +>>>>> Represents an output field produced by a flow during a flow execution. @@ -379,0 +388,10 @@ flowExecutionEvents -> (list) +>>>>> +>>>>> name -> (string) [required] +>>>>> +>>>>>> The name of the output field as defined in the flow’s output schema. +>>>>>> +>>>>>> Constraints: +>>>>>> +>>>>>> * pattern: `[a-zA-Z]([_]?[0-9a-zA-Z]){0,99}` +>>>>>> + @@ -383 +401 @@ flowExecutionEvents -> (list) ->>>>>> The content of the input field, which can contain text or structured data. +>>>>>> The content of the output field, which can contain text or structured data. @@ -391,0 +410,33 @@ flowExecutionEvents -> (list) +>> +>> nodeInputEvent -> (structure) +>> +>>> Contains information about the inputs provided to a specific node during execution. +>>> +>>> nodeName -> (string) [required] +>>> +>>>> The name of the node that received the inputs. +>>>> +>>>> Constraints: +>>>> +>>>> * pattern: `[a-zA-Z]([_]?[0-9a-zA-Z]){0,99}` +>>>> + +>>> +>>> timestamp -> (timestamp) [required] +>>> +>>>> The timestamp when the inputs were provided to the node. +>>> +>>> fields -> (list) [required] +>>> +>>>> A list of input fields provided to the node. +>>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * max: `5` +>>>>