dcloud rds branches createCut a branch: a ZFS clone of the masked pool base, or a restore to a second
The first branch of a database builds its branch pool (a restore of the latest backup onto one machine, minutes); later ones take seconds. A base older than the pool’s staleAfterHours (24) or masked with other rules is refreshed first. Every login role gets a new password on the branch (get-credentials).
Synopsis
dcloud rds branches create id --name name [flags]Arguments
<id>Requiredstring
Also accepted as
--id. Constraints: 3-64 chars, /^(?!ewdoc-)[a-z0-9-]+$/
Flags
--nameRequiredstring
Branch name: lowercase letters, digits and dashes (pr-42, alice-test)
Constraints: 1-40 chars, /^[a-z0-9][a-z0-9-]*$/
--recovery-target-timeOptionalstring
Branch the database as it was at this second (restored on the pool, minutes); omitted: now, a copy-on-write clone of the pool base (seconds)
--ttl-hoursOptionalnumber
Hours until the branch is deleted; default 168 (7 days)
Constraints: integer, 1-720
Example
dcloud rds branches create id --name exampleGenerated from the API description, the same one the API checks requests against and the CLI is built from.