stratumctl lb
Manage load balancers, target groups
stratumctl lb [flags]Aliases: load-balancing
Subcommands
Section titled “Subcommands”stratumctl lb listeners: Manage load-balancer listenersstratumctl lb load-balancers: Manage load balancersstratumctl lb middleware: Manage load-balancer middleware (request/response filters)stratumctl lb rules: Manage listener rules (priority-ordered conditions → actions)stratumctl lb ssl-certificates: Manage SSL certificates and attach them to HTTPS listenersstratumctl lb target-groups: Manage target groupsstratumctl lb targets: Register / list / deregister targets in a target group
stratumctl lb listeners
Section titled “stratumctl lb listeners”Manage load-balancer listeners
stratumctl lb listeners [flags]Aliases: listener
Subcommands
Section titled “Subcommands”stratumctl lb listeners create: Create a listener that default-forwards to a target groupstratumctl lb listeners delete: Delete a listenerstratumctl lb listeners get: Describe a listenerstratumctl lb listeners list: List a load balancer’s listeners
stratumctl lb listeners create
Section titled “stratumctl lb listeners create”Create a listener that default-forwards to a target group
stratumctl lb listeners create <lb-id> [flags]Examples
Section titled “Examples”stratumctl lb listeners create lb-7k2m9x4q8a --protocol HTTP --port 80 --target-group tg-3k8m2x7q9astratumctl lb listeners create lb-7k2m9x4q8a --protocol HTTPS --port 443 --target-group tg-3k8m2x7q9a| Flag | Type | Default | Description |
|---|---|---|---|
--port |
int | 0 |
Listener port (required) |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--protocol |
string | Listener protocol: HTTP | HTTPS | TCP (required) | |
--target-group |
string | Default forward target group ID (required) |
stratumctl lb listeners delete
Section titled “stratumctl lb listeners delete”Delete a listener
stratumctl lb listeners delete <listener-id> [flags]Examples
Section titled “Examples”stratumctl lb listeners delete lis-5k8m2x7q9a| Flag | Type | Default | Description |
|---|---|---|---|
--force |
bool | false |
delete a platform-owned resource anyway (needs platform:ManageInternal; audited; the platform re-creates it) |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb listeners get
Section titled “stratumctl lb listeners get”Describe a listener
stratumctl lb listeners get <listener-id> [flags]Examples
Section titled “Examples”stratumctl lb listeners get lis-5k8m2x7q9astratumctl lb listeners get lis-5k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb listeners list
Section titled “stratumctl lb listeners list”List a load balancer’s listeners
stratumctl lb listeners list <lb-id> [flags]Examples
Section titled “Examples”stratumctl lb listeners list lb-7k2m9x4q8astratumctl lb listeners list lb-7k2m9x4q8a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb load-balancers
Section titled “stratumctl lb load-balancers”Manage load balancers
stratumctl lb load-balancers [flags]Aliases: load-balancer, lbs
Subcommands
Section titled “Subcommands”stratumctl lb load-balancers create: Create a load balancer (returns 202; polllb load-balancers getuntil state=active)stratumctl lb load-balancers delete: Delete a load balancerstratumctl lb load-balancers get: Describe a load balancerstratumctl lb load-balancers list: List load balancers in a projectstratumctl lb load-balancers update: Modify a load balancer (security groups)
stratumctl lb load-balancers create
Section titled “stratumctl lb load-balancers create”Create a load balancer (returns 202; poll lb load-balancers get until state=active)
stratumctl lb load-balancers create <name> [flags]Examples
Section titled “Examples”stratumctl lb load-balancers create web-lb --scheme internet-facing --vpc-id vpc-9k2m4x7q --subnet-ids subnet-3k8m2x7qstratumctl lb load-balancers create internal-lb --scheme internal --vpc-id vpc-9k2m4x7q --subnet-ids subnet-3k8m2x7q,subnet-6k2m8x4q \ --security-group-ids sg-3f8d2k9x| Flag | Type | Default | Description |
|---|---|---|---|
--description |
string | Free-form description | |
--display-name |
string | Human-friendly display name | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--region |
string | Region override | |
--scheme |
string | internet-facing | internal (required) | |
--security-group-ids |
stringSlice | Security group IDs to attach to the LB NIC (comma-separated) | |
--subnet-ids |
stringSlice | Subnet IDs to place the data plane in (comma-separated, at least one required) | |
--type |
string | Load-balancer type (e.g. application) | |
--vpc-id |
string | VPC ID (required) |
stratumctl lb load-balancers delete
Section titled “stratumctl lb load-balancers delete”Delete a load balancer
stratumctl lb load-balancers delete <lb-id> [flags]Examples
Section titled “Examples”stratumctl lb load-balancers delete lb-7k2m9x4q8a| Flag | Type | Default | Description |
|---|---|---|---|
--force |
bool | false |
delete a platform-owned resource anyway (needs platform:ManageInternal; audited; the platform re-creates it) |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb load-balancers get
Section titled “stratumctl lb load-balancers get”Describe a load balancer
stratumctl lb load-balancers get <lb-id> [flags]Examples
Section titled “Examples”stratumctl lb load-balancers get lb-7k2m9x4q8astratumctl lb load-balancers get lb-7k2m9x4q8a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb load-balancers list
Section titled “stratumctl lb load-balancers list”List load balancers in a project
stratumctl lb load-balancers list [flags]Examples
Section titled “Examples”stratumctl lb load-balancers liststratumctl lb load-balancers list --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb load-balancers update
Section titled “stratumctl lb load-balancers update”Modify a load balancer (security groups)
stratumctl lb load-balancers update <lb-id> [flags]Examples
Section titled “Examples”stratumctl lb load-balancers update lb-7k2m9x4q8a --security-group-ids sg-3f8d2k9x,sg-7k2m9x4q| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--security-group-ids |
stringSlice | Replacement security group IDs for the LB NIC (comma-separated; empty clears) |
stratumctl lb middleware
Section titled “stratumctl lb middleware”Manage load-balancer middleware (request/response filters)
stratumctl lb middleware [flags]Aliases: middlewares, mw
Subcommands
Section titled “Subcommands”stratumctl lb middleware create: Create a middleware (–config is a JSON object; per-kind schema)stratumctl lb middleware delete: Delete a middlewarestratumctl lb middleware get: Describe a middlewarestratumctl lb middleware list: List a load balancer’s middleware
stratumctl lb middleware create
Section titled “stratumctl lb middleware create”Create a middleware (–config is a JSON object; per-kind schema)
stratumctl lb middleware create <lb-id> <name> [flags]Examples
Section titled “Examples”stratumctl lb middleware create lb-7k2m9x4q8a rate-100 --kind rate_limit --config-json '{"requestsPerSecond":100}'| Flag | Type | Default | Description |
|---|---|---|---|
--config-json |
string | JSON config for the kind, e.g. ‘{“requestsPerSecond”:100}’ | |
--kind |
string | Middleware kind (e.g. rate_limit, headers, request_body_limit) (required) | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb middleware delete
Section titled “stratumctl lb middleware delete”Delete a middleware
stratumctl lb middleware delete <middleware-id> [flags]Examples
Section titled “Examples”stratumctl lb middleware delete mw-4k8m2x7q9a| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb middleware get
Section titled “stratumctl lb middleware get”Describe a middleware
stratumctl lb middleware get <middleware-id> [flags]Examples
Section titled “Examples”stratumctl lb middleware get mw-4k8m2x7q9astratumctl lb middleware get mw-4k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb middleware list
Section titled “stratumctl lb middleware list”List a load balancer’s middleware
stratumctl lb middleware list <lb-id> [flags]Examples
Section titled “Examples”stratumctl lb middleware list lb-7k2m9x4q8astratumctl lb middleware list lb-7k2m9x4q8a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb rules
Section titled “stratumctl lb rules”Manage listener rules (priority-ordered conditions → actions)
stratumctl lb rules [flags]Aliases: rule, listener-rules
Subcommands
Section titled “Subcommands”stratumctl lb rules attach-middleware: Attach a middleware to a rule (ordered chain)stratumctl lb rules create: Create a listener rule (–conditions + –actions are JSON objects)stratumctl lb rules delete: Delete a listener rulestratumctl lb rules list: List a listener’s rules
stratumctl lb rules attach-middleware
Section titled “stratumctl lb rules attach-middleware”Attach a middleware to a rule (ordered chain)
stratumctl lb rules attach-middleware <rule-id> [flags]Examples
Section titled “Examples”stratumctl lb rules attach-middleware lbr-6k2m8x4q7a --middleware mw-4k8m2x7q9astratumctl lb rules attach-middleware lbr-6k2m8x4q7a --middleware mw-4k8m2x7q9a --position 1| Flag | Type | Default | Description |
|---|---|---|---|
--middleware |
string | Middleware ID to attach (required) | |
--position |
int | 0 |
Position in the chain (lower runs first) |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb rules create
Section titled “stratumctl lb rules create”Create a listener rule (–conditions + –actions are JSON objects)
stratumctl lb rules create <listener-id> [flags]Examples
Section titled “Examples”stratumctl lb rules create lis-5k8m2x7q9a --priority 10 --conditions '{"path_prefix":"/api"}' --actions '{"type":"forward","target_group_id":"tg-3k8m2x7q9a"}'| Flag | Type | Default | Description |
|---|---|---|---|
--actions |
string | JSON action, e.g. ‘{“type”:“forward”,“target_group_id”:“tg-…”}’ (required) | |
--conditions |
string | JSON conditions, e.g. ‘{“path_prefix”:“/v2”,“hosts”:[“api.example.com”]}’ (required) | |
--priority |
int | 0 |
Rule priority (lower matches first, required) |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb rules delete
Section titled “stratumctl lb rules delete”Delete a listener rule
stratumctl lb rules delete <rule-id> [flags]Examples
Section titled “Examples”stratumctl lb rules delete lbr-6k2m8x4q7a| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb rules list
Section titled “stratumctl lb rules list”List a listener’s rules
stratumctl lb rules list <listener-id> [flags]Examples
Section titled “Examples”stratumctl lb rules list lis-5k8m2x7q9astratumctl lb rules list lis-5k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb ssl-certificates
Section titled “stratumctl lb ssl-certificates”Manage SSL certificates and attach them to HTTPS listeners
stratumctl lb ssl-certificates [flags]Aliases: ssl-certificate, certs, cert
Subcommands
Section titled “Subcommands”stratumctl lb ssl-certificates attach: Attach a certificate to an HTTPS listener (SNI)stratumctl lb ssl-certificates delete: Delete an SSL certificate (detach from listeners first)stratumctl lb ssl-certificates get: Describe an SSL certificatestratumctl lb ssl-certificates list: List SSL certificates in a projectstratumctl lb ssl-certificates upload: Upload a PEM certificate + private key
stratumctl lb ssl-certificates attach
Section titled “stratumctl lb ssl-certificates attach”Attach a certificate to an HTTPS listener (SNI)
stratumctl lb ssl-certificates attach <listener-id> [flags]Examples
Section titled “Examples”stratumctl lb ssl-certificates attach lis-5k8m2x7q9a --certificate cert-2k8m4x7q9astratumctl lb ssl-certificates attach lis-5k8m2x7q9a --certificate cert-2k8m4x7q9a --position 1| Flag | Type | Default | Description |
|---|---|---|---|
--certificate |
string | SSL certificate ID to attach (required) | |
--position |
int | 0 |
SNI ordering (lower matched first) |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb ssl-certificates delete
Section titled “stratumctl lb ssl-certificates delete”Delete an SSL certificate (detach from listeners first)
stratumctl lb ssl-certificates delete <cert-id> [flags]Examples
Section titled “Examples”stratumctl lb ssl-certificates delete cert-2k8m4x7q9a| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb ssl-certificates get
Section titled “stratumctl lb ssl-certificates get”Describe an SSL certificate
stratumctl lb ssl-certificates get <cert-id> [flags]Examples
Section titled “Examples”stratumctl lb ssl-certificates get cert-2k8m4x7q9astratumctl lb ssl-certificates get cert-2k8m4x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb ssl-certificates list
Section titled “stratumctl lb ssl-certificates list”List SSL certificates in a project
stratumctl lb ssl-certificates list [flags]Examples
Section titled “Examples”stratumctl lb ssl-certificates liststratumctl lb ssl-certificates list --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb ssl-certificates upload
Section titled “stratumctl lb ssl-certificates upload”Upload a PEM certificate + private key
stratumctl lb ssl-certificates upload <name> [flags]Examples
Section titled “Examples”stratumctl lb ssl-certificates upload web-cert --cert-file fullchain.pem --key-file privkey.pem| Flag | Type | Default | Description |
|---|---|---|---|
--cert-file |
string | Path to the PEM certificate (required) | |
--key-file |
string | Path to the PEM private key (required) | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb target-groups
Section titled “stratumctl lb target-groups”Manage target groups
stratumctl lb target-groups [flags]Aliases: target-group, tg
Subcommands
Section titled “Subcommands”stratumctl lb target-groups create: Create a target groupstratumctl lb target-groups delete: Delete a target groupstratumctl lb target-groups get: Describe a target groupstratumctl lb target-groups list: List target groups in a project
stratumctl lb target-groups create
Section titled “stratumctl lb target-groups create”Create a target group
stratumctl lb target-groups create <name> [flags]Examples
Section titled “Examples”stratumctl lb target-groups create web-tg --target-type instance --port 8080 --vpc-id vpc-9k2m4x7qstratumctl lb target-groups create asg-tg --target-type auto-scaling-group --port 80 --protocol http --vpc-id vpc-9k2m4x7q| Flag | Type | Default | Description |
|---|---|---|---|
--display-name |
string | Human-friendly display name | |
--port |
int | 0 |
Target port (required) |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--protocol |
string | Protocol (e.g. http, https, tcp) | |
--target-type |
string | instance | network-interface | ip | auto-scaling-group (required) | |
--vpc-id |
string | VPC ID (required) |
stratumctl lb target-groups delete
Section titled “stratumctl lb target-groups delete”Delete a target group
stratumctl lb target-groups delete <target-group-id> [flags]Examples
Section titled “Examples”stratumctl lb target-groups delete tg-3k8m2x7q9a| Flag | Type | Default | Description |
|---|---|---|---|
--force |
bool | false |
delete a platform-owned resource anyway (needs platform:ManageInternal; audited; the platform re-creates it) |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb target-groups get
Section titled “stratumctl lb target-groups get”Describe a target group
stratumctl lb target-groups get <target-group-id> [flags]Examples
Section titled “Examples”stratumctl lb target-groups get tg-3k8m2x7q9astratumctl lb target-groups get tg-3k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb target-groups list
Section titled “stratumctl lb target-groups list”List target groups in a project
stratumctl lb target-groups list [flags]Examples
Section titled “Examples”stratumctl lb target-groups liststratumctl lb target-groups list --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb targets
Section titled “stratumctl lb targets”Register / list / deregister targets in a target group
stratumctl lb targets [flags]Aliases: target
Subcommands
Section titled “Subcommands”stratumctl lb targets deregister: Deregister a target from a target groupstratumctl lb targets list: List a target group’s targets and their healthstratumctl lb targets register: Register a target (instance, NIC, IP or auto scaling group) into a target group
stratumctl lb targets deregister
Section titled “stratumctl lb targets deregister”Deregister a target from a target group
stratumctl lb targets deregister <target-group-id> [flags]Examples
Section titled “Examples”stratumctl lb targets deregister tg-3k8m2x7q9a --target-id i-uy3ureaklq| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--target-id |
string | Target ID to deregister (required) |
stratumctl lb targets list
Section titled “stratumctl lb targets list”List a target group’s targets and their health
stratumctl lb targets list <target-group-id> [flags]Examples
Section titled “Examples”stratumctl lb targets list tg-3k8m2x7q9astratumctl lb targets list tg-3k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl lb targets register
Section titled “stratumctl lb targets register”Register a target (instance, NIC, IP or auto scaling group) into a target group
stratumctl lb targets register <target-group-id> [flags]Examples
Section titled “Examples”stratumctl lb targets register tg-3k8m2x7q9a --target-id i-uy3ureaklq --port 8080stratumctl lb targets register tg-3k8m2x7q9a --target-type ip --target-id 10.0.1.20 --port 8080 --weight 2| Flag | Type | Default | Description |
|---|---|---|---|
--ip-address |
string | The address for an ip target; optional for resolved types, where it must match the resolved address | |
--port |
int | 0 |
Target port (required; ignored for an auto-scaling-group target) |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--target-id |
string | What the target names: an IP (ip), an instance id i-… (instance), a NIC id nic-… (network-interface) or a group id asg-… (auto-scaling-group) (required) | |
--target-type |
string | instance | network-interface | ip | auto-scaling-group (default: the target group’s) | |
--weight |
int | 1 |
Relative traffic weight |