Amazon Bedrock AgentCore Control

2026/07/23 - Amazon Bedrock AgentCore Control - 4 updated api methods

Changes  Adds support for the Bring Your Own Storage(BYOS) feature in AgentCore Browser and Code Interpreter. Enables mounting S3Files and EFS File Systems via Access points.

CreateBrowser (updated) Link ¶
Changes (request)
{'filesystemConfigurations': [{'efsConfiguration': {'accessPointArn': 'string',
                                                    'fileSystemArn': 'string',
                                                    'mountPath': 'string'},
                               's3FilesConfiguration': {'accessPointArn': 'string',
                                                        'fileSystemArn': 'string',
                                                        'mountPath': 'string'}}]}

Creates a custom browser.

See also: AWS API Documentation

Request Syntax

client.create_browser(
    name='string',
    description='string',
    executionRoleArn='string',
    networkConfiguration={
        'networkMode': 'PUBLIC'|'VPC',
        'vpcConfig': {
            'securityGroups': [
                'string',
            ],
            'subnets': [
                'string',
            ],
            'requireServiceS3Endpoint': True|False
        }
    },
    recording={
        'enabled': True|False,
        's3Location': {
            'bucket': 'string',
            'prefix': 'string',
            'versionId': 'string'
        }
    },
    browserSigning={
        'enabled': True|False
    },
    enterprisePolicies=[
        {
            'location': {
                's3': {
                    'bucket': 'string',
                    'prefix': 'string',
                    'versionId': 'string'
                }
            },
            'type': 'MANAGED'|'RECOMMENDED'
        },
    ],
    certificates=[
        {
            'location': {
                'secretsManager': {
                    'secretArn': 'string'
                }
            }
        },
    ],
    filesystemConfigurations=[
        {
            's3FilesConfiguration': {
                'accessPointArn': 'string',
                'mountPath': 'string',
                'fileSystemArn': 'string'
            },
            'efsConfiguration': {
                'accessPointArn': 'string',
                'mountPath': 'string',
                'fileSystemArn': 'string'
            }
        },
    ],
    clientToken='string',
    tags={
        'string': 'string'
    }
)
type name:

string

param name:

[REQUIRED]

The name of the browser. The name must be unique within your account.

type description:

string

param description:

The description of the browser.

type executionRoleArn:

string

param executionRoleArn:

The Amazon Resource Name (ARN) of the IAM role that provides permissions for the browser to access Amazon Web Services services.

type networkConfiguration:

dict

param networkConfiguration:

[REQUIRED]

The network configuration for the browser. This configuration specifies the network mode for the browser.

  • networkMode (string) -- [REQUIRED]

    The network mode for the browser. This field specifies how the browser connects to the network.

  • vpcConfig (dict) --

    The VPC configuration for the browser. This configuration is required when the network mode is set to VPC.

    • securityGroups (list) -- [REQUIRED]

      The security groups associated with the VPC configuration.

      • (string) --

    • subnets (list) -- [REQUIRED]

      The subnets associated with the VPC configuration.

      • (string) --

    • requireServiceS3Endpoint (boolean) --

      Controls whether a service-managed Amazon S3 gateway endpoint is provisioned in the VPC network topology for the agent runtime. This gateway is used by Amazon Bedrock AgentCore Runtime to download code and container images during agent startup.

      Starting May 5, 2026, Amazon Bedrock AgentCore Runtime is gradually rolling out a change to how network isolation is configured for VPC mode agents. Agent runtimes created on or after this rollout will no longer include the service-managed Amazon S3 gateway. Instead, all network access, including to Amazon S3, is governed exclusively by your VPC configuration. This field cannot be set on agent runtimes created after the rollout. Passing this field in an UpdateAgentRuntime request for these agent runtimes returns a ValidationException.

      Agent runtimes created before the rollout are not affected and continue to operate with the service-managed Amazon S3 gateway. To enforce full VPC network isolation on these existing agent runtimes, set this field to false via the UpdateAgentRuntime API. Before opting out, ensure your VPC provides the Amazon S3 access required for agent startup. If this field is not specified or is set to true, the service-managed Amazon S3 gateway remains provisioned.

      This field is only supported in the UpdateAgentRuntime API for pre-rollout agent runtimes. Passing this field in a CreateAgentRuntime request returns a ValidationException.

type recording:

dict

param recording:

