# LifecycleConfiguration

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`](https://github.com/aws/aws-cdk/blob/v2.274.0/packages/aws-cdk-lib/aws-bedrockagentcore/lib/runtime/types.ts#L112)
- 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

- `idleRuntimeSessionTimeout`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — 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`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — 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.