AWS::BedrockAgentCore::Memory - AWS CloudFormation
SyntaxPropertiesReturn values

This is the new CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

AWS::BedrockAgentCore::Memory

Memory allows AI agents to maintain both immediate and long-term knowledge, enabling context-aware and personalized interactions.

For more information about using Memory in Amazon Bedrock AgentCore, see Host agent or tools with Amazon Bedrock AgentCore Memory.

See the Properties section below for descriptions of both the required and optional properties.

Syntax

To declare this entity in your CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::BedrockAgentCore::Memory",
  "Properties" : {
      "Description" : String,
      "EncryptionKeyArn" : String,
      "EventExpiryDuration" : Integer,
      "MemoryExecutionRoleArn" : String,
      "MemoryStrategies" : [ MemoryStrategy, ... ],
      "Name" : String,
      "Tags" : {Key: Value, ...}
    }
}

YAML

Type: AWS::BedrockAgentCore::Memory
Properties:
  Description: String
  EncryptionKeyArn: String
  EventExpiryDuration: Integer
  MemoryExecutionRoleArn: String
  MemoryStrategies: 
    - MemoryStrategy
  Name: String
  Tags: 
    Key: Value

Properties

Description

The description of the memory.

Required: No

Type: String

Update requires: No interruption

EncryptionKeyArn

The ARN of the KMS key used to encrypt the memory.

Required: No

Type: String

Pattern: ^arn:aws:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[^/].{0,1023}$

Update requires: Replacement

EventExpiryDuration

The number of days after which memory events will expire.

Required: Yes

Type: Integer

Minimum: 3

Maximum: 365

Update requires: No interruption

MemoryExecutionRoleArn

The ARN of the IAM role that provides permissions for the memory.

Required: No

Type: String

Pattern: ^arn:aws:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[^/].{0,1023}$

Update requires: No interruption

MemoryStrategies

The list of memory strategies associated with this memory.

Required: No

Type: Array of MemoryStrategy

Update requires: No interruption

Name

The name of the memory.

Required: Yes

Type: String

Pattern: ^[a-zA-Z][a-zA-Z0-9_]{0,47}$

Update requires: Replacement

Tags

A map of tag keys and values to assign to an AgentCore Memory. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.

Required: No

Type: Object of String

Pattern: ^[a-zA-Z0-9\s._:/=+@-]{1,128}$

Minimum: 0

Maximum: 256

Update requires: No interruption

Return values

Ref

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

CreatedAt

The timestamp when the memory was created.

FailureReason

The reason for failure if the memory is in a failed state.

MemoryArn

The Amazon Resource Name (ARN) of the memory.

MemoryId

The unique identifier of the memory.

Status

The current status of the memory.

UpdatedAt

The timestamp when the memory was last updated.