AWS CDK Reference

Appearance

v2.274.0

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 ​

ts
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 ​

idleRuntimeSessionTimeoutDurationidle_runtime_session_timeoutDurationidleRuntimeSessionTimeoutDurationIdleRuntimeSessionTimeoutDurationIdleRuntimeSessionTimeoutDuration#
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.

maxLifetimeDurationmax_lifetimeDurationmaxLifetimeDurationMaxLifetimeDurationMaxLifetimeDuration#
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.