SDKs & ToolsCLI

spiral projects

Create projects and manage access grants

Usage: spiral projects [OPTIONS] <COMMAND>

Options

OptionRequiredDefaultDescription
--jsonnoEmit output as JSON instead of formatted tables
--json-logsnoWrite structured JSON logs to standard error

Subcommands

CommandSummary
spiral projects lsList the projects in your active organization
spiral projects createCreate a new project in your active organization
spiral projects dropDrop a project
spiral projects grantGrant a role on a project to a user, org role, or workload
spiral projects grantsList the active access grants on a project
spiral projects grant-infoShow details for a single grant
spiral projects revokeRevoke a grant by ID
spiral projects storageRead or select the storage used for new tables

spiral projects ls

Usage: spiral projects ls [OPTIONS]

Options

OptionRequiredDefaultDescription
--jsonnoEmit output as JSON instead of formatted tables
--json-logsnoWrite structured JSON logs to standard error

spiral projects create

Usage: spiral projects create [OPTIONS]

Options

OptionRequiredDefaultDescription
-d, --description <DESCRIPTION>noHuman-readable description for the project
--id-prefix <ID_PREFIX>noOptional ID prefix to which a random number will be appended
--volume <VOLUME>noThe Volume on which the project stores its tables, such as vol_gcp_us_east4. Without it, the project uses its organization's default
--jsonnoEmit output as JSON instead of formatted tables
--json-logsnoWrite structured JSON logs to standard error

spiral projects drop

Usage: spiral projects drop [OPTIONS] [PROJECT]

Arguments

ArgumentRequiredDefaultDescription
PROJECTnoProject ID. Prompted interactively when omitted on a TTY

Options

OptionRequiredDefaultDescription
-y, --yesnoSkip the confirmation prompt
--jsonnoEmit output as JSON instead of formatted tables
--json-logsnoWrite structured JSON logs to standard error

spiral projects grant

Usage: spiral projects grant [OPTIONS] [PROJECT]

Arguments

ArgumentRequiredDefaultDescription
PROJECTnoProject ID. Prompted interactively when omitted on a TTY

Options

OptionRequiredDefaultDescription
--role <ROLE>noProject role to grant. Prompted interactively when omitted on a TTY
--org-id <ORG_ID>noOrganization ID, to grant a role to organization user(s)
--org-user <ORG_USER>noUser ID. Use with --org-id
--org-role <ORG_ROLE>noOrg role. Use with --org-id
--workload-id <WORKLOAD_ID>noWorkload ID, to grant a role to a workload
--jsonnoEmit output as JSON instead of formatted tables
--json-logsnoWrite structured JSON logs to standard error

spiral projects grants

Usage: spiral projects grants [OPTIONS] [PROJECT]

Arguments

ArgumentRequiredDefaultDescription
PROJECTnoProject ID. Prompted interactively when omitted on a TTY

Options

OptionRequiredDefaultDescription
--principal <PRINCIPAL>noFilter grants by principal string
--jsonnoEmit output as JSON instead of formatted tables
--json-logsnoWrite structured JSON logs to standard error

spiral projects grant-info

Usage: spiral projects grant-info [OPTIONS] <GRANT_ID>

Arguments

ArgumentRequiredDefaultDescription
GRANT_IDyesGrant ID

Options

OptionRequiredDefaultDescription
--jsonnoEmit output as JSON instead of formatted tables
--json-logsnoWrite structured JSON logs to standard error

spiral projects revoke

Usage: spiral projects revoke [OPTIONS] <GRANT_ID>

Arguments

ArgumentRequiredDefaultDescription
GRANT_IDyesGrant ID

Options

OptionRequiredDefaultDescription
-y, --yesnoSkip the confirmation prompt
--jsonnoEmit output as JSON instead of formatted tables
--json-logsnoWrite structured JSON logs to standard error

spiral projects storage

Usage: spiral projects storage [OPTIONS] [PROJECT]

Arguments

ArgumentRequiredDefaultDescription
PROJECTnoProject ID. Prompted interactively when omitted on a TTY

Options

OptionRequiredDefaultDescription
--volume <VOLUME>noSelect this Volume for new tables; existing data is not moved
--file-systemnoAllocate through the Project's file system
--jsonnoEmit output as JSON instead of formatted tables
--json-logsnoWrite structured JSON logs to standard error
Found a problem? Edit this page or report an issue.

On this page