RuntimeProps

class aws_cdk.aws_bedrock_agentcore_alpha.RuntimeProps(*, agent_runtime_artifact, runtime_name, authorizer_configuration=None, description=None, environment_variables=None, execution_role=None, lifecycle_configuration=None, network_configuration=None, protocol_configuration=None, request_header_configuration=None, tags=None)

Bases: object

(experimental) Properties for creating a Bedrock Agent Core Runtime resource.

Parameters:

  • agent_runtime_artifact (AgentRuntimeArtifact) – (experimental) The artifact configuration for the agent runtime Contains the container configuration with ECR URI.

  • runtime_name (str) – (experimental) 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}$.

  • authorizer_configuration (Optional[RuntimeAuthorizerConfiguration]) – (experimental) Authorizer configuration for the agent runtime Use RuntimeAuthorizerConfiguration static methods to create the configuration. Default: - RuntimeAuthorizerConfiguration.iam() (IAM authentication)

  • description (Optional[str]) – (experimental) Optional description for the agent runtime. Default: - No description Length Minimum: 1 , Maximum: 1200

  • environment_variables (Optional[Mapping[str, str]]) – (experimental) 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

  • execution_role (Optional[IRole]) – (experimental) 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

  • lifecycle_configuration (Union[LifecycleConfiguration, Dict[str, Any], None]) – (experimental) The life cycle configuration for the AgentCore Runtime. Default: - No lifecycle configuration

  • network_configuration (Optional[RuntimeNetworkConfiguration]) – (experimental) Network configuration for the agent runtime. Default: - RuntimeNetworkConfiguration.usingPublicNetwork()

  • protocol_configuration (Optional[ProtocolType]) – (experimental) Protocol configuration for the agent runtime. Default: - ProtocolType.HTTP

  • request_header_configuration (Union[RequestHeaderConfiguration, Dict[str, Any], None]) – (experimental) Configuration for HTTP request headers that will be passed through to the runtime. Default: - No request headers configured

  • tags (Optional[Mapping[str, str]]) – (experimental) Tags for the agent runtime A list of key:value pairs of tags to apply to this Runtime resource. Default: {} - no tags

Stability:

experimental

ExampleMetadata:

fixture=default infused

Example:

repository = ecr.Repository(self, "TestRepository",
    repository_name="test-agent-runtime"
)
agent_runtime_artifact = agentcore.AgentRuntimeArtifact.from_ecr_repository(repository, "v1.0.0")

runtime = agentcore.Runtime(self, "MyAgentRuntime",
    runtime_name="myAgent",
    agent_runtime_artifact=agent_runtime_artifact,
    authorizer_configuration=agentcore.RuntimeAuthorizerConfiguration.using_oAuth("https://github.com/.well-known/openid-configuration", "oauth_client_123")
)

Attributes

agent_runtime_artifact

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

Stability:

experimental

authorizer_configuration

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

Default:

  • RuntimeAuthorizerConfiguration.iam() (IAM authentication)

Stability:

experimental

description

(experimental) Optional description for the agent runtime.

Default:

  • No description

Length Minimum: 1 , Maximum: 1200

Stability:

experimental

environment_variables

Must be 0-2048 characters (per CloudFormation specification).

Default:

  • No environment variables

Stability:

experimental

Type:

(experimental) Environment variables for the agent runtime - Maximum 50 environment variables - Key

Type:

Must be 1-100 characters, start with letter or underscore, contain only letters, numbers, and underscores - Value

execution_role

(experimental) 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

Stability:

experimental

lifecycle_configuration

(experimental) The life cycle configuration for the AgentCore Runtime.

Default:

  • No lifecycle configuration

Stability:

experimental

network_configuration

(experimental) Network configuration for the agent runtime.

Default:

  • RuntimeNetworkConfiguration.usingPublicNetwork()

Stability:

experimental

protocol_configuration

(experimental) Protocol configuration for the agent runtime.

Default:

  • ProtocolType.HTTP

Stability:

experimental

request_header_configuration

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

Default:

  • No request headers configured

Stability:

experimental

runtime_name

^[a-zA-Z][a-zA-Z0-9_]{0,47}$.

Stability:

experimental

Type:

(experimental) 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

tags

value pairs of tags to apply to this Runtime resource.

Default:

{} - no tags

Stability:

experimental

Type:

(experimental) Tags for the agent runtime A list of key