class BrowserCustomBase 🔹

Language	Type name
.NET	`Amazon.CDK.AWS.Bedrock.Agentcore.Alpha.BrowserCustomBase`
Go	`github.com/aws/aws-cdk-go/awsbedrockagentcorealpha/v2#BrowserCustomBase`
Java	`software.amazon.awscdk.services.bedrock.agentcore.alpha.BrowserCustomBase`
Python	`aws_cdk.aws_bedrock_agentcore_alpha.BrowserCustomBase`
TypeScript (source)	`@aws-cdk/aws-bedrock-agentcore-alpha` » `BrowserCustomBase`

Implements IConstruct, IDependable, IResource, IBrowserCustom, IGrantable, IConnectable

Extends Resource

Implemented by BrowserCustom

Abstract base class for a Browser.

Contains methods and attributes valid for Browsers either created with CDK or imported.

Initializer

new BrowserCustomBase(scope: Construct, id: string)

Parameters

scope Construct
id string

Properties

Name	Type	Description
browserArn🔹	`string`	The ARN of the browser resource.
browserId🔹	`string`	The id of the browser.
connections🔹	`Connections`	An accessor for the Connections object that will fail if this Browser does not have a VPC configured.
env🔹	`ResourceEnvironment`	The environment this resource belongs to.
executionRole🔹	`IRole`	The IAM role that provides permissions for the browser to access AWS services.
grantPrincipal🔹	`IPrincipal`	The principal to grant permissions to.
node🔹	`Node`	The tree node.
stack🔹	`Stack`	The stack in which this resource is defined.
createdAt?🔹	`string`	Timestamp when the browser was created.
lastUpdatedAt?🔹	`string`	Timestamp when the browser was last updated.
status?🔹	`string`	The status of the browser.

browserArn🔹

Type: string

The ARN of the browser resource.

browserId🔹

Type: string

The id of the browser.

connections🔹

Type: Connections

An accessor for the Connections object that will fail if this Browser does not have a VPC configured.

env🔹

Type: ResourceEnvironment

The environment this resource belongs to.

For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.

executionRole🔹

Type: IRole

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

grantPrincipal🔹

Type: IPrincipal

The principal to grant permissions to.

node🔹

Type: Node

The tree node.

stack🔹

Type: Stack

The stack in which this resource is defined.

createdAt?🔹

Type: string (optional)

Timestamp when the browser was created.

lastUpdatedAt?🔹

Type: string (optional)

Timestamp when the browser was last updated.

status?🔹

Type: string (optional)

The status of the browser.

Methods

Name	Description
applyRemovalPolicy(policy)🔹	Apply the given removal policy to this resource.
grant(grantee, ...actions)🔹	Grants IAM actions to the IAM Principal.
grantRead(grantee)🔹	Grant read permissions on this browser to an IAM principal.
grantUse(grantee)🔹	Grant invoke permissions on this browser to an IAM principal.
metric(metricName, dimensions, props?)🔹	Return the given named metric for this browser.
metricErrorsForApiOperation(operation, props?)🔹	Creates a CloudWatch metric for tracking browser errors.
metricForApiOperation(metricName, operation, props?)🔹	Creates a CloudWatch metric for tracking browser api operations..
metricInvocationsForApiOperation(operation, props?)🔹	Creates a CloudWatch metric for tracking browser invocations.
metricLatencyForApiOperation(operation, props?)🔹	Creates a CloudWatch metric for tracking browser latencies.
metricSessionDuration(props?)🔹	Creates a CloudWatch metric for tracking browser session duration.
metricSystemErrorsForApiOperation(operation, props?)🔹	Creates a CloudWatch metric for tracking browser system errors.
metricTakeOverCount(props?)🔹	Creates a CloudWatch metric for tracking browser user takeovers.
metricTakeOverDuration(props?)🔹	Creates a CloudWatch metric for tracking browser user takeovers duration.
metricTakeOverReleaseCount(props?)🔹	Creates a CloudWatch metric for tracking browser user takeovers released.
metricThrottlesForApiOperation(operation, props?)🔹	Creates a CloudWatch metric for tracking browser throttles.
metricUserErrorsForApiOperation(operation, props?)🔹	Creates a CloudWatch metric for tracking browser user errors.
toString()🔹	Returns a string representation of this construct.

