AgentcoreBrowser class
Manages an AWS Bedrock AgentCore Browser. Browser provides AI agents with web browsing capabilities, allowing them to navigate websites, extract information, and interact with web content in a controlled environment.
Example Usage
Basic Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.bedrock.AgentcoreBrowser("example", {
networkConfiguration: {
networkMode: "PUBLIC",
},
name: "example-browser",
description: "Browser for web data extraction",
});
import pulumi
import pulumi_aws as aws
example = aws.bedrock.AgentcoreBrowser("example",
network_configuration={
"network_mode": "PUBLIC",
},
name="example-browser",
description="Browser for web data extraction")
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.Bedrock.AgentcoreBrowser("example", new()
{
NetworkConfiguration = new Aws.Bedrock.Inputs.AgentcoreBrowserNetworkConfigurationArgs
{
NetworkMode = "PUBLIC",
},
Name = "example-browser",
Description = "Browser for web data extraction",
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/bedrock"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := bedrock.NewAgentcoreBrowser(ctx, "example", &bedrock.AgentcoreBrowserArgs{
NetworkConfiguration: &bedrock.AgentcoreBrowserNetworkConfigurationArgs{
NetworkMode: pulumi.String("PUBLIC"),
},
Name: pulumi.String("example-browser"),
Description: pulumi.String("Browser for web data extraction"),
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
resource "aws_bedrock_agentcorebrowser" "example" {
network_configuration = {
network_mode = "PUBLIC"
}
name = "example-browser"
description = "Browser for web data extraction"
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.bedrock.AgentcoreBrowser;
import com.pulumi.aws.bedrock.AgentcoreBrowserArgs;
import com.pulumi.aws.bedrock.inputs.AgentcoreBrowserNetworkConfigurationArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new AgentcoreBrowser("example", AgentcoreBrowserArgs.builder()
.networkConfiguration(AgentcoreBrowserNetworkConfigurationArgs.builder()
.networkMode("PUBLIC")
.build())
.name("example-browser")
.description("Browser for web data extraction")
.build());
}
}
resources:
example:
type: aws:bedrock:AgentcoreBrowser
properties:
networkConfiguration:
networkMode: PUBLIC
name: example-browser
description: Browser for web data extraction
Browser with VPC Configuration
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const vpcExample = new aws.bedrock.AgentcoreBrowser("vpc_example", {
networkConfiguration: {
vpcConfig: {
securityGroups: ["sg-12345678"],
subnets: [
"subnet-12345678",
"subnet-87654321",
],
},
networkMode: "VPC",
},
name: "vpc-browser",
description: "Browser with VPC configuration",
});
import pulumi
import pulumi_aws as aws
vpc_example = aws.bedrock.AgentcoreBrowser("vpc_example",
network_configuration={
"vpc_config": {
"security_groups": ["sg-12345678"],
"subnets": [
"subnet-12345678",
"subnet-87654321",
],
},
"network_mode": "VPC",
},
name="vpc-browser",
description="Browser with VPC configuration")
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var vpcExample = new Aws.Bedrock.AgentcoreBrowser("vpc_example", new()
{
NetworkConfiguration = new Aws.Bedrock.Inputs.AgentcoreBrowserNetworkConfigurationArgs
{
VpcConfig = new Aws.Bedrock.Inputs.AgentcoreBrowserNetworkConfigurationVpcConfigArgs
{
SecurityGroups = new[]
{
"sg-12345678",
},
Subnets = new[]
{
"subnet-12345678",
"subnet-87654321",
},
},
NetworkMode = "VPC",
},
Name = "vpc-browser",
Description = "Browser with VPC configuration",
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/bedrock"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := bedrock.NewAgentcoreBrowser(ctx, "vpc_example", &bedrock.AgentcoreBrowserArgs{
NetworkConfiguration: &bedrock.AgentcoreBrowserNetworkConfigurationArgs{
VpcConfig: &bedrock.AgentcoreBrowserNetworkConfigurationVpcConfigArgs{
SecurityGroups: pulumi.StringArray{
pulumi.String("sg-12345678"),
},
Subnets: pulumi.StringArray{
pulumi.String("subnet-12345678"),
pulumi.String("subnet-87654321"),
},
},
NetworkMode: pulumi.String("VPC"),
},
Name: pulumi.String("vpc-browser"),
Description: pulumi.String("Browser with VPC configuration"),
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
resource "aws_bedrock_agentcorebrowser" "vpc_example" {
network_configuration = {
vpc_config = {
security_groups = ["sg-12345678"]
subnets = ["subnet-12345678", "subnet-87654321"]
}
network_mode = "VPC"
}
name = "vpc-browser"
description = "Browser with VPC configuration"
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.bedrock.AgentcoreBrowser;
import com.pulumi.aws.bedrock.AgentcoreBrowserArgs;
import com.pulumi.aws.bedrock.inputs.AgentcoreBrowserNetworkConfigurationArgs;
import com.pulumi.aws.bedrock.inputs.AgentcoreBrowserNetworkConfigurationVpcConfigArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var vpcExample = new AgentcoreBrowser("vpcExample", AgentcoreBrowserArgs.builder()
.networkConfiguration(AgentcoreBrowserNetworkConfigurationArgs.builder()
.vpcConfig(AgentcoreBrowserNetworkConfigurationVpcConfigArgs.builder()
.securityGroups("sg-12345678")
.subnets(
"subnet-12345678",
"subnet-87654321")
.build())
.networkMode("VPC")
.build())
.name("vpc-browser")
.description("Browser with VPC configuration")
.build());
}
}
resources:
vpcExample:
type: aws:bedrock:AgentcoreBrowser
name: vpc_example
properties:
networkConfiguration:
vpcConfig:
securityGroups:
- sg-12345678
subnets:
- subnet-12345678
- subnet-87654321
networkMode: VPC
name: vpc-browser
description: Browser with VPC configuration
Browser with Execution Role and Recording
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const assumeRole = aws.iam.getPolicyDocument({
statements: [{
principals: [{
type: "Service",
identifiers: ["bedrock-agentcore.amazonaws.com"],
}],
effect: "Allow",
actions: ["sts:AssumeRole"],
}],
});
const example = new aws.iam.Role("example", {
name: "bedrock-agentcore-browser-role",
assumeRolePolicy: assumeRole.then(assumeRole => assumeRole.json),
});
const recording = new aws.s3.Bucket("recording", {bucket: "browser-recording-bucket"});
const exampleAgentcoreBrowser = new aws.bedrock.AgentcoreBrowser("example", {
networkConfiguration: {
networkMode: "PUBLIC",
},
recording: {
s3Location: {
bucket: recording.bucket,
prefix: "browser-sessions/",
},
enabled: true,
},
name: "example-browser",
description: "Browser with recording enabled",
executionRoleArn: example.arn,
});
import pulumi
import pulumi_aws as aws
assume_role = aws.iam.get_policy_document(statements=[{
"principals": [{
"type": "Service",
"identifiers": ["bedrock-agentcore.amazonaws.com"],
}],
"effect": "Allow",
"actions": ["sts:AssumeRole"],
}])
example = aws.iam.Role("example",
name="bedrock-agentcore-browser-role",
assume_role_policy=assume_role.json)
recording = aws.s3.Bucket("recording", bucket="browser-recording-bucket")
example_agentcore_browser = aws.bedrock.AgentcoreBrowser("example",
network_configuration={
"network_mode": "PUBLIC",
},
recording={
"s3_location": {
"bucket": recording.bucket,
"prefix": "browser-sessions/",
},
"enabled": True,
},
name="example-browser",
description="Browser with recording enabled",
execution_role_arn=example.arn)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var assumeRole = Aws.Iam.GetPolicyDocument.Invoke(new()
{
Statements = new[]
{
new Aws.Iam.Inputs.GetPolicyDocumentStatementInputArgs
{
Principals = new[]
{
new Aws.Iam.Inputs.GetPolicyDocumentStatementPrincipalInputArgs
{
Type = "Service",
Identifiers = new[]
{
"bedrock-agentcore.amazonaws.com",
},
},
},
Effect = "Allow",
Actions = new[]
{
"sts:AssumeRole",
},
},
},
});
var example = new Aws.Iam.Role("example", new()
{
Name = "bedrock-agentcore-browser-role",
AssumeRolePolicy = assumeRole.Apply(getPolicyDocumentResult => getPolicyDocumentResult.Json),
});
var recording = new Aws.S3.Bucket("recording", new()
{
BucketName = "browser-recording-bucket",
});
var exampleAgentcoreBrowser = new Aws.Bedrock.AgentcoreBrowser("example", new()
{
NetworkConfiguration = new Aws.Bedrock.Inputs.AgentcoreBrowserNetworkConfigurationArgs
{
NetworkMode = "PUBLIC",
},
Recording = new Aws.Bedrock.Inputs.AgentcoreBrowserRecordingArgs
{
S3Location = new Aws.Bedrock.Inputs.AgentcoreBrowserRecordingS3LocationArgs
{
Bucket = recording.BucketName,
Prefix = "browser-sessions/",
},
Enabled = true,
},
Name = "example-browser",
Description = "Browser with recording enabled",
ExecutionRoleArn = example.Arn,
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/bedrock"
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/iam"
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/s3"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
assumeRole, err := iam.GetPolicyDocument(ctx, &iam.GetPolicyDocumentArgs{
Statements: []iam.GetPolicyDocumentStatement{
{
Principals: []iam.GetPolicyDocumentStatementPrincipal{
{
Type: "Service",
Identifiers: []string{
"bedrock-agentcore.amazonaws.com",
},
},
},
Effect: pulumi.StringRef("Allow"),
Actions: []string{
"sts:AssumeRole",
},
},
},
}, nil)
if err != nil {
return err
}
example, err := iam.NewRole(ctx, "example", &iam.RoleArgs{
Name: pulumi.String("bedrock-agentcore-browser-role"),
AssumeRolePolicy: pulumi.String(assumeRole.Json),
})
if err != nil {
return err
}
recording, err := s3.NewBucket(ctx, "recording", &s3.BucketArgs{
Bucket: pulumi.String("browser-recording-bucket"),
})
if err != nil {
return err
}
_, err = bedrock.NewAgentcoreBrowser(ctx, "example", &bedrock.AgentcoreBrowserArgs{
NetworkConfiguration: &bedrock.AgentcoreBrowserNetworkConfigurationArgs{
NetworkMode: pulumi.String("PUBLIC"),
},
Recording: &bedrock.AgentcoreBrowserRecordingArgs{
S3Location: &bedrock.AgentcoreBrowserRecordingS3LocationArgs{
Bucket: recording.Bucket,
Prefix: pulumi.String("browser-sessions/"),
},
Enabled: pulumi.Bool(true),
},
Name: pulumi.String("example-browser"),
Description: pulumi.String("Browser with recording enabled"),
ExecutionRoleArn: example.Arn,
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
data "aws_iam_getpolicydocument" "assumeRole" {
statements {
principals {
type = "Service"
identifiers = ["bedrock-agentcore.amazonaws.com"]
}
effect = "Allow"
actions = ["sts:AssumeRole"]
}
}
resource "aws_iam_role" "example" {
name = "bedrock-agentcore-browser-role"
assume_role_policy = data.aws_iam_getpolicydocument.assumeRole.json
}
resource "aws_s3_bucket" "recording" {
bucket = "browser-recording-bucket"
}
resource "aws_bedrock_agentcorebrowser" "example" {
network_configuration = {
network_mode = "PUBLIC"
}
recording = {
s3_location = {
bucket = aws_s3_bucket.recording.bucket
prefix = "browser-sessions/"
}
enabled = true
}
name = "example-browser"
description = "Browser with recording enabled"
execution_role_arn = aws_iam_role.example.arn
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.iam.IamFunctions;
import com.pulumi.aws.iam.inputs.GetPolicyDocumentArgs;
import com.pulumi.aws.iam.inputs.GetPolicyDocumentStatementArgs;
import com.pulumi.aws.iam.inputs.GetPolicyDocumentStatementPrincipalArgs;
import com.pulumi.aws.iam.Role;
import com.pulumi.aws.iam.RoleArgs;
import com.pulumi.aws.s3.Bucket;
import com.pulumi.aws.s3.BucketArgs;
import com.pulumi.aws.bedrock.AgentcoreBrowser;
import com.pulumi.aws.bedrock.AgentcoreBrowserArgs;
import com.pulumi.aws.bedrock.inputs.AgentcoreBrowserNetworkConfigurationArgs;
import com.pulumi.aws.bedrock.inputs.AgentcoreBrowserRecordingArgs;
import com.pulumi.aws.bedrock.inputs.AgentcoreBrowserRecordingS3LocationArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var assumeRole = IamFunctions.getPolicyDocument(GetPolicyDocumentArgs.builder()
.statements(GetPolicyDocumentStatementArgs.builder()
.principals(GetPolicyDocumentStatementPrincipalArgs.builder()
.type("Service")
.identifiers("bedrock-agentcore.amazonaws.com")
.build())
.effect("Allow")
.actions("sts:AssumeRole")
.build())
.build());
var example = new Role("example", RoleArgs.builder()
.name("bedrock-agentcore-browser-role")
.assumeRolePolicy(assumeRole.json())
.build());
var recording = new Bucket("recording", BucketArgs.builder()
.bucket("browser-recording-bucket")
.build());
var exampleAgentcoreBrowser = new AgentcoreBrowser("exampleAgentcoreBrowser", AgentcoreBrowserArgs.builder()
.networkConfiguration(AgentcoreBrowserNetworkConfigurationArgs.builder()
.networkMode("PUBLIC")
.build())
.recording(AgentcoreBrowserRecordingArgs.builder()
.s3Location(AgentcoreBrowserRecordingS3LocationArgs.builder()
.bucket(recording.bucket())
.prefix("browser-sessions/")
.build())
.enabled(true)
.build())
.name("example-browser")
.description("Browser with recording enabled")
.executionRoleArn(example.arn())
.build());
}
}
resources:
example:
type: aws:iam:Role
properties:
name: bedrock-agentcore-browser-role
assumeRolePolicy: ${assumeRole.json}
recording:
type: aws:s3:Bucket
properties:
bucket: browser-recording-bucket
exampleAgentcoreBrowser:
type: aws:bedrock:AgentcoreBrowser
name: example
properties:
networkConfiguration:
networkMode: PUBLIC
recording:
s3Location:
bucket: ${recording.bucket}
prefix: browser-sessions/
enabled: true
name: example-browser
description: Browser with recording enabled
executionRoleArn: ${example.arn}
variables:
assumeRole:
fn::invoke:
function: aws:iam:getPolicyDocument
arguments:
statements:
- principals:
- type: Service
identifiers:
- bedrock-agentcore.amazonaws.com
effect: Allow
actions:
- sts:AssumeRole
Import
Using pulumi import, import Bedrock AgentCore Browser using the browser ID. For example:
$ pulumi import aws:bedrock/agentcoreBrowser:AgentcoreBrowser example BROWSER1234567890
Constructors
- AgentcoreBrowser(String name, {AgentcoreBrowserArgs? args, CustomResourceOptions? options})
-
Creates a new AgentcoreBrowser.
nameThe Pulumi resource name.argsArguments used to configure this AgentcoreBrowser. The set of arguments for AgentcoreBrowser.optionsResource options controlling this resource's behavior. - AgentcoreBrowser.reference(String urn)
- Creates a typed reference to an existing AgentcoreBrowser resource.
Properties
-
browserArn
↔ Output<
String> -
ARN of the Browser.
latefinal
-
browserId
↔ Output<
String> -
Unique identifier of the Browser.
latefinal
-
browserSigning
↔ Output<
AgentcoreBrowserBrowserSigning?> -
Browser signing configuration that enables cryptographic agent identification using HTTP message signatures. See
browserSigningbelow.latefinal -
certificates
↔ Output<
List< AgentcoreBrowserCertificate> ?> -
Certificates to install in the browser. See
certificatebelow.latefinal -
childResources
→ Set<
Resource> -
finalinherited
-
completionSources
↔ Map<
String, IOutputCompletionSource> -
latefinalinherited
-
description
↔ Output<
String?> -
Description of the browser.
latefinal
-
enterprisePolicies
↔ Output<
List< AgentcoreBrowserEnterprisePolicy> ?> -
Enterprise policy files to apply to the browser. See
enterprisePolicybelow.latefinal -
executionRoleArn
↔ Output<
String?> -
ARN of the IAM role that the browser assumes for execution.
latefinal
- hashCode → int
-
The hash code for this object.
no setterinherited
-
id
↔ Output<
String> -
getter/setter pairinherited
- isCustom → bool
-
Returns whether this resource is provider-managed.
no setterinherited
- isProtected → bool
-
Returns whether this resource is protected from deletion.
no setterinherited
- isRemote → bool
-
Whether this resource is registered as remote.
no setterinherited
- isResourceReference → bool
-
Whether this instance represents a resource value returned over RPC.
finalinherited
-
name
↔ Output<
String> -
Name of the browser.
latefinal
-
networkConfiguration
↔ Output<
AgentcoreBrowserNetworkConfiguration> -
Network configuration for the browser. See
networkConfigurationbelow.latefinal -
recording
↔ Output<
AgentcoreBrowserRecording?> -
Recording configuration for browser sessions. See
recordingbelow.latefinal -
region
↔ Output<
String> -
Region where this resource will be managed. Defaults to the Region set in the provider configuration.
latefinal
-
resourceTransforms
→ List<
ResourceTransform> -
Inherited/explicit async transforms.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
Key-value map of resource tags. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.latefinal -
A map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block.latefinal -
timeouts
↔ Output<
AgentcoreBrowserTimeouts?> -
latefinal
-
transformations
→ List<
ResourceTransformation> -
Inherited/explicit legacy transformations.
no setterinherited
-
urn
↔ Output<
String> -
latefinalinherited
Methods
-
failId(
Object error) → void -
Completes this resource ID with an error when registration fails.
inherited
-
failOutputs(
Object error) → void -
Completes all output properties with
error.inherited -
failUrn(
Object error) → void -
Completes this resource URN with an error when registration fails.
inherited
-
getProvider(
String moduleMember) → ProviderResource? -
Returns provider for
moduleMember's package, if configured.inherited -
getResourceName(
) → String -
Returns this resource's logical name.
inherited
-
getResourceType(
) → String -
Returns this resource's Pulumi type token.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
registerOutput<
T> (String propertyName, {Object? decoder(Object?)?, bool isSecret = false}) → Output< T> -
Registers a dynamic output property for this resource.
inherited
-
resolveId(
String? value, {required bool isKnown}) → void -
Resolves the provider-assigned ID for this resource.
inherited
-
resolveOutputs(
Struct outputs) → void -
Resolves all output properties from a monitor response payload.
inherited
-
resolveUrn(
String value) → void -
Resolves this resource's URN once assigned by the engine.
inherited
-
serializeProperties(
Map< String, dynamic> properties) → Future<Struct> -
Serializes resource properties for RPC transmission.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
get(
String name, Input< String> id, {AgentcoreBrowserState? state, CustomResourceOptions? options}) → AgentcoreBrowser -
Gets an existing AgentcoreBrowser resource's state with the given
nameandid.