The recording configuration for the browser. When enabled, browser sessions are recorded and stored in the specified Amazon S3 location.

  • enabled (boolean) --

    Indicates whether recording is enabled for the browser. When set to true, browser sessions are recorded.

  • s3Location (dict) --

    The Amazon S3 location where browser recordings are stored. This location contains the recorded browser sessions.

    • bucket (string) -- [REQUIRED]

      The name of the Amazon S3 bucket. This bucket contains the stored data.

    • prefix (string) -- [REQUIRED]

      The prefix for objects in the Amazon S3 bucket. This prefix is added to the object keys to organize the data.

    • versionId (string) --

      The version ID of the Amazon Amazon S3 object. If not specified, the latest version of the object is used.

type browserSigning:

dict

param browserSigning:

The browser signing configuration that enables cryptographic agent identification using HTTP message signatures for web bot authentication.

  • enabled (boolean) -- [REQUIRED]

    Specifies whether browser signing is enabled. When enabled, the browser will cryptographically sign HTTP requests to identify itself as an AI agent to bot control vendors.

type enterprisePolicies:

list

param enterprisePolicies:

A list of enterprise policy files for the browser.

  • (dict) --

    Browser enterprise policy configuration.

    • location (dict) -- [REQUIRED]

      The location of the enterprise policy file.

      • s3 (dict) --

        The Amazon S3 location for storing data. This structure defines where in Amazon S3 data is stored.

        • bucket (string) -- [REQUIRED]

          The name of the Amazon S3 bucket. This bucket contains the stored data.

        • prefix (string) -- [REQUIRED]

          The prefix for objects in the Amazon S3 bucket. This prefix is added to the object keys to organize the data.

        • versionId (string) --

          The version ID of the Amazon Amazon S3 object. If not specified, the latest version of the object is used.

    • type (string) --

      The type of browser enterprise policy. Available values are MANAGED and RECOMMENDED.

type certificates:

list

param certificates:

A list of certificates to install in the browser.

  • (dict) --

    A certificate to install in the browser or code interpreter.

    • location (dict) -- [REQUIRED]

      The location of the certificate.

      • secretsManager (dict) --

        The Amazon Web Services Secrets Manager location of the certificate.

        • secretArn (string) -- [REQUIRED]

          The ARN of the Amazon Web Services Secrets Manager secret containing the certificate.

type filesystemConfigurations:

list

param filesystemConfigurations:

The file system configurations to mount into the browser. Use these configurations to mount your own Amazon Simple Storage Service (Amazon S3) Files or Amazon Elastic File System (Amazon EFS) access points. Your sessions can then access your data. If you don't specify this field, no file systems are mounted.

  • (dict) --

    Specifies a file system to mount into the session by providing exactly one of the following:

    • s3FilesConfiguration - Mounts an Amazon Simple Storage Service (Amazon S3) Files access point.

    • efsConfiguration - Mounts an Amazon Elastic File System (Amazon EFS) access point.

    • s3FilesConfiguration (dict) --

      The configuration for mounting your own Amazon Simple Storage Service (Amazon S3) Files access point into the session.

      • accessPointArn (string) -- [REQUIRED]

        The Amazon Resource Name (ARN) of the Amazon Simple Storage Service (Amazon S3) Files access point to mount.

      • mountPath (string) -- [REQUIRED]

        The absolute path within the session at which the access point is mounted, for example /mnt/s3data. Each mount path must be unique across all file system configurations in the session.

      • fileSystemArn (string) -- [REQUIRED]

        The Amazon Resource Name (ARN) of the Amazon Simple Storage Service (Amazon S3) Files file system that owns the access point.

    • efsConfiguration (dict) --

      The configuration for mounting your own Amazon Elastic File System (Amazon EFS) access point into the session.

      • accessPointArn (string) -- [REQUIRED]

        The Amazon Resource Name (ARN) of the Amazon Elastic File System (Amazon EFS) access point to mount.

      • mountPath (string) -- [REQUIRED]

        The absolute path within the session at which the access point is mounted, for example /mnt/efs. Each mount path must be unique across all file system configurations in the session.

      • fileSystemArn (string) -- [REQUIRED]

        The Amazon Resource Name (ARN) of the Amazon Elastic File System (Amazon EFS) file system that owns the access point.

type clientToken:

string

param clientToken:

A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock AgentCore ignores the request but does not return an error.

