Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1465766489.0 KB

Creates an A/B test for comparing agent configurations. A/B tests split traffic between a control variant and a treatment variant through a gateway, then evaluate performance using online evaluation configurations to determine which variant performs better.

post/ab-tests

Request body

namestring required

The name of the A/B test. Must be unique within your account.

descriptionstring

The description of the A/B test.

gatewayArnstring required

The Amazon Resource Name (ARN) of the gateway to use for traffic splitting.

roleArnstring required

The IAM role ARN that grants permissions for the A/B test to access gateway and evaluation resources.

enableOnCreateboolean

Whether to enable the A/B test immediately upon creation. If true, traffic splitting begins automatically.

clientTokenstring

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

tagsobject

A map of tag keys and values to associate with the A/B test.

Response

Success

abTestIdstring required

The unique identifier of the created A/B test.

abTestArnstring required

The Amazon Resource Name (ARN) of the created A/B test.

namestring

The name of the A/B test.

status'CREATING' | 'ACTIVE' | 'CREATE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'DELETING' | 'DELETE_FAILED' | 'FAILED' required

The status of the A/B test.

executionStatus'PAUSED' | 'RUNNING' | 'STOPPED' | 'NOT_STARTED' required

The execution status indicating whether the A/B test is currently running.

createdAtstring date-time required

The timestamp when the A/B test was created.