> **Experimental**
>
> `@aws-cdk/aws-bedrock-agentcore-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# RuntimeProps

Properties for creating a Bedrock Agent Core Runtime resource.

Extends: RuntimeProps
Used as props by: Runtime

- Source: [`lib/runtime/runtime.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0-alpha.0/packages/@aws-cdk/aws-bedrock-agentcore-alpha/lib/runtime/runtime.ts#L56)

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as bedrock_agentcore_alpha from '@aws-cdk/aws-bedrock-agentcore-alpha';
import * as cdk from 'aws-cdk-lib';
import { aws_iam as iam } from 'aws-cdk-lib';

declare const agentRuntimeArtifact: bedrock_agentcore_alpha.AgentRuntimeArtifact;
declare const loggingDestination: bedrock_agentcore_alpha.LoggingDestination;
declare const logType: bedrock_agentcore_alpha.LogType;
declare const role: iam.Role;
declare const runtimeAuthorizerConfiguration: bedrock_agentcore_alpha.RuntimeAuthorizerConfiguration;
declare const runtimeNetworkConfiguration: bedrock_agentcore_alpha.RuntimeNetworkConfiguration;
const runtimeProps: bedrock_agentcore_alpha.RuntimeProps = {
  agentRuntimeArtifact: agentRuntimeArtifact,

  // the properties below are optional
  authorizerConfiguration: runtimeAuthorizerConfiguration,
  description: 'description',
  environmentVariables: {
    environmentVariablesKey: 'environmentVariables',
  },
  executionRole: role,
  lifecycleConfiguration: {
    idleRuntimeSessionTimeout: cdk.Duration.minutes(30),
    maxLifetime: cdk.Duration.minutes(30),
  },
  loggingConfigs: [{
    destination: loggingDestination,
    logType: logType,
  }],
  networkConfiguration: runtimeNetworkConfiguration,
  protocolConfiguration: bedrock_agentcore_alpha.ProtocolType.MCP,
  requestHeaderConfiguration: {
    allowlistedHeaders: ['allowlistedHeaders'],
  },
  runtimeName: 'runtimeName',
  tags: {
    tagsKey: 'tags',
  },
  tracingEnabled: false,
};
```

## Properties

- `agentRuntimeArtifact`: [AgentRuntimeArtifact](/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.AgentRuntimeArtifact.html) (required) — The artifact configuration for the agent runtime Contains the container configuration with ECR URI.

- `authorizerConfiguration`: [RuntimeAuthorizerConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.RuntimeAuthorizerConfiguration.html) — Authorizer configuration for the agent runtime Use RuntimeAuthorizerConfiguration static methods to create the configuration.

  **Default:** RuntimeAuthorizerConfiguration.iam() (IAM authentication)

- `description`: string — Optional description for the agent runtime.

  **Default:** No description Length Minimum: 1 , Maximum: 1200

- `environmentVariables`: { [key: string]: string } — Environment variables for the agent runtime - Maximum 50 environment variables - Key: Must be 1-100 characters, start with letter or underscore, contain only letters, numbers, and underscores - Value: Must be 0-2048 characters (per CloudFormation specification).

  **Default:** No environment variables

- `executionRole`: [IRole](/cdk/api/v2/docs/aws-cdk-lib.aws_iam.IRole.html) — The IAM role that provides permissions for the agent runtime If not provided, a role will be created automatically.

  **Default:** A new role will be created

- `lifecycleConfiguration`: [LifecycleConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.LifecycleConfiguration.html) — The life cycle configuration for the AgentCore Runtime.

  **Default:** No lifecycle configuration

- `loggingConfigs`: [LoggingConfig](/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.LoggingConfig.html)[] — Logging configuration for the runtime.

  **Default:** No logging configured

  Allows sending APPLICATION_LOGS and USAGE_LOGS to CloudWatch Logs, S3, or Kinesis Data Firehose.

- `networkConfiguration`: [RuntimeNetworkConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.RuntimeNetworkConfiguration.html) — Network configuration for the agent runtime.

  **Default:** RuntimeNetworkConfiguration.usingPublicNetwork()

- `protocolConfiguration`: [ProtocolType](/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.ProtocolType.html) = ProtocolType.HTTP — Protocol configuration for the agent runtime.

- `requestHeaderConfiguration`: [RequestHeaderConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-bedrock-agentcore-alpha.RequestHeaderConfiguration.html) — Configuration for HTTP request headers that will be passed through to the runtime.

  **Default:** No request headers configured

- `runtimeName`: string — The name of the agent runtime Valid characters are a-z, A-Z, 0-9, _ (underscore) Must start with a letter and can be up to 48 characters long Pattern: ^[a-zA-Z][a-zA-Z0-9_]{0,47}$.

  **Default:** auto generate

- `tags`: { [key: string]: string } — Tags for the agent runtime A list of key:value pairs of tags to apply to this Runtime resource.

  **Default:** {} - no tags

- `tracingEnabled`: boolean = false — Whether to enable X-Ray tracing for this runtime.

  When enabled, traces will be delivered to AWS X-Ray.
