Networking

SES

Protocol: Query (XML) — POST http://localhost:4566/ with Action= parameter SES supports sending plain text and raw emails, identity verification, and DKIM attributes — with 14 operations total.

SES operations (14)

Action	Description
`SendEmail`	Send a formatted email
`SendRawEmail`	Send a raw MIME email
`VerifyEmailIdentity`	Verify an email address
`VerifyDomainIdentity`	Verify a domain
`ListIdentities`	List all verified identities
`GetIdentityVerificationAttributes`	Get verification status for identities
`DeleteIdentity`	Remove a verified identity
`GetIdentityDkimAttributes`	Get DKIM attributes for an identity
`SetIdentityDkimEnabled`	Enable or disable DKIM for an identity
`GetSendQuota`	Get sending quota details
`GetSendStatistics`	Get sending statistics
`SetIdentityNotificationTopic`	Set SNS topic for bounce/complaint/delivery notifications
`GetIdentityNotificationAttributes`	Get notification settings for an identity
`SetIdentityFeedbackForwardingEnabled`	Enable/disable feedback forwarding

Examples

Send formatted email
Send raw email
Identity management

export AWS_ENDPOINT=http://localhost:4566

# Verify sender identity first
aws ses verify-email-identity \
  --email-address [email protected] \
  --endpoint-url $AWS_ENDPOINT

# Send an email
aws ses send-email \
  --from [email protected] \
  --destination [email protected] \
  --message '{
    "Subject": {"Data": "Hello from Floci"},
    "Body": {
      "Text": {"Data": "This is a test email sent via Floci SES emulation."},
      "Html": {"Data": "<p>This is a <b>test email</b> sent via Floci SES emulation.</p>"}
    }
  }' \
  --endpoint-url $AWS_ENDPOINT

export AWS_ENDPOINT=http://localhost:4566

# Build a raw MIME message and base64-encode it
RAW_MSG=$(echo -e "From: [email protected]\nTo: [email protected]\nSubject: Raw test\nMIME-Version: 1.0\nContent-Type: text/plain\n\nHello from raw email." | base64)

aws ses send-raw-email \
  --raw-message Data=$RAW_MSG \
  --endpoint-url $AWS_ENDPOINT

export AWS_ENDPOINT=http://localhost:4566

# Verify a domain
aws ses verify-domain-identity \
  --domain example.com \
  --endpoint-url $AWS_ENDPOINT

# List all verified identities
aws ses list-identities --endpoint-url $AWS_ENDPOINT

# Get verification status
aws ses get-identity-verification-attributes \
  --identities [email protected] \
  --endpoint-url $AWS_ENDPOINT

# Get DKIM attributes
aws ses get-identity-dkim-attributes \
  --identities [email protected] \
  --endpoint-url $AWS_ENDPOINT

# Delete an identity
aws ses delete-identity \
  --identity [email protected] \
  --endpoint-url $AWS_ENDPOINT

OpenSearch Service

Protocol: REST JSON
Endpoint: http://localhost:4566/2021-01-01/...
Credential scope: es OpenSearch supports 24 operations for domain management, tagging, version queries, and instance type queries.

Implementation Modes

mock (default)
real

Domains are stored in memory and appear ACTIVE immediately. No real search capability — data-plane endpoints (/_search, /_index, etc.) are not available.This is the default mode and is sufficient for testing infrastructure code that creates, describes, and deletes OpenSearch domains.

Spins up a real OpenSearch Docker container per domain and proxies data-plane requests to it. Full search capability including /_search, /_index, and other data-plane endpoints.Set FLOCI_SERVICES_OPENSEARCH_MODE=real (or opensearch.mode: real in application.yml) to enable this mode. The default Docker image is opensearchproject/opensearch:2, configurable via FLOCI_SERVICES_OPENSEARCH_DEFAULT_IMAGE.

OpenSearch operations (24)

Domain Lifecycle

Operation	Method + Path	Description
`CreateDomain`	`POST /2021-01-01/opensearch/domain`	Create a new domain
`DescribeDomain`	`GET /2021-01-01/opensearch/domain/{name}`	Get domain details
`DescribeDomains`	`POST /2021-01-01/opensearch/domain-info`	Batch describe domains
`DescribeDomainConfig`	`GET /2021-01-01/opensearch/domain/{name}/config`	Get domain configuration
`UpdateDomainConfig`	`POST /2021-01-01/opensearch/domain/{name}/config`	Update cluster config, EBS options, engine version
`DeleteDomain`	`DELETE /2021-01-01/opensearch/domain/{name}`	Delete a domain
`ListDomainNames`	`GET /2021-01-01/domain`	List all domains

Tags

Operation	Method + Path	Description
`AddTags`	`POST /2021-01-01/tags`	Add tags to a domain by ARN
`ListTags`	`GET /2021-01-01/tags/?arn=`	List tags for a domain
`RemoveTags`	`POST /2021-01-01/tags-removal`	Remove tag keys from a domain

Versions & Instance Types

Operation	Method + Path	Description
`ListVersions`	`GET /2021-01-01/opensearch/versions`	List supported engine versions
`GetCompatibleVersions`	`GET /2021-01-01/opensearch/compatibleVersions`	List valid upgrade paths
`ListInstanceTypeDetails`	`GET /2021-01-01/opensearch/instanceTypeDetails/{version}`	List available instance types
`DescribeInstanceTypeLimits`	`GET /2021-01-01/opensearch/instanceTypeLimits/{version}/{type}`	Get limits for an instance type

