winterbaume-workspacesweb

Amazon WorkSpaces Web service implementation for winterbaume.

This crate is part of the winterbaume workspace — a suite of in-process AWS service mocks for Rust. Use the umbrella winterbaume crate to pull in all services at once, or depend on this crate directly for WorkSpaces Web only.

Winterbäume is not affiliated with, endorsed by, or sponsored by Amazon Web Services, Inc. or Amazon.com, Inc. Amazon Web Services, AWS, and related marks are trademarks of Amazon.com, Inc. or its affiliates. All other trademarks are the property of their respective owners.

Coverage

Metric	Value
Service	WorkSpaces Web
AWS model	`workspaces-web`
Protocol	restJson1
winterbaume coverage	68/75 operations (90.7%)
stubs (routed, returns empty/default)	0/75 operations (0.0%)
moto coverage	27/75 operations (36.0%)
floci coverage	0/75 operations (0.0%)
kumo coverage	0/75 operations (0.0%)
Coverage report date	2026-05-06

Coverage is generated from .agents/docs/API_COVERAGE.md by update_readme.py. The winterbaume row counts only operations with real, state-backed logic; stubs counts handlers that route the request and return an empty/default response without real behaviour. Operation-count coverage is a prioritisation signal, not a behavioural guarantee.

See the workspace README.md for setup, usage, and the full cross-service coverage table.

Server-mode usage

Start winterbaume-server and point the AWS CLI at it:

cargo run -p winterbaume-server -- --host 127.0.0.1 --port 5555

export AWS_ENDPOINT_URL=http://localhost:5555
aws workspaces-web list-portals

Current Network Resource Stub Semantics

WorkSpaces Web currently stores portal networking as portal/resource metadata.

Portal and network settings shapes include VPC ID, subnet IDs, and security group IDs.
Current implemented state records those values only where the surrounding resource handler persists the portal or settings object.
Browser session lifecycle does not create VPC endpoints or ENIs.
The implementation does not consult winterbaume-ec2 state for these identifiers, so it does not check that referenced VPCs, subnets, security groups, VPC endpoints, network interfaces, or load balancers exist, belong to the same VPC, or are in a usable lifecycle state.

Example

use aws_sdk_workspacesweb::config::BehaviorVersion;
use winterbaume_core::MockAws;
use winterbaume_workspacesweb::WorkspacesWebService;

#[tokio::main]
async fn main() {
    let mock = MockAws::builder()
        .with_service(WorkspacesWebService::new())
        .build();

    let config = aws_config::defaults(BehaviorVersion::latest())
        .http_client(mock.http_client())
        .credentials_provider(mock.credentials_provider())
        .region(aws_sdk_workspacesweb::config::Region::new("us-east-1"))
        .load()
        .await;

    let client = aws_sdk_workspacesweb::Client::new(&config);

    let resp = client
        .list_portals()
        .send()
        .await
        .expect("list_portals should succeed");
    println!("WorkSpaces Web portals: {}", resp.portals().len());
}

Implemented APIs (68)

AssociateBrowserSettings
AssociateDataProtectionSettings
AssociateNetworkSettings
AssociateSessionLogger
AssociateTrustStore
AssociateUserAccessLoggingSettings
AssociateUserSettings
CreateBrowserSettings
CreateDataProtectionSettings
CreateIdentityProvider
CreateNetworkSettings
CreatePortal
CreateSessionLogger
CreateTrustStore
CreateUserAccessLoggingSettings
CreateUserSettings
DeleteBrowserSettings
DeleteDataProtectionSettings
DeleteIdentityProvider
DeleteNetworkSettings
DeletePortal
DeleteSessionLogger
DeleteTrustStore
DeleteUserAccessLoggingSettings
DeleteUserSettings
DisassociateBrowserSettings
DisassociateDataProtectionSettings
DisassociateNetworkSettings
DisassociateSessionLogger
DisassociateTrustStore
DisassociateUserAccessLoggingSettings
DisassociateUserSettings
ExpireSession
GetBrowserSettings
GetDataProtectionSettings
GetIdentityProvider
GetNetworkSettings
GetPortal
GetPortalServiceProviderMetadata
GetSession
GetSessionLogger
GetTrustStore
GetTrustStoreCertificate
GetUserAccessLoggingSettings
GetUserSettings
ListBrowserSettings
ListDataProtectionSettings
ListIdentityProviders
ListNetworkSettings
ListPortals
ListSessionLoggers
ListSessions
ListTagsForResource
ListTrustStoreCertificates
ListTrustStores
ListUserAccessLoggingSettings
ListUserSettings
TagResource
UntagResource
UpdateBrowserSettings
UpdateDataProtectionSettings
UpdateIdentityProvider
UpdateNetworkSettings
UpdatePortal
UpdateSessionLogger
UpdateTrustStore
UpdateUserAccessLoggingSettings
UpdateUserSettings