Skip to content

stratumctl orgs

Manage organizations

Terminal window
stratumctl orgs [flags]

Aliases: org, organization, organizations

Create an organization

Terminal window
stratumctl orgs create <name> [flags]
Terminal window
stratumctl orgs create acme --display-name "Acme Corp"
Flag Type Default Description
--display-name string Human-readable display name

Delete an organization

Terminal window
stratumctl orgs delete <id> [flags]
Terminal window
stratumctl orgs delete o-acme

Get a single organization

Terminal window
stratumctl orgs get <id> [flags]
Terminal window
stratumctl orgs get o-acme
stratumctl orgs get o-acme --output json

List organizations

Terminal window
stratumctl orgs list [flags]
Terminal window
stratumctl orgs list
stratumctl orgs list --output json

An organization’s quotas: ceiling, per-project default, each project

Terminal window
stratumctl orgs quotas <org-id> [flags]
Terminal window
stratumctl orgs quotas o-acme
stratumctl orgs quotas o-acme --output json

Give one project of the organization a limit (at most the org’s ceiling)

Terminal window
stratumctl orgs quotas allocate [flags]
Terminal window
stratumctl orgs quotas allocate --org o-acme --project p-team-a --dimension compute.instances.count --limit 50
stratumctl orgs quotas allocate --org o-acme --project p-team-a --dimension db.storage_bytes --limit 500GiB
Flag Type Default Description
--dimension string Dimension key (required)
--limit amount The limit: an integer or a size like 500GiB (required)
--org string Organization ID (required)
--project string Project ID (required)

Approve one of the organization’s quota requests (writes the allocation)

Terminal window
stratumctl orgs quotas approve <request-id> [flags]
Terminal window
stratumctl orgs quotas approve qr-4f8k2m7x9p --org o-acme
stratumctl orgs quotas approve qr-4f8k2m7x9p --org o-acme --reason "within the team budget"
Flag Type Default Description
--org string Organization ID (required)
--reason string Recorded on the request

Clear a project’s allocation (the org’s per-project default applies)

Terminal window
stratumctl orgs quotas clear-allocation [flags]
Terminal window
stratumctl orgs quotas clear-allocation --org o-acme --project p-team-a --dimension compute.instances.count
Flag Type Default Description
--dimension string Dimension key (required)
--org string Organization ID (required)
--project string Project ID (required)

Clear the organization’s per-project default

Terminal window
stratumctl orgs quotas clear-default [flags]
Terminal window
stratumctl orgs quotas clear-default --org o-acme --dimension compute.instances.count
Flag Type Default Description
--dimension string Dimension key (required)
--org string Organization ID (required)

Deny one of the organization’s quota requests

Terminal window
stratumctl orgs quotas deny <request-id> [flags]
Terminal window
stratumctl orgs quotas deny qr-4f8k2m7x9p --org o-acme --reason "over the org budget"
Flag Type Default Description
--org string Organization ID (required)
--reason string Recorded on the request

The organization’s quota requests (pending by default)

Terminal window
stratumctl orgs quotas requests [flags]
Terminal window
stratumctl orgs quotas requests --org o-acme
stratumctl orgs quotas requests --org o-acme --status all --output json
Flag Type Default Description
--mine bool false Only the ones the org admin decides
--org string Organization ID (required)
--status string pending pending | approved | denied | canceled | all

Set the limit every project of the organization gets without an allocation

Terminal window
stratumctl orgs quotas set-default [flags]
Terminal window
stratumctl orgs quotas set-default --org o-acme --dimension compute.instances.count --limit 20
stratumctl orgs quotas set-default --org o-acme --dimension db.storage_bytes --limit 100GiB
Flag Type Default Description
--dimension string Dimension key (required)
--limit amount The limit: an integer or a size like 500GiB (required)
--org string Organization ID (required)

Update an organization’s mutable fields

Terminal window
stratumctl orgs update <id> [flags]
Terminal window
stratumctl orgs update o-acme --display-name "Acme Corporation"
stratumctl orgs update o-acme --description "Production tenants"
Flag Type Default Description
--description string New description
--display-name string New human-readable display name