applyRemovalPolicy(policy)🔹

public applyRemovalPolicy(policy: RemovalPolicy): void

Parameters

policy RemovalPolicy

Apply the given removal policy to this resource.

The Removal Policy controls what happens to this resource when it stops being managed by CloudFormation, either because you've removed it from the CDK application or because you've made a change that requires the resource to be replaced.

The resource can be deleted (RemovalPolicy.DESTROY), or left in your AWS account for data recovery and cleanup later (RemovalPolicy.RETAIN).

grant(grantee, ...actions)🔹

public grant(grantee: IGrantable, ...actions: string[]): Grant

Parameters

grantee IGrantable — - The IAM principal to grant permissions to.
actions string — - The actions to grant.

Returns

Grant

Grants IAM actions to the IAM Principal.

grantRead(grantee)🔹

public grantRead(grantee: IGrantable): Grant

Parameters

grantee IGrantable — - The IAM principal to grant read permissions to.

Returns

Grant

Grant read permissions on this browser to an IAM principal.

This includes both read permissions on the specific browser and list permissions on all browsers.

grantUse(grantee)🔹

public grantUse(grantee: IGrantable): Grant

Parameters

grantee IGrantable — - The IAM principal to grant invoke permissions to.

Returns

Grant

Grant invoke permissions on this browser to an IAM principal.

metric(metricName, dimensions, props?)🔹

public metric(metricName: string, dimensions: { [string]: string }, props?: MetricOptions): Metric

Parameters

metricName string
dimensions { [string]: string }
props MetricOptions

Returns

Metric

Return the given named metric for this browser.

By default, the metric will be calculated as a sum over a period of 5 minutes. You can customize this by using the statistic and period properties.

metricErrorsForApiOperation(operation, props?)🔹

public metricErrorsForApiOperation(operation: string, props?: MetricOptions): Metric

Parameters

operation string
props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser errors.

metricForApiOperation(metricName, operation, props?)🔹

public metricForApiOperation(metricName: string, operation: string, props?: MetricOptions): Metric

Parameters

metricName string
operation string
props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser api operations..

metricInvocationsForApiOperation(operation, props?)🔹

public metricInvocationsForApiOperation(operation: string, props?: MetricOptions): Metric

Parameters

operation string
props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser invocations.

metricLatencyForApiOperation(operation, props?)🔹

public metricLatencyForApiOperation(operation: string, props?: MetricOptions): Metric

Parameters

operation string
props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser latencies.

metricSessionDuration(props?)🔹

public metricSessionDuration(props?: MetricOptions): Metric

Parameters

props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser session duration.

metricSystemErrorsForApiOperation(operation, props?)🔹

public metricSystemErrorsForApiOperation(operation: string, props?: MetricOptions): Metric

Parameters

operation string
props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser system errors.

metricTakeOverCount(props?)🔹

public metricTakeOverCount(props?: MetricOptions): Metric

Parameters

props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser user takeovers.

metricTakeOverDuration(props?)🔹

public metricTakeOverDuration(props?: MetricOptions): Metric

Parameters

props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser user takeovers duration.

metricTakeOverReleaseCount(props?)🔹

public metricTakeOverReleaseCount(props?: MetricOptions): Metric

Parameters

props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser user takeovers released.

metricThrottlesForApiOperation(operation, props?)🔹

public metricThrottlesForApiOperation(operation: string, props?: MetricOptions): Metric

Parameters

operation string
props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser throttles.

metricUserErrorsForApiOperation(operation, props?)🔹

public metricUserErrorsForApiOperation(operation: string, props?: MetricOptions): Metric

Parameters

operation string
props MetricOptions — - Configuration options for the metric.

Returns

Metric

Creates a CloudWatch metric for tracking browser user errors.

toString()🔹

public toString(): string

Returns

string

Returns a string representation of this construct.