1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. bedrockagentcore
  5. getRuntime

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.51.0 published on Monday, Feb 2, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.bedrockagentcore.getRuntime

aws-native logo

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.51.0 published on Monday, Feb 2, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Resource Type definition for AWS::BedrockAgentCore::Runtime

    Using getRuntime

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getRuntime(args: GetRuntimeArgs, opts?: InvokeOptions): Promise<GetRuntimeResult>
function getRuntimeOutput(args: GetRuntimeOutputArgs, opts?: InvokeOptions): Output<GetRuntimeResult>
    def get_runtime(agent_runtime_id: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetRuntimeResult
def get_runtime_output(agent_runtime_id: Optional[pulumi.Input[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetRuntimeResult]
    func LookupRuntime(ctx *Context, args *LookupRuntimeArgs, opts ...InvokeOption) (*LookupRuntimeResult, error)
func LookupRuntimeOutput(ctx *Context, args *LookupRuntimeOutputArgs, opts ...InvokeOption) LookupRuntimeResultOutput

    > Note: This function is named LookupRuntime in the Go SDK.

    public static class GetRuntime 
{
    public static Task<GetRuntimeResult> InvokeAsync(GetRuntimeArgs args, InvokeOptions? opts = null)
    public static Output<GetRuntimeResult> Invoke(GetRuntimeInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetRuntimeResult> getRuntime(GetRuntimeArgs args, InvokeOptions options)
public static Output<GetRuntimeResult> getRuntime(GetRuntimeArgs args, InvokeOptions options)

    fn::invoke:
  function: aws-native:bedrockagentcore:getRuntime
  arguments:
    # arguments dictionary

    The following arguments are supported:

    AgentRuntimeId string
    Identifier for a resource
    AgentRuntimeId string
    Identifier for a resource
    agentRuntimeId String
    Identifier for a resource
    agentRuntimeId string
    Identifier for a resource
    agent_runtime_id str
    Identifier for a resource
    agentRuntimeId String
    Identifier for a resource

    getRuntime Result

    The following output properties are available:

    AgentRuntimeArn string
    The Amazon Resource Name(ARN) that uniquely identifies the Agent
    AgentRuntimeArtifact Pulumi.AwsNative.BedrockAgentCore.Outputs.RuntimeAgentRuntimeArtifact
    The artifact of the agent
    AgentRuntimeId string
    Identifier for a resource
    AgentRuntimeVersion string
    Version of the Agent
    AuthorizerConfiguration Pulumi.AwsNative.BedrockAgentCore.Outputs.RuntimeAuthorizerConfiguration
    Authorizer configuration for the agent runtime
    CreatedAt string
    Timestamp when the Agent was created
    Description string
    Description of the resource
    EnvironmentVariables Dictionary<string, string>
    Environment variables for the agent runtime
    FailureReason string
    The reason for failure if the agent is in a failed state.
    LastUpdatedAt string
    When resource was last updated
    LifecycleConfiguration Pulumi.AwsNative.BedrockAgentCore.Outputs.RuntimeLifecycleConfiguration
    Lifecycle configuration for managing runtime sessions
    NetworkConfiguration Pulumi.AwsNative.BedrockAgentCore.Outputs.RuntimeNetworkConfiguration
    Network access configuration for the Agent
    ProtocolConfiguration Pulumi.AwsNative.BedrockAgentCore.RuntimeProtocolConfiguration
    Protocol configuration for the agent runtime
    RequestHeaderConfiguration Pulumi.AwsNative.BedrockAgentCore.Outputs.RuntimeRequestHeaderConfiguration
    Configuration for HTTP request headers
    RoleArn string
    Amazon Resource Name (ARN) of an IAM role
    Status Pulumi.AwsNative.BedrockAgentCore.RuntimeAgentStatus
    Current status of the agent
    Tags Dictionary<string, string>
    The tags for the agent.
    WorkloadIdentityDetails Pulumi.AwsNative.BedrockAgentCore.Outputs.RuntimeWorkloadIdentityDetails
    Workload identity details for the agent
    AgentRuntimeArn string
    The Amazon Resource Name(ARN) that uniquely identifies the Agent
    AgentRuntimeArtifact RuntimeAgentRuntimeArtifact
    The artifact of the agent
    AgentRuntimeId string
    Identifier for a resource
    AgentRuntimeVersion string
    Version of the Agent
    AuthorizerConfiguration RuntimeAuthorizerConfiguration
    Authorizer configuration for the agent runtime
    CreatedAt string
    Timestamp when the Agent was created
    Description string
    Description of the resource
    EnvironmentVariables map[string]string
    Environment variables for the agent runtime
    FailureReason string
    The reason for failure if the agent is in a failed state.
    LastUpdatedAt string
    When resource was last updated
    LifecycleConfiguration RuntimeLifecycleConfiguration
    Lifecycle configuration for managing runtime sessions
    NetworkConfiguration RuntimeNetworkConfiguration
    Network access configuration for the Agent
    ProtocolConfiguration RuntimeProtocolConfiguration
    Protocol configuration for the agent runtime
    RequestHeaderConfiguration RuntimeRequestHeaderConfiguration
    Configuration for HTTP request headers
    RoleArn string
    Amazon Resource Name (ARN) of an IAM role
    Status RuntimeAgentStatus
    Current status of the agent
    Tags map[string]string
    The tags for the agent.
    WorkloadIdentityDetails RuntimeWorkloadIdentityDetails
    Workload identity details for the agent
    agentRuntimeArn String
    The Amazon Resource Name(ARN) that uniquely identifies the Agent
    agentRuntimeArtifact RuntimeAgentRuntimeArtifact
    The artifact of the agent
    agentRuntimeId String
    Identifier for a resource
    agentRuntimeVersion String
    Version of the Agent
    authorizerConfiguration RuntimeAuthorizerConfiguration
    Authorizer configuration for the agent runtime
    createdAt String
    Timestamp when the Agent was created
    description String
    Description of the resource
    environmentVariables Map<String,String>
    Environment variables for the agent runtime
    failureReason String
    The reason for failure if the agent is in a failed state.
    lastUpdatedAt String
    When resource was last updated
    lifecycleConfiguration RuntimeLifecycleConfiguration
    Lifecycle configuration for managing runtime sessions
    networkConfiguration RuntimeNetworkConfiguration
    Network access configuration for the Agent
    protocolConfiguration RuntimeProtocolConfiguration
    Protocol configuration for the agent runtime
    requestHeaderConfiguration RuntimeRequestHeaderConfiguration
    Configuration for HTTP request headers
    roleArn String
    Amazon Resource Name (ARN) of an IAM role
    status RuntimeAgentStatus
    Current status of the agent
    tags Map<String,String>
    The tags for the agent.
    workloadIdentityDetails RuntimeWorkloadIdentityDetails
    Workload identity details for the agent
    agentRuntimeArn string
    The Amazon Resource Name(ARN) that uniquely identifies the Agent
    agentRuntimeArtifact RuntimeAgentRuntimeArtifact
    The artifact of the agent
    agentRuntimeId string
    Identifier for a resource
    agentRuntimeVersion string
    Version of the Agent
    authorizerConfiguration RuntimeAuthorizerConfiguration
    Authorizer configuration for the agent runtime
    createdAt string
    Timestamp when the Agent was created
    description string
    Description of the resource
    environmentVariables {[key: string]: string}
    Environment variables for the agent runtime
    failureReason string
    The reason for failure if the agent is in a failed state.
    lastUpdatedAt string
    When resource was last updated
    lifecycleConfiguration RuntimeLifecycleConfiguration
    Lifecycle configuration for managing runtime sessions
    networkConfiguration RuntimeNetworkConfiguration
    Network access configuration for the Agent
    protocolConfiguration RuntimeProtocolConfiguration
    Protocol configuration for the agent runtime
    requestHeaderConfiguration RuntimeRequestHeaderConfiguration
    Configuration for HTTP request headers
    roleArn string
    Amazon Resource Name (ARN) of an IAM role
    status RuntimeAgentStatus
    Current status of the agent
    tags {[key: string]: string}
    The tags for the agent.
    workloadIdentityDetails RuntimeWorkloadIdentityDetails
    Workload identity details for the agent
    agent_runtime_arn str
    The Amazon Resource Name(ARN) that uniquely identifies the Agent
    agent_runtime_artifact RuntimeAgentRuntimeArtifact
    The artifact of the agent
    agent_runtime_id str
    Identifier for a resource
    agent_runtime_version str
    Version of the Agent
    authorizer_configuration RuntimeAuthorizerConfiguration
    Authorizer configuration for the agent runtime
    created_at str
    Timestamp when the Agent was created
    description str
    Description of the resource
    environment_variables Mapping[str, str]
    Environment variables for the agent runtime
    failure_reason str
    The reason for failure if the agent is in a failed state.
    last_updated_at str
    When resource was last updated
    lifecycle_configuration RuntimeLifecycleConfiguration
    Lifecycle configuration for managing runtime sessions
    network_configuration RuntimeNetworkConfiguration
    Network access configuration for the Agent
    protocol_configuration RuntimeProtocolConfiguration
    Protocol configuration for the agent runtime
    request_header_configuration RuntimeRequestHeaderConfiguration
    Configuration for HTTP request headers
    role_arn str
    Amazon Resource Name (ARN) of an IAM role
    status RuntimeAgentStatus
    Current status of the agent
    tags Mapping[str, str]
    The tags for the agent.
    workload_identity_details RuntimeWorkloadIdentityDetails
    Workload identity details for the agent
    agentRuntimeArn String
    The Amazon Resource Name(ARN) that uniquely identifies the Agent
    agentRuntimeArtifact Property Map
    The artifact of the agent
    agentRuntimeId String
    Identifier for a resource
    agentRuntimeVersion String
    Version of the Agent
    authorizerConfiguration Property Map
    Authorizer configuration for the agent runtime
    createdAt String
    Timestamp when the Agent was created
    description String
    Description of the resource
    environmentVariables Map<String>
    Environment variables for the agent runtime
    failureReason String
    The reason for failure if the agent is in a failed state.
    lastUpdatedAt String
    When resource was last updated
    lifecycleConfiguration Property Map
    Lifecycle configuration for managing runtime sessions
    networkConfiguration Property Map
    Network access configuration for the Agent
    protocolConfiguration "MCP" | "HTTP" | "A2A"
    Protocol configuration for the agent runtime
    requestHeaderConfiguration Property Map
    Configuration for HTTP request headers
    roleArn String
    Amazon Resource Name (ARN) of an IAM role
    status "CREATING" | "CREATE_FAILED" | "UPDATING" | "UPDATE_FAILED" | "READY" | "DELETING"
    Current status of the agent
    tags Map<String>
    The tags for the agent.
    workloadIdentityDetails Property Map
    Workload identity details for the agent

    Supporting Types

    RuntimeAgentManagedRuntimeType

    RuntimeAgentRuntimeArtifact

    codeConfiguration Property Map
    containerConfiguration Property Map
    Representation of a container configuration.

    RuntimeAgentStatus

    RuntimeAuthorizerConfiguration

    CustomJwtAuthorizer Pulumi.AwsNative.BedrockAgentCore.Inputs.RuntimeCustomJwtAuthorizerConfiguration
    Represents inbound authorization configuration options used to authenticate incoming requests.
    CustomJwtAuthorizer RuntimeCustomJwtAuthorizerConfiguration
    Represents inbound authorization configuration options used to authenticate incoming requests.
    customJwtAuthorizer RuntimeCustomJwtAuthorizerConfiguration
    Represents inbound authorization configuration options used to authenticate incoming requests.
    customJwtAuthorizer RuntimeCustomJwtAuthorizerConfiguration
    Represents inbound authorization configuration options used to authenticate incoming requests.
    custom_jwt_authorizer RuntimeCustomJwtAuthorizerConfiguration
    Represents inbound authorization configuration options used to authenticate incoming requests.
    customJwtAuthorizer Property Map
    Represents inbound authorization configuration options used to authenticate incoming requests.

    RuntimeAuthorizingClaimMatchValueType

    RuntimeClaimMatchOperator

    RuntimeClaimMatchValueType

    RuntimeCode

    RuntimeCodeConfiguration

    RuntimeContainerConfiguration

    ContainerUri string
    The container Uri.
    ContainerUri string
    The container Uri.
    containerUri String
    The container Uri.
    containerUri string
    The container Uri.
    container_uri str
    The container Uri.
    containerUri String
    The container Uri.

    RuntimeCustomClaimValidationType

    RuntimeCustomJwtAuthorizerConfiguration

    DiscoveryUrl string
    The configuration authorization.
    AllowedAudience List<string>
    Represents inbound authorization configuration options used to authenticate incoming requests.
    AllowedClients List<string>
    Represents individual client IDs that are validated in the incoming JWT token validation process.
    AllowedScopes List<string>
    CustomClaims List<Pulumi.AwsNative.BedrockAgentCore.Inputs.RuntimeCustomClaimValidationType>
    DiscoveryUrl string
    The configuration authorization.
    AllowedAudience []string
    Represents inbound authorization configuration options used to authenticate incoming requests.
    AllowedClients []string
    Represents individual client IDs that are validated in the incoming JWT token validation process.
    AllowedScopes []string
    CustomClaims []RuntimeCustomClaimValidationType
    discoveryUrl String
    The configuration authorization.
    allowedAudience List<String>
    Represents inbound authorization configuration options used to authenticate incoming requests.
    allowedClients List<String>
    Represents individual client IDs that are validated in the incoming JWT token validation process.
    allowedScopes List<String>
    customClaims List<RuntimeCustomClaimValidationType>
    discoveryUrl string
    The configuration authorization.
    allowedAudience string[]
    Represents inbound authorization configuration options used to authenticate incoming requests.
    allowedClients string[]
    Represents individual client IDs that are validated in the incoming JWT token validation process.
    allowedScopes string[]
    customClaims RuntimeCustomClaimValidationType[]
    discovery_url str
    The configuration authorization.
    allowed_audience Sequence[str]
    Represents inbound authorization configuration options used to authenticate incoming requests.
    allowed_clients Sequence[str]
    Represents individual client IDs that are validated in the incoming JWT token validation process.
    allowed_scopes Sequence[str]
    custom_claims Sequence[RuntimeCustomClaimValidationType]
    discoveryUrl String
    The configuration authorization.
    allowedAudience List<String>
    Represents inbound authorization configuration options used to authenticate incoming requests.
    allowedClients List<String>
    Represents individual client IDs that are validated in the incoming JWT token validation process.
    allowedScopes List<String>
    customClaims List<Property Map>

    RuntimeInboundTokenClaimValueType

    RuntimeLifecycleConfiguration

    IdleRuntimeSessionTimeout int
    Timeout in seconds for idle runtime sessions
    MaxLifetime int
    Maximum lifetime in seconds for runtime sessions
    IdleRuntimeSessionTimeout int
    Timeout in seconds for idle runtime sessions
    MaxLifetime int
    Maximum lifetime in seconds for runtime sessions
    idleRuntimeSessionTimeout Integer
    Timeout in seconds for idle runtime sessions
    maxLifetime Integer
    Maximum lifetime in seconds for runtime sessions
    idleRuntimeSessionTimeout number
    Timeout in seconds for idle runtime sessions
    maxLifetime number
    Maximum lifetime in seconds for runtime sessions
    idle_runtime_session_timeout int
    Timeout in seconds for idle runtime sessions
    max_lifetime int
    Maximum lifetime in seconds for runtime sessions
    idleRuntimeSessionTimeout Number
    Timeout in seconds for idle runtime sessions
    maxLifetime Number
    Maximum lifetime in seconds for runtime sessions

    RuntimeNetworkConfiguration

    RuntimeNetworkMode

    RuntimeProtocolConfiguration

    RuntimeRequestHeaderConfiguration

    RuntimeS3Location

    Bucket string
    S3 bucket name
    Prefix string
    S3 object key prefix
    VersionId string
    S3 object version ID
    Bucket string
    S3 bucket name
    Prefix string
    S3 object key prefix
    VersionId string
    S3 object version ID
    bucket String
    S3 bucket name
    prefix String
    S3 object key prefix
    versionId String
    S3 object version ID
    bucket string
    S3 bucket name
    prefix string
    S3 object key prefix
    versionId string
    S3 object version ID
    bucket str
    S3 bucket name
    prefix str
    S3 object key prefix
    version_id str
    S3 object version ID
    bucket String
    S3 bucket name
    prefix String
    S3 object key prefix
    versionId String
    S3 object version ID

    RuntimeVpcConfig

    SecurityGroups List<string>
    Subnets List<string>
    SecurityGroups []string
    Subnets []string
    securityGroups List<String>
    subnets List<String>
    securityGroups string[]
    subnets string[]
    security_groups Sequence[str]
    subnets Sequence[str]
    securityGroups List<String>
    subnets List<String>

    RuntimeWorkloadIdentityDetails

    WorkloadIdentityArn string
    The Amazon Resource Name (ARN) for the workload identity.
    WorkloadIdentityArn string
    The Amazon Resource Name (ARN) for the workload identity.
    workloadIdentityArn String
    The Amazon Resource Name (ARN) for the workload identity.
    workloadIdentityArn string
    The Amazon Resource Name (ARN) for the workload identity.
    workload_identity_arn str
    The Amazon Resource Name (ARN) for the workload identity.
    workloadIdentityArn String
    The Amazon Resource Name (ARN) for the workload identity.

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    AWS Cloud Control v1.51.0 published on Monday, Feb 2, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native
      Meet Neo: Your AI Platform Teammate