AWS API Changes

2025/10/30 - Amazon Bedrock AgentCore Control - 2 updated api methods

Changes Web-Bot-Auth support for AgentCore Browser tool to help reduce captcha challenges.

CreateBrowser (updated)

Link ¶
Changes (request)

{'browserSigning': {'enabled': 'boolean'}}

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',
            ]
        }
    },
    recording={
        'enabled': True|False,
        's3Location': {
            'bucket': 'string',
            'prefix': 'string'
        }
    },
    browserSigning={
        'enabled': True|False
    },
    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) --

VpcConfig for the Agent.
- securityGroups (list) -- [REQUIRED]
  
  The security groups associated with the VPC configuration.
  - (string) --
- subnets (list) -- [REQUIRED]
  
  The subnets associated with the VPC configuration.
  - (string) --

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.

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 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 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.

GetBrowser (updated)

Link ¶
Changes (response)

{'browserSigning': {'enabled': 'boolean'}}

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',
            ]
        }
    },
    'recording': {
        'enabled': True|False,
        's3Location': {
            'bucket': 'string',
            'prefix': 'string'
        }
    },
    'browserSigning': {
        'enabled': True|False
    },
    '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) --
    
    VpcConfig for the Agent.
    - securityGroups (list) --
      
      The security groups associated with the VPC configuration.
      - (string) --
    - subnets (list) --
      
      The subnets associated with the VPC configuration.
      - (string) --
- 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.
- 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.
- 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.