Package software.amazon.awscdk.services.bedrockagentcore

Class CodeInterpreterCustom

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.bedrockagentcore.CodeInterpreterCustomBase

software.amazon.awscdk.services.bedrockagentcore.CodeInterpreterCustom

All Implemented Interfaces:

ICodeInterpreterCustomRef, IEnvironmentAware, IResource, ICodeInterpreterCustom, IConnectable, IGrantable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.130.0 (build 048a5ee)",
           date="2026-05-19T19:44:37.063Z")
@Stability(Stable)
public class CodeInterpreterCustom
extends CodeInterpreterCustomBase

Custom code interpreter resource for AWS Bedrock Agent Core.

Provides a sandboxed environment for code execution with configurable network access.

Example:

 // Create a custom execution role
 Role executionRole = Role.Builder.create(this, "CodeInterpreterExecutionRole")
         .assumedBy(new ServicePrincipal("bedrock-agentcore.amazonaws.com"))
         .build();
 // Create code interpreter with custom execution role
 CodeInterpreterCustom codeInterpreter = CodeInterpreterCustom.Builder.create(this, "MyCodeInterpreter")
         .codeInterpreterCustomName("my_code_interpreter")
         .description("Code interpreter with custom execution role")
         .networkConfiguration(CodeInterpreterNetworkConfiguration.usingPublicNetwork())
         .executionRole(executionRole)
         .build();
 

See Also:

• https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/code-interpreter.html

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	CodeInterpreterCustom.Builder	A fluent builder for CodeInterpreterCustom.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.bedrockagentcore.ICodeInterpreterCustom

ICodeInterpreterCustom.Jsii$Default

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.IResource