This field is autopopulated if not provided.

type tags:

dict

param tags:

A map of tag keys and values to assign to the browser. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{
    'browserId': 'string',
    'browserArn': 'string',
    'createdAt': datetime(2015, 1, 1),
    'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED'
}

Response Structure

  • (dict) --

    • browserId (string) --

      The unique identifier of the created browser.

    • browserArn (string) --

      The Amazon Resource Name (ARN) of the created browser.

    • createdAt (datetime) --

      The timestamp when the browser was created.

    • status (string) --

      The current status of the browser.

CreateCodeInterpreter (updated) Link ¶
Changes (request)
{'filesystemConfigurations': [{'efsConfiguration': {'accessPointArn': 'string',
                                                    'fileSystemArn': 'string',
                                                    'mountPath': 'string'},
                               's3FilesConfiguration': {'accessPointArn': 'string',
                                                        'fileSystemArn': 'string',
                                                        'mountPath': 'string'}}]}

Creates a custom code interpreter.

See also: AWS API Documentation

Request Syntax

client.create_code_interpreter(
    name='string',
    description='string',
    executionRoleArn='string',
    networkConfiguration={
        'networkMode': 'PUBLIC'|'SANDBOX'|'VPC',
        'vpcConfig': {
            'securityGroups': [
                'string',
            ],
            'subnets': [
                'string',
            ],
            'requireServiceS3Endpoint': True|False
        }
    },
    certificates=[
        {
            'location': {
                'secretsManager': {
                    'secretArn': 'string'
                }
            }
        },
    ],
    filesystemConfigurations=[
        {
            's3FilesConfiguration': {
                'accessPointArn': 'string',
                'mountPath': 'string',
                'fileSystemArn': 'string'
            },
            'efsConfiguration': {
                'accessPointArn': 'string',
                'mountPath': 'string',
                'fileSystemArn': 'string'
            }
        },
    ],
    clientToken='string',
    tags={
        'string': 'string'
    }
)
type name:

string

param name:

[REQUIRED]

The name of the code interpreter. The name must be unique within your account.

type description:

string

param description:

The description of the code interpreter.

type executionRoleArn:

string

param executionRoleArn:

The Amazon Resource Name (ARN) of the IAM role that provides permissions for the code interpreter to access Amazon Web Services services.

type networkConfiguration:

dict

param networkConfiguration:

[REQUIRED]

The network configuration for the code interpreter. This configuration specifies the network mode for the code interpreter.

  • networkMode (string) -- [REQUIRED]

    The network mode for the code interpreter. This field specifies how the code interpreter connects to the network.

  • vpcConfig (dict) --

    The VPC configuration for the code interpreter. This configuration is required when the network mode is set to VPC.

    • securityGroups (list) -- [REQUIRED]

      The security groups associated with the VPC configuration.

      • (string) --

    • subnets (list) -- [REQUIRED]

      The subnets associated with the VPC configuration.

      • (string) --

    • requireServiceS3Endpoint (boolean) --

      Controls whether a service-managed Amazon S3 gateway endpoint is provisioned in the VPC network topology for the agent runtime. This gateway is used by Amazon Bedrock AgentCore Runtime to download code and container images during agent startup.

      Starting May 5, 2026, Amazon Bedrock AgentCore Runtime is gradually rolling out a change to how network isolation is configured for VPC mode agents. Agent runtimes created on or after this rollout will no longer include the service-managed Amazon S3 gateway. Instead, all network access, including to Amazon S3, is governed exclusively by your VPC configuration. This field cannot be set on agent runtimes created after the rollout. Passing this field in an UpdateAgentRuntime request for these agent runtimes returns a ValidationException.

      Agent runtimes created before the rollout are not affected and continue to operate with the service-managed Amazon S3 gateway. To enforce full VPC network isolation on these existing agent runtimes, set this field to false via the UpdateAgentRuntime API. Before opting out, ensure your VPC provides the Amazon S3 access required for agent startup. If this field is not specified or is set to true, the service-managed Amazon S3 gateway remains provisioned.

      This field is only supported in the UpdateAgentRuntime API for pre-rollout agent runtimes. Passing this field in a CreateAgentRuntime request returns a ValidationException.

type certificates:

list

param certificates:

