AWS cli documentation change
Summary
Added documentation for 'memoryRecordSchema' structure defining metadata field schema and validation rules, including extraction configurations and value constraints. Also added 'indexedKeys' field documentation for filterable metadata keys. Updated CLI version reference from 2.34.38 to 2.34.40.
Security assessment
The changes add extensive documentation for metadata validation features including allowed values, input patterns, and value constraints. These are security controls for input validation and data integrity, but there's no evidence this addresses a specific vulnerability. The validation rules help prevent malformed/invalid data injection.
Diff
diff --git a/cli/latest/reference/bedrock-agentcore-control/get-memory.md b/cli/latest/reference/bedrock-agentcore-control/get-memory.md index 11ad5829b..c5eb62466 100644 --- a//cli/latest/reference/bedrock-agentcore-control/get-memory.md +++ b//cli/latest/reference/bedrock-agentcore-control/get-memory.md @@ -15 +15 @@ - * [AWS CLI 2.34.38 Command Reference](../../index.html) » + * [AWS CLI 2.34.40 Command Reference](../../index.html) » @@ -629,0 +630,158 @@ memory -> (structure) +>>>>>>> +>>>>>>> memoryRecordSchema -> (structure) +>>>>>>> +>>>>>>>> Schema for metadata fields on records generated by this reflection override. +>>>>>>>> +>>>>>>>> metadataSchema -> (list) +>>>>>>>> +>>>>>>>>> The metadata field definitions for this strategy. +>>>>>>>>> +>>>>>>>>> Constraints: +>>>>>>>>> +>>>>>>>>> * min: `1` +>>>>>>>>> * max: `20` +>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> (structure) +>>>>>>>>> +>>>>>>>>>> A metadata field definition within a strategy’s schema. +>>>>>>>>>> +>>>>>>>>>> key -> (string) [required] +>>>>>>>>>> +>>>>>>>>>>> The metadata field name. Must match an indexed key to be queryable via metadata filters. +>>>>>>>>>>> +>>>>>>>>>>> Constraints: +>>>>>>>>>>> +>>>>>>>>>>> * min: `1` +>>>>>>>>>>> * max: `128` +>>>>>>>>>>> * pattern: `[a-zA-Z0-9\s._:/=+@-]*` +>>>>>>>>>>> + +>>>>>>>>>> +>>>>>>>>>> type -> (string) +>>>>>>>>>> +>>>>>>>>>>> The MetadataValueType. +>>>>>>>>>>> +>>>>>>>>>>> Possible values: +>>>>>>>>>>> +>>>>>>>>>>> * `STRING` +>>>>>>>>>>> * `STRINGLIST` +>>>>>>>>>>> * `NUMBER` +>>>>>>>>>>> + +>>>>>>>>>> +>>>>>>>>>> extractionConfig -> (tagged union structure) +>>>>>>>>>> +>>>>>>>>>>> Configuration for extracting this metadata value from conversational content. +>>>>>>>>>>> +>>>>>>>>>>> ### Note +>>>>>>>>>>> +>>>>>>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `llmExtractionConfig`. +>>>>>>>>>>> +>>>>>>>>>>> llmExtractionConfig -> (structure) +>>>>>>>>>>> +>>>>>>>>>>>> Model-based extraction using a definition and instructions. +>>>>>>>>>>>> +>>>>>>>>>>>> llmExtractionInstruction -> (string) +>>>>>>>>>>>> +>>>>>>>>>>>>> Instructions for extraction. Supports built-in operators like LATEST_VALUE or custom natural-language instructions. +>>>>>>>>>>>>> +>>>>>>>>>>>>> Constraints: +>>>>>>>>>>>>> +>>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>>> * max: `1000` +>>>>>>>>>>>>> + +>>>>>>>>>>>> +>>>>>>>>>>>> definition -> (string) [required] +>>>>>>>>>>>> +>>>>>>>>>>>>> Description of what this metadata field represents. +>>>>>>>>>>>>> +>>>>>>>>>>>>> Constraints: +>>>>>>>>>>>>> +>>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>>> * max: `1000` +>>>>>>>>>>>>> + +>>>>>>>>>>>> +>>>>>>>>>>>> validation -> (tagged union structure) +>>>>>>>>>>>> +>>>>>>>>>>>>> Validation rules to constrain extracted values. +>>>>>>>>>>>>> +>>>>>>>>>>>>> ### Note +>>>>>>>>>>>>> +>>>>>>>>>>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `stringValidation`, `stringListValidation`, `numberValidation`. +>>>>>>>>>>>>> +>>>>>>>>>>>>> stringValidation -> (structure) +>>>>>>>>>>>>> +>>>>>>>>>>>>>> Validation for STRING fields. +>>>>>>>>>>>>>> +>>>>>>>>>>>>>> allowedValues -> (list) [required] +>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> Allowed values for this STRING field. +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> Constraints: +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>>>>> * max: `10` +>>>>>>>>>>>>>>> + +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> (string) +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>>> Constraints: +>>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>>>>>> * max: `256` +>>>>>>>>>>>>>>>> * pattern: `[a-zA-Z0-9\s._:/=+@-]*` +>>>>>>>>>>>>>>>> + +>>>>>>>>>>>>> +>>>>>>>>>>>>> stringListValidation -> (structure) +>>>>>>>>>>>>> +>>>>>>>>>>>>>> Validation for STRINGLIST fields. +>>>>>>>>>>>>>> +>>>>>>>>>>>>>> allowedValues -> (list) +>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> Allowed values for items in this STRINGLIST field. +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> Constraints: +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>>>>> * max: `10` +>>>>>>>>>>>>>>> + +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> (string) +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>>> Constraints: +>>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>>>>>> * max: `64` +>>>>>>>>>>>>>>>> * pattern: `[a-zA-Z0-9\s._:/=+@-]*` +>>>>>>>>>>>>>>>> + +>>>>>>>>>>>>>> +>>>>>>>>>>>>>> maxItems -> (integer) +>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> Maximum number of items in the string list. +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> Constraints: +>>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> * min: `1` +>>>>>>>>>>>>>>> * max: `5` +>>>>>>>>>>>>>>> + +>>>>>>>>>>>>> +>>>>>>>>>>>>> numberValidation -> (structure) +>>>>>>>>>>>>> +>>>>>>>>>>>>>> Validation for NUMBER fields. +>>>>>>>>>>>>>> +>>>>>>>>>>>>>> minValue -> (double) +>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> Minimum allowed value. +>>>>>>>>>>>>>> +>>>>>>>>>>>>>> maxValue -> (double) +>>>>>>>>>>>>>> +>>>>>>>>>>>>>>> Maximum allowed value. @@ -675,0 +834,158 @@ memory -> (structure) +>>>>>> +>>>>>> memoryRecordSchema -> (structure) +>>>>>> +>>>>>>> “Schema for metadata fields on records generated by reflections. +>>>>>>> +>>>>>>> metadataSchema -> (list) +>>>>>>> +>>>>>>>> The metadata field definitions for this strategy. +>>>>>>>> +>>>>>>>> Constraints: +>>>>>>>> +>>>>>>>> * min: `1` +>>>>>>>> * max: `20` +>>>>>>>> + +>>>>>>>> +>>>>>>>> (structure) +>>>>>>>> +>>>>>>>>> A metadata field definition within a strategy’s schema. +>>>>>>>>> +>>>>>>>>> key -> (string) [required] +>>>>>>>>> +>>>>>>>>>> The metadata field name. Must match an indexed key to be queryable via metadata filters. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `1` +>>>>>>>>>> * max: `128` +>>>>>>>>>> * pattern: `[a-zA-Z0-9\s._:/=+@-]*` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> type -> (string)