Skip to content

Bedrock Agentcore Control  >  Operations  >  get_agent_runtime

get_agent_runtime

Operation

get_agent_runtime async

get_agent_runtime(input: GetAgentRuntimeInput, plugins: list[Plugin] | None = None) -> GetAgentRuntimeOutput

Gets an Amazon Bedrock AgentCore Runtime.

Parameters:

Name Type Description Default
input GetAgentRuntimeInput

An instance of GetAgentRuntimeInput.

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
GetAgentRuntimeOutput

An instance of GetAgentRuntimeOutput.

Input

GetAgentRuntimeInput dataclass

Dataclass for GetAgentRuntimeInput structure.

Attributes

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

The unique identifier of the AgentCore Runtime to retrieve.

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

The version of the AgentCore Runtime to retrieve.

Output

GetAgentRuntimeOutput dataclass

Dataclass for GetAgentRuntimeOutput structure.

Attributes

agent_runtime_arn instance-attribute
agent_runtime_arn: str

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

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

The artifact of the AgentCore Runtime.

agent_runtime_id instance-attribute
agent_runtime_id: str

The unique identifier of the AgentCore Runtime.

agent_runtime_name instance-attribute
agent_runtime_name: str

The name of the AgentCore Runtime.

agent_runtime_version instance-attribute
agent_runtime_version: str

The version of the AgentCore Runtime.

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

The authorizer configuration for the AgentCore Runtime.

created_at instance-attribute
created_at: datetime

The timestamp when the AgentCore Runtime was created.

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 set in the AgentCore Runtime environment.

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

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

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

The filesystem configurations mounted into the AgentCore Runtime.

last_updated_at instance-attribute
last_updated_at: datetime

The timestamp when the AgentCore Runtime was last updated.

lifecycle_configuration instance-attribute
lifecycle_configuration: LifecycleConfiguration

The life cycle configuration for the AgentCore Runtime.

metadata_configuration class-attribute instance-attribute
metadata_configuration: RuntimeMetadataConfiguration | None = None

Configuration for microVM Metadata Service (MMDS) settings for the AgentCore Runtime.

network_configuration instance-attribute
network_configuration: NetworkConfiguration

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 instance-attribute
role_arn: str

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

status instance-attribute

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.