A list of certificates to install in the code interpreter.

  • (dict) --

    A certificate to install in the browser or code interpreter.

    • location (dict) -- [REQUIRED]

      The location of the certificate.

      • secretsManager (dict) --

        The Amazon Web Services Secrets Manager location of the certificate.

        • secretArn (string) -- [REQUIRED]

          The ARN of the Amazon Web Services Secrets Manager secret containing the certificate.

type filesystemConfigurations:

list

param filesystemConfigurations:

The file system configurations to mount into the code interpreter. Use these configurations to mount your own Amazon Simple Storage Service (Amazon S3) Files or Amazon Elastic File System (Amazon EFS) access points. Your sessions can then access your data. If you don't specify this field, no file systems are mounted.

  • (dict) --

    Specifies a file system to mount into the session by providing exactly one of the following:

    • s3FilesConfiguration - Mounts an Amazon Simple Storage Service (Amazon S3) Files access point.

    • efsConfiguration - Mounts an Amazon Elastic File System (Amazon EFS) access point.

    • s3FilesConfiguration (dict) --

      The configuration for mounting your own Amazon Simple Storage Service (Amazon S3) Files access point into the session.

      • accessPointArn (string) -- [REQUIRED]

        The Amazon Resource Name (ARN) of the Amazon Simple Storage Service (Amazon S3) Files access point to mount.

      • mountPath (string) -- [REQUIRED]

        The absolute path within the session at which the access point is mounted, for example /mnt/s3data. Each mount path must be unique across all file system configurations in the session.

      • fileSystemArn (string) -- [REQUIRED]

        The Amazon Resource Name (ARN) of the Amazon Simple Storage Service (Amazon S3) Files file system that owns the access point.

    • efsConfiguration (dict) --

      The configuration for mounting your own Amazon Elastic File System (Amazon EFS) access point into the session.

      • accessPointArn (string) -- [REQUIRED]

        The Amazon Resource Name (ARN) of the Amazon Elastic File System (Amazon EFS) access point to mount.

      • mountPath (string) -- [REQUIRED]

        The absolute path within the session at which the access point is mounted, for example /mnt/efs. Each mount path must be unique across all file system configurations in the session.

      • fileSystemArn (string) -- [REQUIRED]

        The Amazon Resource Name (ARN) of the Amazon Elastic File System (Amazon EFS) file system that owns the access point.

type clientToken:

string

param clientToken:

A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock AgentCore ignores the request but does not return an error.

This field is autopopulated if not provided.

type tags:

dict

param tags:

A map of tag keys and values to assign to the code interpreter. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment.

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{
    'codeInterpreterId': 'string',
    'codeInterpreterArn': 'string',
    'createdAt': datetime(2015, 1, 1),
    'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED'
}

Response Structure

  • (dict) --

    • codeInterpreterId (string) --

      The unique identifier of the created code interpreter.

    • codeInterpreterArn (string) --

      The Amazon Resource Name (ARN) of the created code interpreter.

    • createdAt (datetime) --

      The timestamp when the code interpreter was created.

    • status (string) --

      The current status of the code interpreter.

GetBrowser (updated) Link ¶
Changes (response)
{'filesystemConfigurations': [{'efsConfiguration': {'accessPointArn': 'string',
                                                    'fileSystemArn': 'string',
                                                    'mountPath': 'string'},
                               's3FilesConfiguration': {'accessPointArn': 'string',
                                                        'fileSystemArn': 'string',
                                                        'mountPath': 'string'}}]}

Gets information about a custom browser.

See also: AWS API Documentation

Request Syntax

client.get_browser(
    browserId='string'
)
type browserId:

string

param browserId:

[REQUIRED]

The unique identifier of the browser to retrieve.

rtype:

dict

returns:

Response Syntax

