Skip to content

stratumctl service-accounts

Manage IAM service accounts

Terminal window
stratumctl service-accounts [flags]

Aliases: service-account, sa

Create a new service account

Terminal window
stratumctl service-accounts create <displayName> [flags]
Terminal window
stratumctl service-accounts create ci-runner --project p-team-a
stratumctl service-accounts create ci-runner --project p-team-a --description "CI pipeline identity"
Flag Type Default Description
--description string Free-form description
--project string Project ID

Soft-delete a service account. Idempotent. Cascade-revokes signing keys.

Terminal window
stratumctl service-accounts delete <id> [flags]
Terminal window
stratumctl service-accounts delete sa-7k2m9x4q8a --project p-team-a
Flag Type Default Description
--project string Project ID

Describe a service account

Terminal window
stratumctl service-accounts get <id> [flags]
Terminal window
stratumctl service-accounts get sa-7k2m9x4q8a --project p-team-a
stratumctl service-accounts get sa-7k2m9x4q8a --project p-team-a --output json
Flag Type Default Description
--project string Project ID

Manage service-account signing keys

Terminal window
stratumctl service-accounts keys [flags]

Aliases: key

Mint a new signing key. Secret printed ONCE.

Terminal window
stratumctl service-accounts keys create [flags]
Terminal window
stratumctl service-accounts keys create --project p-team-a --service-account sa-7k2m9x4q8a --label ci --ttl 720h
Flag Type Default Description
--label string Operator-facing label
--project string Project ID
--service-account string Service-account ID
--ttl string TTL (Go duration; empty = no expiry)

Describe a signing key

Terminal window
stratumctl service-accounts keys get <key-id> [flags]
Terminal window
stratumctl service-accounts keys get sak-3k8m2x7q9a --project p-team-a --service-account sa-7k2m9x4q8a
stratumctl service-accounts keys get sak-3k8m2x7q9a --project p-team-a --service-account sa-7k2m9x4q8a --output json
Flag Type Default Description
--project string Project ID
--service-account string Service-account ID

List signing keys for a service account

Terminal window
stratumctl service-accounts keys list [flags]
Terminal window
stratumctl service-accounts keys list --project p-team-a --service-account sa-7k2m9x4q8a
stratumctl service-accounts keys list --project p-team-a --service-account sa-7k2m9x4q8a --output json
Flag Type Default Description
--project string Project ID
--service-account string Service-account ID

Revoke a signing key. Idempotent.

Terminal window
stratumctl service-accounts keys revoke <key-id> [flags]
Terminal window
stratumctl service-accounts keys revoke sak-3k8m2x7q9a --project p-team-a --service-account sa-7k2m9x4q8a
Flag Type Default Description
--project string Project ID
--service-account string Service-account ID

List service accounts in a project

Terminal window
stratumctl service-accounts list [flags]
Terminal window
stratumctl service-accounts list --project p-team-a
stratumctl service-accounts list --project p-team-a --output json
Flag Type Default Description
--project string Project ID

Update a service account (sparse PATCH)

Terminal window
stratumctl service-accounts update <id> [flags]
Terminal window
stratumctl service-accounts update sa-7k2m9x4q8a --project p-team-a --display-name "ci runner"
stratumctl service-accounts update sa-7k2m9x4q8a --project p-team-a --state disabled
Flag Type Default Description
--description string New description
--display-name string New display name
--project string Project ID
--state string New state: active|disabled