:doc:`BedrockAgentCore <../../bedrock-agentcore>` / Client / list_memory_records

*******************
list_memory_records
*******************



.. py:method:: BedrockAgentCore.Client.list_memory_records(**kwargs)

  

  Lists memory records in an AgentCore Memory resource based on specified criteria. We recommend using pagination to ensure that the operation returns quickly and successfully.

   

  To use this operation, you must have the ``bedrock-agentcore:ListMemoryRecords`` permission.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/bedrock-agentcore-2024-02-28/ListMemoryRecords>`_  


  **Request Syntax**
  ::

    response = client.list_memory_records(
        memoryId='string',
        namespace='string',
        memoryStrategyId='string',
        maxResults=123,
        nextToken='string'
    )
    
  :type memoryId: string
  :param memoryId: **[REQUIRED]** 

    The identifier of the AgentCore Memory resource for which to list memory records.

    

  
  :type namespace: string
  :param namespace: **[REQUIRED]** 

    The namespace prefix to filter memory records by. Returns all memory records in namespaces that start with the provided prefix.

    

  
  :type memoryStrategyId: string
  :param memoryStrategyId: 

    The memory strategy identifier to filter memory records by. If specified, only memory records with this strategy ID are returned.

    

  
  :type maxResults: integer
  :param maxResults: 

    The maximum number of results to return in a single call. The default value is 20.

    

  
  :type nextToken: string
  :param nextToken: 

    The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'memoryRecordSummaries': [
              {
                  'memoryRecordId': 'string',
                  'content': {
                      'text': 'string'
                  },
                  'memoryStrategyId': 'string',
                  'namespaces': [
                      'string',
                  ],
                  'createdAt': datetime(2015, 1, 1),
                  'score': 123.0,
                  'metadata': {
                      'string': {
                          'stringValue': 'string'
                      }
                  }
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **memoryRecordSummaries** *(list) --* 

        The list of memory record summaries that match the specified criteria.

        
        

        - *(dict) --* 

          Contains summary information about a memory record.

          
          

          - **memoryRecordId** *(string) --* 

            The unique identifier of the memory record.

            
          

          - **content** *(dict) --* 

            The content of the memory record.

            .. note::    This is a Tagged Union structure. Only one of the     following top level keys will be set: ``text``.     If a client receives an unknown member it will     set ``SDK_UNKNOWN_MEMBER`` as the top level key,     which maps to the name or tag of the unknown     member. The structure of ``SDK_UNKNOWN_MEMBER`` is     as follows::

                        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}


          
            

            - **text** *(string) --* 

              The text content of the memory record.

              
        
          

          - **memoryStrategyId** *(string) --* 

            The identifier of the memory strategy associated with this record.

            
          

          - **namespaces** *(list) --* 

            The namespaces associated with this memory record.

            
            

            - *(string) --* 
        
          

          - **createdAt** *(datetime) --* 

            The timestamp when the memory record was created.

            
          

          - **score** *(float) --* 

            The relevance score of the memory record when returned as part of a search result. Higher values indicate greater relevance to the search query.

            
          

          - **metadata** *(dict) --* 

            A map of metadata key-value pairs associated with a memory record.

            
            

            - *(string) --* 
              

              - *(dict) --* 

                Value associated with the ``eventMetadata`` key.

                .. note::    This is a Tagged Union structure. Only one of the     following top level keys will be set: ``stringValue``.     If a client receives an unknown member it will     set ``SDK_UNKNOWN_MEMBER`` as the top level key,     which maps to the name or tag of the unknown     member. The structure of ``SDK_UNKNOWN_MEMBER`` is     as follows::

                                'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}


              
                

                - **stringValue** *(string) --* 

                  Value associated with the ``eventMetadata`` key.

                  
            
        
      
      
    
      

      - **nextToken** *(string) --* 

        The token to use in a subsequent request to get the next set of results. This value is null when there are no more results to return.

        
  
  **Exceptions**
  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ThrottledException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ServiceException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ValidationException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.InvalidInputException`

  
  *   :py:class:`BedrockAgentCore.Client.exceptions.ResourceNotFoundException`

  