BedrockAgentCore / Client / list_actors
list_actors¶
- 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:ListActorspermission.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. The default value 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
BedrockAgentCore.Client.exceptions.ServiceQuotaExceededExceptionBedrockAgentCore.Client.exceptions.ThrottledExceptionBedrockAgentCore.Client.exceptions.ServiceExceptionBedrockAgentCore.Client.exceptions.AccessDeniedExceptionBedrockAgentCore.Client.exceptions.ValidationExceptionBedrockAgentCore.Client.exceptions.InvalidInputExceptionBedrockAgentCore.Client.exceptions.ResourceNotFoundException