Skip to content

Bedrock Agentcore Control  >  Operations  >  create_agent_runtime

create_agent_runtime

Operation

create_agent_runtime async 

create_agent_runtime(input: CreateAgentRuntimeInput, plugins: list[Plugin] | None = None) -> CreateAgentRuntimeOutput

Creates an Amazon Bedrock AgentCore Runtime.

Parameters:

Name Type Description Default
input CreateAgentRuntimeInput

An instance of CreateAgentRuntimeInput.

 required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

 None

Returns:

Type Description
CreateAgentRuntimeOutput

An instance of CreateAgentRuntimeOutput.

Input

CreateAgentRuntimeInput dataclass

Dataclass for CreateAgentRuntimeInput structure.

Attributes

agent_runtime_artifact class-attribute instance-attribute 
agent_runtime_artifact: AgentRuntimeArtifact | None = None

The artifact of the AgentCore Runtime.

agent_runtime_name class-attribute instance-attribute 
agent_runtime_name: str | None = None

The name of the AgentCore Runtime.

authorizer_configuration class-attribute instance-attribute 
authorizer_configuration: AuthorizerConfiguration | None = None

The authorizer configuration for the AgentCore Runtime.

capacity_provider_configuration class-attribute instance-attribute 
capacity_provider_configuration: CapacityProviderConfiguration | None = None

The capacity provider configuration for the AgentCore Runtime. Use a capacity provider to run the AgentCore Runtime on the Instances compute type, which provisions Amazon Web Services managed compute in your account.

client_token class-attribute instance-attribute 
client_token: str | None = None

A unique, case-sensitive identifier to ensure idempotency of the request.

description class-attribute instance-attribute 
description: str | None = field(repr=False, default=None)

The description of the AgentCore Runtime.

environment_variables class-attribute instance-attribute 
environment_variables: dict[str, str] | None = field(repr=False, default=None)

Environment variables to set in the AgentCore Runtime environment.

filesystem_configurations class-attribute instance-attribute 
filesystem_configurations: list[FilesystemConfiguration] | None = None

The filesystem configurations to mount into the AgentCore Runtime. Use filesystem configurations to provide persistent storage to your AgentCore Runtime sessions.

lifecycle_configuration class-attribute instance-attribute 
lifecycle_configuration: LifecycleConfiguration | None = None

The life cycle configuration for the AgentCore Runtime.

network_configuration class-attribute instance-attribute 
network_configuration: NetworkConfiguration | None = None

The network configuration for the AgentCore Runtime.

protocol_configuration class-attribute instance-attribute 
protocol_configuration: ProtocolConfiguration | None = None

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

request_header_configuration class-attribute instance-attribute 
request_header_configuration: RequestHeaderConfiguration | None = None

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

role_arn class-attribute instance-attribute 
role_arn: str | None = None

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

tags class-attribute instance-attribute 
tags: dict[str, str] | None = None

A map of tag keys and values to assign to the agent runtime. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.

Output

CreateAgentRuntimeOutput dataclass

Dataclass for CreateAgentRuntimeOutput structure.

Attributes

agent_runtime_arn instance-attribute 
agent_runtime_arn: str

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

agent_runtime_id instance-attribute 
agent_runtime_id: str

The unique identifier of the AgentCore Runtime.

agent_runtime_version instance-attribute 
agent_runtime_version: str

The version of the AgentCore Runtime.

created_at instance-attribute 
created_at: datetime

The timestamp when the AgentCore Runtime was created.

status instance-attribute 
status: AgentRuntimeStatus

The current status of the AgentCore Runtime.

workload_identity_details class-attribute instance-attribute 
workload_identity_details: WorkloadIdentityDetails | None = None

The workload identity details for the AgentCore Runtime.