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

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

AWS Cloud Control v1.35.0 published on Monday, Sep 22, 2025 by Pulumi

aws-native.bedrockagentcore.Runtime

Explore with Pulumi AI

aws-native logo

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

AWS Cloud Control v1.35.0 published on Monday, Sep 22, 2025 by Pulumi

    Resource Type definition for AWS::BedrockAgentCore::Runtime

    Create Runtime Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Runtime(name: string, args: RuntimeArgs, opts?: CustomResourceOptions);
    @overload
    def Runtime(resource_name: str,
                args: RuntimeArgs,
                opts: Optional[ResourceOptions] = None)
    
    @overload
    def Runtime(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                agent_runtime_artifact: Optional[RuntimeAgentRuntimeArtifactArgs] = None,
                agent_runtime_name: Optional[str] = None,
                network_configuration: Optional[RuntimeNetworkConfigurationArgs] = None,
                role_arn: Optional[str] = None,
                authorizer_configuration: Optional[RuntimeAuthorizerConfigurationArgs] = None,
                description: Optional[str] = None,
                environment_variables: Optional[Mapping[str, str]] = None,
                protocol_configuration: Optional[RuntimeProtocolConfiguration] = None,
                tags: Optional[Mapping[str, str]] = None)
    func NewRuntime(ctx *Context, name string, args RuntimeArgs, opts ...ResourceOption) (*Runtime, error)
    public Runtime(string name, RuntimeArgs args, CustomResourceOptions? opts = null)
    public Runtime(String name, RuntimeArgs args)
    public Runtime(String name, RuntimeArgs args, CustomResourceOptions options)
    
    type: aws-native:bedrockagentcore:Runtime
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args RuntimeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args RuntimeArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args RuntimeArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args RuntimeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args RuntimeArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Runtime Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Runtime resource accepts the following input properties:

    AgentRuntimeArtifact Pulumi.AwsNative.BedrockAgentCore.Inputs.RuntimeAgentRuntimeArtifact
    The artifact of the agent
    AgentRuntimeName string
    Name for a resource
    NetworkConfiguration Pulumi.AwsNative.BedrockAgentCore.Inputs.RuntimeNetworkConfiguration
    Network access configuration for the Agent
    RoleArn string
    Amazon Resource Name (ARN) of an IAM role
    AuthorizerConfiguration Pulumi.AwsNative.BedrockAgentCore.Inputs.RuntimeAuthorizerConfiguration
    Authorizer configuration for the agent runtime
    Description string
    Description of the resource
    EnvironmentVariables Dictionary<string, string>
    Environment variables for the agent runtime
    ProtocolConfiguration Pulumi.AwsNative.BedrockAgentCore.RuntimeProtocolConfiguration
    Protocol configuration for the agent runtime
    Tags Dictionary<string, string>
    AgentRuntimeArtifact RuntimeAgentRuntimeArtifactArgs
    The artifact of the agent
    AgentRuntimeName string
    Name for a resource
    NetworkConfiguration RuntimeNetworkConfigurationArgs
    Network access configuration for the Agent
    RoleArn string
    Amazon Resource Name (ARN) of an IAM role
    AuthorizerConfiguration RuntimeAuthorizerConfigurationArgs
    Authorizer configuration for the agent runtime
    Description string
    Description of the resource
    EnvironmentVariables map[string]string
    Environment variables for the agent runtime
    ProtocolConfiguration RuntimeProtocolConfiguration
    Protocol configuration for the agent runtime
    Tags map[string]string
    agentRuntimeArtifact RuntimeAgentRuntimeArtifact
    The artifact of the agent
    agentRuntimeName String
    Name for a resource
    networkConfiguration RuntimeNetworkConfiguration
    Network access configuration for the Agent
    roleArn String
    Amazon Resource Name (ARN) of an IAM role
    authorizerConfiguration RuntimeAuthorizerConfiguration
    Authorizer configuration for the agent runtime
    description String
    Description of the resource
    environmentVariables Map<String,String>
    Environment variables for the agent runtime
    protocolConfiguration RuntimeProtocolConfiguration
    Protocol configuration for the agent runtime
    tags Map<String,String>
    agentRuntimeArtifact RuntimeAgentRuntimeArtifact
    The artifact of the agent
    agentRuntimeName string
    Name for a resource
    networkConfiguration RuntimeNetworkConfiguration
    Network access configuration for the Agent
    roleArn string
    Amazon Resource Name (ARN) of an IAM role
    authorizerConfiguration RuntimeAuthorizerConfiguration
    Authorizer configuration for the agent runtime
    description string
    Description of the resource
    environmentVariables {[key: string]: string}
    Environment variables for the agent runtime
    protocolConfiguration RuntimeProtocolConfiguration
    Protocol configuration for the agent runtime
    tags {[key: string]: string}
    agent_runtime_artifact RuntimeAgentRuntimeArtifactArgs
    The artifact of the agent
    agent_runtime_name str
    Name for a resource
    network_configuration RuntimeNetworkConfigurationArgs
    Network access configuration for the Agent
    role_arn str
    Amazon Resource Name (ARN) of an IAM role
    authorizer_configuration RuntimeAuthorizerConfigurationArgs
    Authorizer configuration for the agent runtime
    description str
    Description of the resource
    environment_variables Mapping[str, str]
    Environment variables for the agent runtime
    protocol_configuration RuntimeProtocolConfiguration
    Protocol configuration for the agent runtime
    tags Mapping[str, str]
    agentRuntimeArtifact Property Map
    The artifact of the agent
    agentRuntimeName String
    Name for a resource
    networkConfiguration Property Map
    Network access configuration for the Agent
    roleArn String
    Amazon Resource Name (ARN) of an IAM role
    authorizerConfiguration Property Map
    Authorizer configuration for the agent runtime
    description String
    Description of the resource
    environmentVariables Map<String>
    Environment variables for the agent runtime
    protocolConfiguration "MCP" | "HTTP"
    Protocol configuration for the agent runtime
    tags Map<String>

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Runtime resource produces the following output properties:

    AgentRuntimeArn string
    The Amazon Resource Name(ARN) that uniquely identifies the Agent
    AgentRuntimeId string
    Identifier for a resource
    AgentRuntimeVersion string
    Version of the Agent
    CreatedAt string
    Timestamp when the Agent was created
    Id string
    The provider-assigned unique ID for this managed resource.
    LastUpdatedAt string
    When resource was last updated
    Status Pulumi.AwsNative.BedrockAgentCore.RuntimeAgentStatus
    Current status of 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
    AgentRuntimeId string
    Identifier for a resource
    AgentRuntimeVersion string
    Version of the Agent
    CreatedAt string
    Timestamp when the Agent was created
    Id string
    The provider-assigned unique ID for this managed resource.
    LastUpdatedAt string
    When resource was last updated
    Status RuntimeAgentStatus
    Current status of the agent
    WorkloadIdentityDetails RuntimeWorkloadIdentityDetails
    Workload identity details for the agent
    agentRuntimeArn String
    The Amazon Resource Name(ARN) that uniquely identifies the Agent
    agentRuntimeId String
    Identifier for a resource
    agentRuntimeVersion String
    Version of the Agent
    createdAt String
    Timestamp when the Agent was created
    id String
    The provider-assigned unique ID for this managed resource.
    lastUpdatedAt String
    When resource was last updated
    status RuntimeAgentStatus
    Current status of the agent
    workloadIdentityDetails RuntimeWorkloadIdentityDetails
    Workload identity details for the agent
    agentRuntimeArn string
    The Amazon Resource Name(ARN) that uniquely identifies the Agent
    agentRuntimeId string
    Identifier for a resource
    agentRuntimeVersion string
    Version of the Agent
    createdAt string
    Timestamp when the Agent was created
    id string
    The provider-assigned unique ID for this managed resource.
    lastUpdatedAt string
    When resource was last updated
    status RuntimeAgentStatus
    Current status of 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_id str
    Identifier for a resource
    agent_runtime_version str
    Version of the Agent
    created_at str
    Timestamp when the Agent was created
    id str
    The provider-assigned unique ID for this managed resource.
    last_updated_at str
    When resource was last updated
    status RuntimeAgentStatus
    Current status of the agent
    workload_identity_details RuntimeWorkloadIdentityDetails
    Workload identity details for the agent
    agentRuntimeArn String
    The Amazon Resource Name(ARN) that uniquely identifies the Agent
    agentRuntimeId String
    Identifier for a resource
    agentRuntimeVersion String
    Version of the Agent
    createdAt String
    Timestamp when the Agent was created
    id String
    The provider-assigned unique ID for this managed resource.
    lastUpdatedAt String
    When resource was last updated
    status "CREATING" | "CREATE_FAILED" | "UPDATING" | "UPDATE_FAILED" | "READY" | "DELETING"
    Current status of the agent
    workloadIdentityDetails Property Map
    Workload identity details for the agent

    Supporting Types

    RuntimeAgentRuntimeArtifact, RuntimeAgentRuntimeArtifactArgs

    RuntimeAgentStatus, RuntimeAgentStatusArgs

    Creating
    CREATING
    CreateFailed
    CREATE_FAILED
    Updating
    UPDATING
    UpdateFailed
    UPDATE_FAILED
    Ready
    READY
    Deleting
    DELETING
    RuntimeAgentStatusCreating
    CREATING
    RuntimeAgentStatusCreateFailed
    CREATE_FAILED
    RuntimeAgentStatusUpdating
    UPDATING
    RuntimeAgentStatusUpdateFailed
    UPDATE_FAILED
    RuntimeAgentStatusReady
    READY
    RuntimeAgentStatusDeleting
    DELETING
    Creating
    CREATING
    CreateFailed
    CREATE_FAILED
    Updating
    UPDATING
    UpdateFailed
    UPDATE_FAILED
    Ready
    READY
    Deleting
    DELETING
    Creating
    CREATING
    CreateFailed
    CREATE_FAILED
    Updating
    UPDATING
    UpdateFailed
    UPDATE_FAILED
    Ready
    READY
    Deleting
    DELETING
    CREATING
    CREATING
    CREATE_FAILED
    CREATE_FAILED
    UPDATING
    UPDATING
    UPDATE_FAILED
    UPDATE_FAILED
    READY
    READY
    DELETING
    DELETING
    "CREATING"
    CREATING
    "CREATE_FAILED"
    CREATE_FAILED
    "UPDATING"
    UPDATING
    "UPDATE_FAILED"
    UPDATE_FAILED
    "READY"
    READY
    "DELETING"
    DELETING

    RuntimeAuthorizerConfiguration, RuntimeAuthorizerConfigurationArgs

    RuntimeContainerConfiguration, RuntimeContainerConfigurationArgs

    RuntimeCustomJwtAuthorizerConfiguration, RuntimeCustomJwtAuthorizerConfigurationArgs

    DiscoveryUrl string
    AllowedAudience List<string>
    AllowedClients List<string>
    discoveryUrl String
    allowedAudience List<String>
    allowedClients List<String>
    discovery_url str
    allowed_audience Sequence[str]
    allowed_clients Sequence[str]
    discoveryUrl String
    allowedAudience List<String>
    allowedClients List<String>

    RuntimeNetworkConfiguration, RuntimeNetworkConfigurationArgs

    RuntimeNetworkMode, RuntimeNetworkModeArgs

    Public
    PUBLIC
    RuntimeNetworkModePublic
    PUBLIC
    Public
    PUBLIC
    Public
    PUBLIC
    PUBLIC
    PUBLIC
    "PUBLIC"
    PUBLIC

    RuntimeProtocolConfiguration, RuntimeProtocolConfigurationArgs

    Mcp
    MCP
    Http
    HTTP
    RuntimeProtocolConfigurationMcp
    MCP
    RuntimeProtocolConfigurationHttp
    HTTP
    Mcp
    MCP
    Http
    HTTP
    Mcp
    MCP
    Http
    HTTP
    MCP
    MCP
    HTTP
    HTTP
    "MCP"
    MCP
    "HTTP"
    HTTP

    RuntimeWorkloadIdentityDetails, RuntimeWorkloadIdentityDetailsArgs

    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.35.0 published on Monday, Sep 22, 2025 by Pulumi