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.36.0 published on Friday, Oct 3, 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.36.0 published on Friday, Oct 3, 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>
    The tags for the agent.
    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
    The tags for the agent.
    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>
    The tags for the agent.
    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}
    The tags for the agent.
    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]
    The tags for the agent.
    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>
    The tags for the agent.

    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

    ContainerConfiguration RuntimeContainerConfiguration
    Representation of a container configuration.
    containerConfiguration RuntimeContainerConfiguration
    Representation of a container configuration.
    containerConfiguration RuntimeContainerConfiguration
    Representation of a container configuration.
    container_configuration RuntimeContainerConfiguration
    Representation of a container configuration.
    containerConfiguration Property Map
    Representation of a container configuration.

    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

    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.

    RuntimeContainerConfiguration, RuntimeContainerConfigurationArgs

    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.

    RuntimeCustomJwtAuthorizerConfiguration, RuntimeCustomJwtAuthorizerConfigurationArgs

    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.
    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.
    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.
    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.
    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.
    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.

    RuntimeNetworkConfiguration, RuntimeNetworkConfigurationArgs

    networkMode "PUBLIC"
    The network mode.

    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

    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.36.0 published on Friday, Oct 3, 2025 by Pulumi
      AI Agentic Workflows: Register now