AWS::BedrockAgentCore::Runtime - AWS CloudFormation
SyntaxPropertiesReturn values

This is the new CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

AWS::BedrockAgentCore::Runtime

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.

See the Properties section below for descriptions of both the required and optional properties.

Syntax

To declare this entity in your CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::BedrockAgentCore::Runtime",
  "Properties" : {
      "AgentRuntimeArtifact" : AgentRuntimeArtifact,
      "AgentRuntimeName" : String,
      "AuthorizerConfiguration" : AuthorizerConfiguration,
      "Description" : String,
      "EnvironmentVariables" : {Key: Value, ...},
      "LifecycleConfiguration" : LifecycleConfiguration,
      "NetworkConfiguration" : NetworkConfiguration,
      "ProtocolConfiguration" : String,
      "RequestHeaderConfiguration" : RequestHeaderConfiguration,
      "RoleArn" : String,
      "Tags" : {Key: Value, ...}
    }
}

Properties

AgentRuntimeArtifact

The artifact of the AgentCore Runtime.

Required: Yes

Type: AgentRuntimeArtifact

Update requires: No interruption

AgentRuntimeName

The name of the AgentCore Runtime.

Required: Yes

Type: String

Pattern: [a-zA-Z][a-zA-Z0-9_]{0,47}

Update requires: Replacement

AuthorizerConfiguration

The authorizer configuration for the AgentCore Runtime.

Required: No

Type: AuthorizerConfiguration

Update requires: No interruption

Description

The description of the AgentCore Runtime.

Required: No

Type: String

Minimum: 1

Maximum: 1200

Update requires: No interruption

EnvironmentVariables

Environment variables to set in the AgentCore Runtime environment.

Required: No

Type: Object of String

Pattern: ^[a-zA-Z_][a-zA-Z0-9_]*$

Maximum: 2048

Update requires: No interruption

LifecycleConfiguration

The lifecycle configuration for the AgentCore Runtime.

Required: No

Type: LifecycleConfiguration

Update requires: No interruption

NetworkConfiguration

The network configuration for the AgentCore Runtime.

Required: Yes

Type: NetworkConfiguration

Update requires: No interruption

ProtocolConfiguration

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

Required: No

Type: String

Allowed values: MCP | HTTP | A2A

Update requires: No interruption

RequestHeaderConfiguration

Configuration for HTTP request headers that will be passed through to the runtime.

Required: No

Type: RequestHeaderConfiguration

Update requires: No interruption

RoleArn

The IAM role ARN that provides permissions for the AgentCore Runtime.

Required: Yes

Type: String

Pattern: arn:aws(-[^:]+)?:iam::([0-9]{12})?:role/.+

Update requires: No interruption

Tags

The tags for the agent.

Required: No

Type: Object of String

Pattern: ^[a-zA-Z0-9\s._:/=+@-]*$

Minimum: 0

Maximum: 256

Update requires: No interruption

Return values

Ref

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

AgentRuntimeArn

The Amazon Resource Name (ARN) of the AgentCore Runtime.

AgentRuntimeId

The unique identifier of the AgentCore Runtime.

AgentRuntimeVersion

The version of the AgentCore Runtime.

CreatedAt

The timestamp when the AgentCore Runtime was created.

FailureReason

The reason for failure if the AgentCore Runtime is in a failed state.

LastUpdatedAt

The timestamp when the AgentCore Runtime was last updated.

Status

The current status of the AgentCore Runtime.