space
create
Create a product space on a branch.
strata space createdb.spaces.create(name: 'str') -> 'Any'wire space_create
Creates a product space in the branch catalog. Creation is idempotent: creating a space that already exists succeeds with `created: false` and no mutation effect. Names reserved for engine control data are rejected with `invalid_argument.engine.product_space_reserved`.
Successful mutations return an acknowledgement of the outcome: for a state-changing write, the affected target with the mutation effect and commit facts; for mutations that produce a domain result (such as a branch or a promotion outcome), that result object.
To see the complete help for this command, run:
strata space create --helphelp(db.spaces.create)
Example
Create a product space.
strata space create appstrata space list
_ = db.spaces.create("app")sorted(db.spaces.list())
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| space | string | yes | Product space name. |
| branch | string or null | no | Target branch. Defaults to the executor handle branch. |
Returns
MutationAck<SpaceCreate>
- dataobject
- typestring
Errors
Recover by code. Retry policy and commit outcome come from the shipped error registry.
| Code | Retry | Commit outcome |
|---|---|---|
| failed_precondition.engine.runtime_closed | never | not_started |
| not_found.engine.branch | never | not_applicable |
| invalid_argument.engine.product_space | never | not_started |
| invalid_argument.engine.product_space_reserved | never | not_started |