interface RuntimeProps 🔹

Language	Type name
.NET	Amazon.CDK.AWS.Bedrock.Agentcore.Alpha.RuntimeProps
Go	github.com/aws/aws-cdk-go/awsbedrockagentcorealpha/v2#RuntimeProps
Java	software.amazon.awscdk.services.bedrock.agentcore.alpha.RuntimeProps
Python	aws_cdk.aws_bedrock_agentcore_alpha.RuntimeProps
TypeScript (source)	@aws-cdk/aws-bedrock-agentcore-alpha » RuntimeProps

Properties for creating a Bedrock Agent Core Runtime resource.

Example

const repository = new ecr.Repository(this, "TestRepository", {
  repositoryName: "test-agent-runtime",
});
const agentRuntimeArtifact = agentcore.AgentRuntimeArtifact.fromEcrRepository(repository, "v1.0.0");

const runtime = new agentcore.Runtime(this, "MyAgentRuntime", {
  runtimeName: "myAgent",
  agentRuntimeArtifact: agentRuntimeArtifact,
  authorizerConfiguration: agentcore.RuntimeAuthorizerConfiguration.usingOAuth(
    "https://github.com/.well-known/openid-configuration",
    "oauth_client_123",
  ),
});

Properties

Name	Type	Description
agentRuntimeArtifact🔹	AgentRuntimeArtifact	The artifact configuration for the agent runtime Contains the container configuration with ECR URI.
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}$.
authorizerConfiguration?🔹	RuntimeAuthorizerConfiguration	Authorizer configuration for the agent runtime Use RuntimeAuthorizerConfiguration static methods to create the configuration.
description?🔹	string	Optional description for the agent runtime.
environmentVariables?🔹	{ [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).
executionRole?🔹	IRole	The IAM role that provides permissions for the agent runtime If not provided, a role will be created automatically.
networkConfiguration?🔹	RuntimeNetworkConfiguration	Network configuration for the agent runtime.
protocolConfiguration?🔹	ProtocolType	Protocol configuration for the agent runtime.
tags?🔹	{ [string]: string }	Tags for the agent runtime A list of key:value pairs of tags to apply to this Runtime resource.

---

agentRuntimeArtifact🔹

Type: AgentRuntimeArtifact

The artifact configuration for the agent runtime Contains the container configuration with ECR URI.

---

runtimeName🔹

Type: 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}$.

---

authorizerConfiguration?🔹

Type: RuntimeAuthorizerConfiguration (optional, default: RuntimeAuthorizerConfiguration.iam() (IAM authentication))

Authorizer configuration for the agent runtime Use RuntimeAuthorizerConfiguration static methods to create the configuration.

---

description?🔹

Type: string (optional, default: No description Length Minimum: 1 , Maximum: 1200)

Optional description for the agent runtime.

---

environmentVariables?🔹

Type: { [string]: string } (optional, default: No environment variables)

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).

---

executionRole?🔹

Type: IRole (optional, default: A new role will be created)

The IAM role that provides permissions for the agent runtime If not provided, a role will be created automatically.

---

networkConfiguration?🔹

Type: RuntimeNetworkConfiguration (optional, default: RuntimeNetworkConfiguration.usingPublicNetwork())

Network configuration for the agent runtime.

---

protocolConfiguration?🔹

Type: ProtocolType (optional, default: ProtocolType.HTTP)

Protocol configuration for the agent runtime.

---

tags?🔹

Type: { [string]: string } (optional, default: {} - no tags)

Tags for the agent runtime A list of key:value pairs of tags to apply to this Runtime resource.