Skip to main content

actors

Creates, updates, deletes, gets or lists an actors resource.

Overview​

Nameactors
TypeResource
Idaws.bedrock_agentcore.actors

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
actor_idstringThe unique identifier of the actor. (pattern: <code>[a-zA-Z0-9][a-zA-Z0-9-/]*(?::[a-zA-Z0-9-/]+)[a-zA-Z0-9-_/]</code>)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_actorsselectmemory_id, regionLists 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.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
memory_idstringThe identifier of the AgentCore Memory resource for which to list actors.
regionstringAWS region (default: us-east-1)

SELECT examples​

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.

SELECT
actor_id
FROM aws.bedrock_agentcore.actors
WHERE memory_id = '{{ memory_id }}' -- required
AND region = '{{ region }}' -- required
;