LifecycleConfiguration

class aws_cdk.aws_bedrock_agentcore_alpha.LifecycleConfiguration(*, idle_runtime_session_timeout=None, max_lifetime=None)

Bases: object

(experimental) LifecycleConfiguration lets you manage the lifecycle of runtime sessions and resources in AgentCore Runtime.

This configuration helps optimize resource utilization by automatically cleaning up idle sessions and preventing long-running instances from consuming resources indefinitely.

Parameters:
  • idle_runtime_session_timeout (Optional[Duration]) – (experimental) Timeout in seconds for idle runtime sessions. When a session remains idle for this duration, it will be automatically terminated. Default: 900 seconds (15 minutes). Default: - 900 seconds (15 minutes)

  • max_lifetime (Optional[Duration]) – (experimental) Maximum lifetime for the instance in seconds. Once reached, instances will be automatically terminated and replaced. Default: 28800 seconds (8 hours). Default: - 28800 seconds (8 hours)

Stability:

experimental

ExampleMetadata:

fixture=default infused

Example:

repository = ecr.Repository(self, "TestRepository",
    repository_name="test-agent-runtime"
)

agent_runtime_artifact = agentcore.AgentRuntimeArtifact.from_ecr_repository(repository, "v1.0.0")

agentcore.Runtime(self, "test-runtime",
    runtime_name="test_runtime",
    agent_runtime_artifact=agent_runtime_artifact,
    lifecycle_configuration=agentcore.LifecycleConfiguration(
        idle_runtime_session_timeout=Duration.minutes(10),
        max_lifetime=Duration.hours(4)
    )
)

Attributes

idle_runtime_session_timeout

(experimental) Timeout in seconds for idle runtime sessions.

When a session remains idle for this duration, it will be automatically terminated. Default: 900 seconds (15 minutes).

Default:
  • 900 seconds (15 minutes)

Stability:

experimental

max_lifetime

(experimental) Maximum lifetime for the instance in seconds.

Once reached, instances will be automatically terminated and replaced. Default: 28800 seconds (8 hours).

Default:
  • 28800 seconds (8 hours)

Stability:

experimental