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 |
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 |
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.
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.
workload_identity_details
class-attribute
instance-attribute
¶
workload_identity_details: WorkloadIdentityDetails | None = None
The workload identity details for the AgentCore Runtime.