AWS Fundamentals Logo
AWS Fundamentals
L1 ConstructAWS::BedrockAgentCore::Runtime

CfnRuntime

Contains information about an agent runtime. An agent runtime is the execution environment for a Amazon Bedrock Agent. AgentCore Runtime is a secure, serverless runtime purpose-built for deploying and scaling dynamic AI agents and tools using any open-source framework including LangGraph, CrewAI, and Strands Agents, any protocol, and any model. For more information about using agent runtime in Amazon Bedrock AgentCore, see [Host agent or tools with Amazon Bedrock AgentCore Runtime](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/agents-tools-runtime.html) . See the *Properties* section below for descriptions of both the required and optional properties.

Import

import { CfnRuntime } from 'aws-cdk-lib/aws-bedrockagentcore';

Or use the module namespace:

import * as bedrockagentcore from 'aws-cdk-lib/aws-bedrockagentcore';
// bedrockagentcore.CfnRuntime

Properties

Configuration passed to the constructor as CfnRuntimeProps.

agentRuntimeArtifactRequired
IResolvable | AgentRuntimeArtifactProperty

The artifact of the agent.

agentRuntimeNameRequired
string

The name of the AgentCore Runtime endpoint.

networkConfigurationRequired
IResolvable | NetworkConfigurationProperty

The network configuration.

roleArnRequired
string

The Amazon Resource Name (ARN) for for the role.

authorizerConfigurationOptional
IResolvable | AuthorizerConfigurationProperty

Represents inbound authorization configuration options used to authenticate incoming requests.

descriptionOptional
string

The agent runtime description.

environmentVariablesOptional
{ [key: string]: string } | IResolvable

The environment variables for the agent.

filesystemConfigurationsOptional
IResolvable | IResolvable | FilesystemConfigurationProperty[]

List of filesystem configurations.

lifecycleConfigurationOptional
IResolvable | LifecycleConfigurationProperty

Configuration for managing the lifecycle of runtime sessions and resources.

protocolConfigurationOptional
string

The protocol configuration for an agent runtime. This structure defines how the agent runtime communicates with clients.

requestHeaderConfigurationOptional
IResolvable | RequestHeaderConfigurationProperty

Configuration for HTTP request headers.

tagsOptional
{ [key: string]: string }

The tags for the agent.

CloudFormation Resource

This L1 construct maps directly to the following CloudFormation resource type.

AWS::BedrockAgentCore::RuntimeView in CloudFormation Explorer

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

LevelL1 (CloudFormation)
Moduleaws-bedrockagentcore
CFN TypeAWS::BedrockAgentCore::Runtime
Properties12

Related Constructs

Explore This Service

External Links