IResource.Jsii$Default

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PROPERTY_INJECTION_ID	Uniquely identifies this class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CodeInterpreterCustom(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CodeInterpreterCustom(software.amazon.jsii.JsiiObjectRef objRef)
	CodeInterpreterCustom(software.constructs.Construct scope, String id)
	CodeInterpreterCustom(software.constructs.Construct scope, String id, CodeInterpreterCustomProps props)

Method Summary

Modifier and Type	Method	Description
static ICodeInterpreterCustom	fromCodeInterpreterCustomAttributes(software.constructs.Construct scope, String id, CodeInterpreterCustomAttributes attrs)	Creates an Code Interpreter Custom reference from an existing code interpreter's attributes.
String	getCodeInterpreterArn()	The ARN of the code interpreter resource.
String	getCodeInterpreterCustomName()	The name of the code interpreter.
String	getCodeInterpreterId()	The id of the code interpreter.
String	getCreatedAt()	The created timestamp of the code interpreter.
String	getDescription()	The description of the code interpreter.
IRole	getExecutionRole()	The IAM role that provides permissions for the code interpreter to access AWS services.
String	getFailureReason()	The failure reason of the code interpreter.
IPrincipal	getGrantPrincipal()	The principal to grant permissions to.
String	getLastUpdatedAt()	The last updated timestamp of the code interpreter.
CodeInterpreterNetworkConfiguration	getNetworkConfiguration()	The network configuration of the code interpreter.
String	getStatus()	The status of the code interpreter.
Map<String,String>	getTags()	Tags applied to this code interpreter resource A map of key-value pairs for resource tagging.

Methods inherited from class software.amazon.awscdk.services.bedrockagentcore.CodeInterpreterCustomBase

getCodeInterpreterCustomRef, getConnections, grant, grantInvoke, grantRead, grantUse, metric, metric, metricErrorsForApiOperation, metricErrorsForApiOperation, metricForApiOperation, metricForApiOperation, metricInvocationsForApiOperation, metricInvocationsForApiOperation, metricLatencyForApiOperation, metricLatencyForApiOperation, metricSessionDuration, metricSessionDuration, metricSystemErrorsForApiOperation, metricSystemErrorsForApiOperation, metricThrottlesForApiOperation, metricThrottlesForApiOperation, metricUserErrorsForApiOperation, metricUserErrorsForApiOperation

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource, with

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.constructs.IConstruct

getNode, with

Methods inherited from interface software.amazon.awscdk.interfaces.IEnvironmentAware

getEnv

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getStack

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

PROPERTY_INJECTION_ID

@Stability(Stable)
public static final String PROPERTY_INJECTION_ID

Uniquely identifies this class.

Constructor Details

CodeInterpreterCustom

protected CodeInterpreterCustom(software.amazon.jsii.JsiiObjectRef objRef)

CodeInterpreterCustom

protected CodeInterpreterCustom(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

CodeInterpreterCustom

@Stability(Stable)
public CodeInterpreterCustom(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @Nullable
 CodeInterpreterCustomProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

CodeInterpreterCustom

@Stability(Stable)
public CodeInterpreterCustom(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Details

fromCodeInterpreterCustomAttributes

@Stability(Stable)
@NotNull
public static ICodeInterpreterCustom fromCodeInterpreterCustomAttributes(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 CodeInterpreterCustomAttributes attrs)

Creates an Code Interpreter Custom reference from an existing code interpreter's attributes.

Parameters:

scope -

• The construct scope.

This parameter is required.

id -

• Identifier of the construct.

This parameter is required.

attrs -

• Attributes of the existing code interpreter custom.

This parameter is required.

Returns:

An ICodeInterpreterCustom reference to the existing code interpreter

getCodeInterpreterArn

@Stability(Stable)
@NotNull
public String getCodeInterpreterArn()

The ARN of the code interpreter resource.

Specified by:

getCodeInterpreterArn in interface ICodeInterpreterCustom

Specified by:

getCodeInterpreterArn in class CodeInterpreterCustomBase

getCodeInterpreterCustomName

@Stability(Stable)
@NotNull
public String getCodeInterpreterCustomName()

The name of the code interpreter.

getCodeInterpreterId

@Stability(Stable)
@NotNull
public String getCodeInterpreterId()

The id of the code interpreter.

Specified by:

getCodeInterpreterId in interface ICodeInterpreterCustom

Specified by:

getCodeInterpreterId in class CodeInterpreterCustomBase

getExecutionRole

@Stability(Stable)
@NotNull
public IRole getExecutionRole()

The IAM role that provides permissions for the code interpreter to access AWS services.

Specified by:

getExecutionRole in interface ICodeInterpreterCustom

Specified by:

getExecutionRole in class CodeInterpreterCustomBase

getGrantPrincipal

@Stability(Stable)
@NotNull
public IPrincipal getGrantPrincipal()

The principal to grant permissions to.

Specified by:

getGrantPrincipal in interface IGrantable

Specified by:

getGrantPrincipal in class CodeInterpreterCustomBase

getNetworkConfiguration

@Stability(Stable)
@NotNull
public CodeInterpreterNetworkConfiguration getNetworkConfiguration()

The network configuration of the code interpreter.

getCreatedAt

@Stability(Stable)
@Nullable
public String getCreatedAt()

The created timestamp of the code interpreter.

Specified by:

getCreatedAt in interface ICodeInterpreterCustom

Specified by:

getCreatedAt in class CodeInterpreterCustomBase

getDescription

@Stability(Stable)
@Nullable
public String getDescription()

The description of the code interpreter.

getFailureReason

@Stability(Stable)
@Nullable
public String getFailureReason()

The failure reason of the code interpreter.

getLastUpdatedAt

@Stability(Stable)
@Nullable
public String getLastUpdatedAt()

The last updated timestamp of the code interpreter.

Specified by:

getLastUpdatedAt in interface ICodeInterpreterCustom

Specified by:

getLastUpdatedAt in class CodeInterpreterCustomBase

getStatus

@Stability(Stable)
@Nullable
public String getStatus()

The status of the code interpreter.

Specified by:

getStatus in interface ICodeInterpreterCustom

Specified by:

getStatus in class CodeInterpreterCustomBase

getTags

@Stability(Stable)
@Nullable
public Map<String,String> getTags()

Tags applied to this code interpreter resource A map of key-value pairs for resource tagging.

Default: - No tags applied