BedrockAgentCoreDataPlaneFrontingLayer / Client / list_actors

list_actors

BedrockAgentCoreDataPlaneFrontingLayer.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

Request Syntax

response = client.list_actors(
    memoryId='string',
    maxResults=123,
    nextToken='string'
)

Parameters:

• memoryId (string) –

  [REQUIRED]

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

• maxResults (integer) – The maximum number of results to return in a single call. Minimum value of 1, maximum value of 100. Default is 20.

• nextToken (string) – 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.

Return type:

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

• BedrockAgentCoreDataPlaneFrontingLayer.Client.exceptions.ServiceQuotaExceededException

• BedrockAgentCoreDataPlaneFrontingLayer.Client.exceptions.AccessDeniedException

• BedrockAgentCoreDataPlaneFrontingLayer.Client.exceptions.ValidationException

• BedrockAgentCoreDataPlaneFrontingLayer.Client.exceptions.InvalidInputException

• BedrockAgentCoreDataPlaneFrontingLayer.Client.exceptions.ResourceNotFoundException

• BedrockAgentCoreDataPlaneFrontingLayer.Client.exceptions.ThrottledException

• BedrockAgentCoreDataPlaneFrontingLayer.Client.exceptions.ServiceException