Class RuntimeProps.Builder

java.lang.Object
software.amazon.awscdk.services.bedrockagentcore.RuntimeProps.Builder
All Implemented Interfaces:
software.amazon.jsii.Builder<RuntimeProps>
Enclosing interface:
RuntimeProps

@Stability(Stable) public static final class RuntimeProps.Builder extends Object implements software.amazon.jsii.Builder<RuntimeProps>
A builder for RuntimeProps
  • Constructor Details

    • Builder

      public Builder()
  • Method Details

    • agentRuntimeArtifact

      @Stability(Stable) public RuntimeProps.Builder agentRuntimeArtifact(AgentRuntimeArtifact agentRuntimeArtifact)
      Parameters:
      agentRuntimeArtifact - The artifact configuration for the agent runtime Contains the container configuration with ECR URI. This parameter is required.
      Returns:
      this
    • authorizerConfiguration

      @Stability(Stable) public RuntimeProps.Builder authorizerConfiguration(RuntimeAuthorizerConfiguration authorizerConfiguration)
      Parameters:
      authorizerConfiguration - Authorizer configuration for the agent runtime Use RuntimeAuthorizerConfiguration static methods to create the configuration.
      Returns:
      this
    • description

      @Stability(Stable) public RuntimeProps.Builder description(String description)
      Parameters:
      description - Optional description for the agent runtime.
      Returns:
      this
    • environmentVariables

      @Stability(Stable) public RuntimeProps.Builder environmentVariables(Map<String,String> environmentVariables)
      Parameters:
      environmentVariables - Environment variables for the agent runtime - Maximum 50 environment variables - Key: Must be 1-100 characters, start with letter or underscore, contain only letters, numbers, and underscores - Value: Must be 0-2048 characters (per CloudFormation specification).
      Returns:
      this
    • executionRole

      @Stability(Stable) public RuntimeProps.Builder executionRole(IRole executionRole)
      Parameters:
      executionRole - The IAM role that provides permissions for the agent runtime If not provided, a role will be created automatically.
      Returns:
      this
    • lifecycleConfiguration

      @Stability(Stable) public RuntimeProps.Builder lifecycleConfiguration(LifecycleConfiguration lifecycleConfiguration)
      Parameters:
      lifecycleConfiguration - The life cycle configuration for the AgentCore Runtime.
      Returns:
      this
    • loggingConfigs

      @Stability(Stable) public RuntimeProps.Builder loggingConfigs(List<? extends LoggingConfig> loggingConfigs)
      Parameters:
      loggingConfigs - Logging configuration for the runtime. Allows sending APPLICATION_LOGS and USAGE_LOGS to CloudWatch Logs, S3, or Kinesis Data Firehose.
      Returns:
      this
    • manageDeliveryResourcePolicy

      @Stability(Stable) public RuntimeProps.Builder manageDeliveryResourcePolicy(Boolean manageDeliveryResourcePolicy)
      Parameters:
      manageDeliveryResourcePolicy - Whether to create resource policies for log/trace delivery. When false, the AWS::Logs::ResourcePolicy and AWS::XRay::ResourcePolicy are not created. This is useful when deploying many runtimes per account/Region, as each resource policy consumes an account-level quota slot (CloudWatch Logs: 10, X-Ray: lower).

      Setting false means you are responsible for ensuring delivery permissions exist. There are two safe ways to use this:

      • Same-account delivery to a /aws/vendedlogs/ log group, where the log-delivery service-linked role grants write access implicitly.
      • Attaching the delivery resource policy yourself.

      Otherwise delivery silently fails: synthesis and deploy succeed, but nothing is delivered. Per the vended-logs delivery docs, a resource policy is required for CloudWatch Logs delivery outside the /aws/vendedlogs/ same-account case.

      Returns:
      this
    • networkConfiguration

      @Stability(Stable) public RuntimeProps.Builder networkConfiguration(RuntimeNetworkConfiguration networkConfiguration)
      Parameters:
      networkConfiguration - Network configuration for the agent runtime.
      Returns:
      this
    • protocolConfiguration

      @Stability(Stable) public RuntimeProps.Builder protocolConfiguration(ProtocolType protocolConfiguration)
      Parameters:
      protocolConfiguration - Protocol configuration for the agent runtime.
      Returns:
      this
    • requestHeaderConfiguration

      @Stability(Stable) public RuntimeProps.Builder requestHeaderConfiguration(RequestHeaderConfiguration requestHeaderConfiguration)
      Parameters:
      requestHeaderConfiguration - Configuration for HTTP request headers that will be passed through to the runtime.
      Returns:
      this
    • runtimeName

      @Stability(Stable) public RuntimeProps.Builder runtimeName(String runtimeName)
      Parameters:
      runtimeName - The name of the agent runtime Valid characters are a-z, A-Z, 0-9, _ (underscore) Must start with a letter and can be up to 48 characters long Pattern: ^[a-zA-Z][a-zA-Z0-9_]{0,47}$.
      Returns:
      this
    • tags

      @Stability(Stable) public RuntimeProps.Builder tags(Map<String,String> tags)
      Sets the value of RuntimeProps.getTags()
      Parameters:
      tags - Tags for the agent runtime A list of key:value pairs of tags to apply to this Runtime resource.
      Returns:
      this
    • tracingEnabled

      @Stability(Stable) public RuntimeProps.Builder tracingEnabled(Boolean tracingEnabled)
      Parameters:
      tracingEnabled - Whether to enable X-Ray tracing for this runtime. When enabled, traces will be delivered to AWS X-Ray.
      Returns:
      this
    • build

      @Stability(Stable) public RuntimeProps build()
      Builds the configured instance.
      Specified by:
      build in interface software.amazon.jsii.Builder<RuntimeProps>
      Returns:
      a new instance of RuntimeProps
      Throws:
      NullPointerException - if any required attribute was not provided