aws-cdk-lib.aws_bedrockagentcore.LifecycleConfiguration

LifecycleConfiguration Struct

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.

Source

aws-bedrockagentcore/lib/runtime/types.ts

Type last changed

v2.255.0 · 19 May 2026

Example

const repository = new ecr.Repository(this, "TestRepository", {
  repositoryName: "test-agent-runtime",
});

const agentRuntimeArtifact = agentcore.AgentRuntimeArtifact.fromEcrRepository(repository, "v1.0.0");

new agentcore.Runtime(this, 'test-runtime', {
  runtimeName: 'test_runtime',
  agentRuntimeArtifact: agentRuntimeArtifact,
  lifecycleConfiguration: {
    idleRuntimeSessionTimeout: Duration.minutes(10),
    maxLifetime: Duration.hours(4),
  },
});

Properties

idleRuntimeSessionTimeout?optionalDurationidle_runtime_session_timeout?optionalDurationidleRuntimeSessionTimeout?optionalDurationIdleRuntimeSessionTimeout?optionalDurationIdleRuntimeSessionTimeout?optionalDuration#

Timeout in seconds for idle runtime sessions.

Default: undefined - service default setting is 900 seconds (15 minutes)

When a session remains idle for this duration, it will be automatically terminated.

maxLifetime?optionalDurationmax_lifetime?optionalDurationmaxLifetime?optionalDurationMaxLifetime?optionalDurationMaxLifetime?optionalDuration#

Maximum lifetime for the instance in seconds.

Default: undefined - service default setting is 28800 seconds (8 hours)

Once reached, instances will be automatically terminated and replaced.