{
    'browserId': 'string',
    'browserArn': 'string',
    'name': 'string',
    'description': 'string',
    'executionRoleArn': 'string',
    'networkConfiguration': {
        'networkMode': 'PUBLIC'|'VPC',
        'vpcConfig': {
            'securityGroups': [
                'string',
            ],
            'subnets': [
                'string',
            ],
            'requireServiceS3Endpoint': True|False
        }
    },
    'recording': {
        'enabled': True|False,
        's3Location': {
            'bucket': 'string',
            'prefix': 'string',
            'versionId': 'string'
        }
    },
    'browserSigning': {
        'enabled': True|False
    },
    'enterprisePolicies': [
        {
            'location': {
                's3': {
                    'bucket': 'string',
                    'prefix': 'string',
                    'versionId': 'string'
                }
            },
            'type': 'MANAGED'|'RECOMMENDED'
        },
    ],
    'certificates': [
        {
            'location': {
                'secretsManager': {
                    'secretArn': 'string'
                }
            }
        },
    ],
    'filesystemConfigurations': [
        {
            's3FilesConfiguration': {
                'accessPointArn': 'string',
                'mountPath': 'string',
                'fileSystemArn': 'string'
            },
            'efsConfiguration': {
                'accessPointArn': 'string',
                'mountPath': 'string',
                'fileSystemArn': 'string'
            }
        },
    ],
    'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED',
    'failureReason': 'string',
    'createdAt': datetime(2015, 1, 1),
    'lastUpdatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • browserId (string) --

      The unique identifier of the browser.

    • browserArn (string) --

      The Amazon Resource Name (ARN) of the browser.

    • name (string) --

      The name of the browser.

    • description (string) --

      The description of the browser.

    • executionRoleArn (string) --

      The IAM role ARN that provides permissions for the browser.

    • networkConfiguration (dict) --

      The network configuration for a browser. This structure defines how the browser connects to the network.

      • networkMode (string) --

        The network mode for the browser. This field specifies how the browser connects to the network.

      • vpcConfig (dict) --

        The VPC configuration for the browser. This configuration is required when the network mode is set to VPC.

        • securityGroups (list) --

          The security groups associated with the VPC configuration.

          • (string) --

        • subnets (list) --

          The subnets associated with the VPC configuration.

          • (string) --

        • requireServiceS3Endpoint (boolean) --

          Controls whether a service-managed Amazon S3 gateway endpoint is provisioned in the VPC network topology for the agent runtime. This gateway is used by Amazon Bedrock AgentCore Runtime to download code and container images during agent startup.

          Starting May 5, 2026, Amazon Bedrock AgentCore Runtime is gradually rolling out a change to how network isolation is configured for VPC mode agents. Agent runtimes created on or after this rollout will no longer include the service-managed Amazon S3 gateway. Instead, all network access, including to Amazon S3, is governed exclusively by your VPC configuration. This field cannot be set on agent runtimes created after the rollout. Passing this field in an UpdateAgentRuntime request for these agent runtimes returns a ValidationException.

          Agent runtimes created before the rollout are not affected and continue to operate with the service-managed Amazon S3 gateway. To enforce full VPC network isolation on these existing agent runtimes, set this field to false via the UpdateAgentRuntime API. Before opting out, ensure your VPC provides the Amazon S3 access required for agent startup. If this field is not specified or is set to true, the service-managed Amazon S3 gateway remains provisioned.

          This field is only supported in the UpdateAgentRuntime API for pre-rollout agent runtimes. Passing this field in a CreateAgentRuntime request returns a ValidationException.

    • recording (dict) --

      The recording configuration for a browser. This structure defines how browser sessions are recorded.

      • enabled (boolean) --

        Indicates whether recording is enabled for the browser. When set to true, browser sessions are recorded.

      • s3Location (dict) --

        The Amazon S3 location where browser recordings are stored. This location contains the recorded browser sessions.

        • bucket (string) --

          The name of the Amazon S3 bucket. This bucket contains the stored data.

        • prefix (string) --

          The prefix for objects in the Amazon S3 bucket. This prefix is added to the object keys to organize the data.

        • versionId (string) --

          The version ID of the Amazon Amazon S3 object. If not specified, the latest version of the object is used.

    • browserSigning (dict) --

      The browser signing configuration that shows whether cryptographic agent identification is enabled for web bot authentication.

      • enabled (boolean) --

        Indicates whether browser signing is currently enabled for cryptographic agent identification using HTTP message signatures.

    • enterprisePolicies (list) --

      The list of enterprise policy files configured for the browser.

      • (dict) --

        Browser enterprise policy configuration.

        • location (dict) --

          The location of the enterprise policy file.

          • s3 (dict) --

            The Amazon S3 location for storing data. This structure defines where in Amazon S3 data is stored.

            • bucket (string) --

              The name of the Amazon S3 bucket. This bucket contains the stored data.

            • prefix (string) --

              The prefix for objects in the Amazon S3 bucket. This prefix is added to the object keys to organize the data.

            • versionId (string) --

              The version ID of the Amazon Amazon S3 object. If not specified, the latest version of the object is used.

        • type (string) --

          The type of browser enterprise policy. Available values are MANAGED and RECOMMENDED.

    • certificates (list) --

      The list of certificates configured for the browser.

      • (dict) --

        A certificate to install in the browser or code interpreter.

        • location (dict) --

          The location of the certificate.

          • secretsManager (dict) --

            The Amazon Web Services Secrets Manager location of the certificate.

            • secretArn (string) --

              The ARN of the Amazon Web Services Secrets Manager secret containing the certificate.

    • filesystemConfigurations (list) --

      The file system configurations mounted into the browser. Each entry describes an access point and its mount path.

      • (dict) --

        Specifies a file system to mount into the session by providing exactly one of the following:

        • s3FilesConfiguration - Mounts an Amazon Simple Storage Service (Amazon S3) Files access point.

        • efsConfiguration - Mounts an Amazon Elastic File System (Amazon EFS) access point.

        • s3FilesConfiguration (dict) --

          The configuration for mounting your own Amazon Simple Storage Service (Amazon S3) Files access point into the session.

          • accessPointArn (string) --

            The Amazon Resource Name (ARN) of the Amazon Simple Storage Service (Amazon S3) Files access point to mount.

          • mountPath (string) --

            The absolute path within the session at which the access point is mounted, for example /mnt/s3data. Each mount path must be unique across all file system configurations in the session.

          • fileSystemArn (string) --

            The Amazon Resource Name (ARN) of the Amazon Simple Storage Service (Amazon S3) Files file system that owns the access point.

        • efsConfiguration (dict) --

          The configuration for mounting your own Amazon Elastic File System (Amazon EFS) access point into the session.

          • accessPointArn (string) --

            The Amazon Resource Name (ARN) of the Amazon Elastic File System (Amazon EFS) access point to mount.

          • mountPath (string) --

            The absolute path within the session at which the access point is mounted, for example /mnt/efs. Each mount path must be unique across all file system configurations in the session.

          • fileSystemArn (string) --

            The Amazon Resource Name (ARN) of the Amazon Elastic File System (Amazon EFS) file system that owns the access point.

    • status (string) --

      The current status of the browser.

    • failureReason (string) --

      The reason for failure if the browser is in a failed state.

    • createdAt (datetime) --

      The timestamp when the browser was created.

    • lastUpdatedAt (datetime) --

      The timestamp when the browser was last updated.

GetCodeInterpreter (updated) Link ¶
Changes (response)
{'filesystemConfigurations': [{'efsConfiguration': {'accessPointArn': 'string',
                                                    'fileSystemArn': 'string',
                                                    'mountPath': 'string'},
                               's3FilesConfiguration': {'accessPointArn': 'string',
                                                        'fileSystemArn': 'string',
                                                        'mountPath': 'string'}}]}

Gets information about a custom code interpreter.

See also: AWS API Documentation

Request Syntax

client.get_code_interpreter(
    codeInterpreterId='string'
)
type codeInterpreterId:

string

param codeInterpreterId:

[REQUIRED]

The unique identifier of the code interpreter to retrieve.

rtype:

dict

returns:

Response Syntax

{
    'codeInterpreterId': 'string',
    'codeInterpreterArn': 'string',
    'name': 'string',
    'description': 'string',
    'executionRoleArn': 'string',
    'networkConfiguration': {
        'networkMode': 'PUBLIC'|'SANDBOX'|'VPC',
        'vpcConfig': {
            'securityGroups': [
                'string',
            ],
            'subnets': [
                'string',
            ],
            'requireServiceS3Endpoint': True|False
        }
    },
    'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED',
    'certificates': [
        {
            'location': {
                'secretsManager': {
                    'secretArn': 'string'
                }
            }
        },
    ],
    'filesystemConfigurations': [
        {
            's3FilesConfiguration': {
                'accessPointArn': 'string',
                'mountPath': 'string',
                'fileSystemArn': 'string'
            },
            'efsConfiguration': {
                'accessPointArn': 'string',
                'mountPath': 'string',
                'fileSystemArn': 'string'
            }
        },
    ],
    'failureReason': 'string',
    'createdAt': datetime(2015, 1, 1),
    'lastUpdatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • codeInterpreterId (string) --

      The unique identifier of the code interpreter.

    • codeInterpreterArn (string) --

      The Amazon Resource Name (ARN) of the code interpreter.

    • name (string) --

      The name of the code interpreter.

    • description (string) --

      The description of the code interpreter.

    • executionRoleArn (string) --

      The IAM role ARN that provides permissions for the code interpreter.

    • networkConfiguration (dict) --

      The network configuration for a code interpreter. This structure defines how the code interpreter connects to the network.

      • networkMode (string) --

        The network mode for the code interpreter. This field specifies how the code interpreter connects to the network.

      • vpcConfig (dict) --

        The VPC configuration for the code interpreter. This configuration is required when the network mode is set to VPC.

        • securityGroups (list) --

          The security groups associated with the VPC configuration.

          • (string) --

        • subnets (list) --

          The subnets associated with the VPC configuration.

          • (string) --

        • requireServiceS3Endpoint (boolean) --

          Controls whether a service-managed Amazon S3 gateway endpoint is provisioned in the VPC network topology for the agent runtime. This gateway is used by Amazon Bedrock AgentCore Runtime to download code and container images during agent startup.

          Starting May 5, 2026, Amazon Bedrock AgentCore Runtime is gradually rolling out a change to how network isolation is configured for VPC mode agents. Agent runtimes created on or after this rollout will no longer include the service-managed Amazon S3 gateway. Instead, all network access, including to Amazon S3, is governed exclusively by your VPC configuration. This field cannot be set on agent runtimes created after the rollout. Passing this field in an UpdateAgentRuntime request for these agent runtimes returns a ValidationException.

          Agent runtimes created before the rollout are not affected and continue to operate with the service-managed Amazon S3 gateway. To enforce full VPC network isolation on these existing agent runtimes, set this field to false via the UpdateAgentRuntime API. Before opting out, ensure your VPC provides the Amazon S3 access required for agent startup. If this field is not specified or is set to true, the service-managed Amazon S3 gateway remains provisioned.

          This field is only supported in the UpdateAgentRuntime API for pre-rollout agent runtimes. Passing this field in a CreateAgentRuntime request returns a ValidationException.

    • status (string) --

      The current status of the code interpreter.

    • certificates (list) --

      The list of certificates configured for the code interpreter.

      • (dict) --

        A certificate to install in the browser or code interpreter.

        • location (dict) --

          The location of the certificate.

          • secretsManager (dict) --

            The Amazon Web Services Secrets Manager location of the certificate.

            • secretArn (string) --

              The ARN of the Amazon Web Services Secrets Manager secret containing the certificate.

    • filesystemConfigurations (list) --

      The file system configurations mounted into the code interpreter. Each entry describes an access point and its mount path.

      • (dict) --

        Specifies a file system to mount into the session by providing exactly one of the following:

        • s3FilesConfiguration - Mounts an Amazon Simple Storage Service (Amazon S3) Files access point.

        • efsConfiguration - Mounts an Amazon Elastic File System (Amazon EFS) access point.

        • s3FilesConfiguration (dict) --

          The configuration for mounting your own Amazon Simple Storage Service (Amazon S3) Files access point into the session.

          • accessPointArn (string) --

            The Amazon Resource Name (ARN) of the Amazon Simple Storage Service (Amazon S3) Files access point to mount.

          • mountPath (string) --

            The absolute path within the session at which the access point is mounted, for example /mnt/s3data. Each mount path must be unique across all file system configurations in the session.

          • fileSystemArn (string) --

            The Amazon Resource Name (ARN) of the Amazon Simple Storage Service (Amazon S3) Files file system that owns the access point.

        • efsConfiguration (dict) --

          The configuration for mounting your own Amazon Elastic File System (Amazon EFS) access point into the session.

          • accessPointArn (string) --

            The Amazon Resource Name (ARN) of the Amazon Elastic File System (Amazon EFS) access point to mount.

          • mountPath (string) --

            The absolute path within the session at which the access point is mounted, for example /mnt/efs. Each mount path must be unique across all file system configurations in the session.

          • fileSystemArn (string) --

            The Amazon Resource Name (ARN) of the Amazon Elastic File System (Amazon EFS) file system that owns the access point.

    • failureReason (string) --

      The reason for failure if the code interpreter is in a failed state.

    • createdAt (datetime) --

      The timestamp when the code interpreter was created.

    • lastUpdatedAt (datetime) --

      The timestamp when the code interpreter was last updated.