Skip to main content
A container for streams, similar to a bucket in object storage. Each basin has a globally unique name and lives in a specific cell within a region. The basin name is reflected in the data plane endpoint: 
https://{basin}.b.aws.s2.dev

​
Configuration

Basins carry configuration that governs stream auto-creation and default stream settings. For example, enabling create_stream_on_append lets you skip explicit stream creation — just start appending and the stream will be created automatically with the basin’s default config.

​
Naming

Streams within a basin are addressed as s2://{basin}/{stream}. Stream names can contain / to create logical hierarchies: 
s2://my-basin/sessions/user-123/run-456
s2://my-basin/logs/prod/api-server
This is a naming convention only — there is no directory structure. Listing streams supports prefix filtering, and access tokens can be scoped to prefixes as well.

​
Limits

Each account can have up to 100 basins. Streams within a basin are unlimited. See Limits for details.

​
See also

SDK

Create, configure, list, and delete basins

API Reference

Basin management endpoints