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

***********
list_actors
***********



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

  

  Lists all actors in an AgentCore Memory resource. We recommend using pagination to ensure that the operation returns quickly and successfully.

   

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

  

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


  **Request Syntax**
  ::

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

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

    

  
  :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**

    
    ::

      {
          'actorSummaries': [
              {
                  'actorId': 'string'
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **actorSummaries** *(list) --* 

        The list of actor summaries.

        
        

        - *(dict) --* 

          Contains summary information about an actor in an AgentCore Memory resource.

          
          

          - **actorId** *(string) --* 

            The unique identifier of the actor.

            
      
    
      

      - **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`

  