Stubs (SDK-compatible, no-op responses)DescribeDomainChangeProgress · DescribeDomainAutoTunes · DescribeDryRunProgress · DescribeDomainHealth · GetUpgradeHistory · GetUpgradeStatus · UpgradeDomain · CancelDomainConfigChange · StartServiceSoftwareUpdate · CancelServiceSoftwareUpdate

Configuration

floci:
  services:
    opensearch:
      enabled: true
      mode: mock                                       # mock | real
      default-image: "opensearchproject/opensearch:2"  # used only when mode=real
      proxy-base-port: 9400
      proxy-max-port: 9499
  storage:
    services:
      opensearch:
        flush-interval-ms: 5000

Environment variables:

Variable	Default	Description
`FLOCI_SERVICES_OPENSEARCH_ENABLED`	`true`	Enable/disable the service
`FLOCI_SERVICES_OPENSEARCH_MODE`	`mock`	`mock` or `real`
`FLOCI_SERVICES_OPENSEARCH_DEFAULT_IMAGE`	`opensearchproject/opensearch:2`	Docker image for `real` mode
`FLOCI_SERVICES_OPENSEARCH_PROXY_BASE_PORT`	`9400`	Port range start for `real` mode
`FLOCI_SERVICES_OPENSEARCH_PROXY_MAX_PORT`	`9499`	Port range end for `real` mode

Emulation Behavior

Domain name: 3–28 characters, must start with a lowercase letter, only lowercase letters, digits, and hyphens.
ARN format: arn:aws:es:{region}:{accountId}:domain/{domainName}
Processing: Always false in mock mode — domains are ACTIVE immediately.
Engine version default: OpenSearch_2.11
Cluster defaults: m5.large.search, 1 instance, EBS enabled with 10 GiB gp2 volume.

Examples

export AWS_ENDPOINT_URL=http://localhost:4566
export AWS_DEFAULT_REGION=us-east-1
export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test

# Create a domain
aws opensearch create-domain \
  --domain-name my-search \
  --engine-version "OpenSearch_2.11" \
  --cluster-config InstanceType=m5.large.search,InstanceCount=1 \
  --ebs-options EBSEnabled=true,VolumeType=gp2,VolumeSize=10

# Describe the domain
aws opensearch describe-domain --domain-name my-search

# List all domains
aws opensearch list-domain-names

# Update cluster config
aws opensearch update-domain-config \
  --domain-name my-search \
  --cluster-config InstanceCount=3

# Add tags
aws opensearch add-tags \
  --arn arn:aws:es:us-east-1:000000000000:domain/my-search \
  --tag-list Key=env,Value=dev

# List tags
aws opensearch list-tags \
  --arn arn:aws:es:us-east-1:000000000000:domain/my-search

# Delete domain
aws opensearch delete-domain --domain-name my-search

SDK Example

Java
Python

OpenSearchClient os = OpenSearchClient.builder()
    .endpointOverride(URI.create("http://localhost:4566"))
    .region(Region.US_EAST_1)
    .credentialsProvider(StaticCredentialsProvider.create(
        AwsBasicCredentials.create("test", "test")))
    .build();

// Create a domain
CreateDomainResponse created = os.createDomain(req -> req
    .domainName("my-search")
    .engineVersion("OpenSearch_2.11")
    .clusterConfig(c -> c
        .instanceType(OpenSearchPartitionInstanceType.M5_LARGE_SEARCH)
        .instanceCount(1))
    .ebsOptions(e -> e
        .ebsEnabled(true)
        .volumeType(VolumeType.GP2)
        .volumeSize(10)));

System.out.println("ARN: " + created.domainStatus().arn());

// List domains
os.listDomainNames(req -> req.build())
    .domainNames()
    .forEach(d -> System.out.println(d.domainName()));

// Delete
os.deleteDomain(req -> req.domainName("my-search"));

import boto3

os_client = boto3.client(
    "opensearch",
    endpoint_url="http://localhost:4566",
    region_name="us-east-1",
    aws_access_key_id="test",
    aws_secret_access_key="test"
)

# Create a domain
response = os_client.create_domain(
    DomainName="my-search",
    EngineVersion="OpenSearch_2.11",
    ClusterConfig={"InstanceType": "m5.large.search", "InstanceCount": 1},
    EBSOptions={"EBSEnabled": True, "VolumeType": "gp2", "VolumeSize": 10}
)
print(response["DomainStatus"]["ARN"])

# List domains
domains = os_client.list_domain_names()
for d in domains["DomainNames"]:
    print(d["DomainName"])

# Delete
os_client.delete_domain(DomainName="my-search")

Get Started

Configuration

Services

Contributing

SES

Examples

OpenSearch Service

Implementation Modes

Configuration

Emulation Behavior

Examples

SDK Example

Build docs developers (and LLMs) love

Get Started

Configuration

Services

Contributing

​SES

​Examples

​OpenSearch Service

​Implementation Modes

​Configuration

​Emulation Behavior

​Examples

​SDK Example

Build docs developers (and LLMs) love

SES

Examples

OpenSearch Service

Implementation Modes

Configuration

Emulation Behavior

Examples

SDK Example