list_sessions¶
Operation¶
list_sessions
¶
list_sessions(request: ListSessionsInput | ListSessionsInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[ListSessionsInputDict]) -> ListSessionsOutput
Lists sessions in an AgentCore Memory resource based on specified criteria. We recommend using pagination to ensure that the operation returns quickly and successfully.
Empty sessions are automatically deleted after one day.
To use this operation, you must have the
bedrock-agentcore:ListSessions permission.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
request
|
ListSessionsInput | ListSessionsInputDict | None
|
The input as a model or dictionary. Pass this or keyword arguments, not both. |
None
|
plugins
|
list[Plugin] | None
|
A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations. |
None
|
**kwargs
|
Unpack[ListSessionsInputDict]
|
The input fields as keyword arguments. |
{}
|
Returns:
| Type | Description |
|---|---|
ListSessionsOutput
|
An instance of |
list_sessions
async
¶
list_sessions(request: ListSessionsInput | ListSessionsInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[ListSessionsInputDict]) -> ListSessionsOutput
Lists sessions in an AgentCore Memory resource based on specified criteria. We recommend using pagination to ensure that the operation returns quickly and successfully.
Empty sessions are automatically deleted after one day.
To use this operation, you must have the
bedrock-agentcore:ListSessions permission.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
request
|
ListSessionsInput | ListSessionsInputDict | None
|
The input as a model or dictionary. Pass this or keyword arguments, not both. |
None
|
plugins
|
list[Plugin] | None
|
A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations. |
None
|
**kwargs
|
Unpack[ListSessionsInputDict]
|
The input fields as keyword arguments. |
{}
|
Returns:
| Type | Description |
|---|---|
ListSessionsOutput
|
An instance of |
Input¶
Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.
ListSessionsInputDict
¶
Bases: TypedDict
Dictionary form of ListSessionsInput.
Attributes¶
actor_id
instance-attribute
¶
The identifier of the actor for which to list sessions.
filter
instance-attribute
¶
filter: SessionFilter | SessionFilterDict | None
Filter criteria to apply when listing sessions.
max_results
instance-attribute
¶
max_results: int | None
The maximum number of results to return in a single call. The default value is 20.
memory_id
instance-attribute
¶
The identifier of the AgentCore Memory resource for which to list sessions.
ListSessionsInput
dataclass
¶
Bases: _SerdeShape
Dataclass for ListSessionsInput structure.
Attributes¶
actor_id
class-attribute
instance-attribute
¶
actor_id: str | None = ...
The identifier of the actor for which to list sessions.
filter
class-attribute
instance-attribute
¶
filter: SessionFilter | None = ...
Filter criteria to apply when listing sessions.
max_results
class-attribute
instance-attribute
¶
max_results: int = ...
The maximum number of results to return in a single call. The default value is 20.
Output¶
ListSessionsOutput
dataclass
¶
Bases: _SerdeShape
Dataclass for ListSessionsOutput structure.
Attributes¶
next_token
class-attribute
instance-attribute
¶
next_token: str | None = ...
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.
response_metadata
class-attribute
instance-attribute
¶
Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.
session_summaries
instance-attribute
¶
session_summaries: list[SessionSummary]
The list of session summaries that match the specified criteria.