dcloud rds branches create

Cut a branch: a ZFS clone of the masked pool base, or a restore to a second

IAM rds:CreateDBBranchChanges state

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>Required

    string

    Also accepted as --id. Constraints: 3-64 chars, /^(?!ewdoc-)[a-z0-9-]+$/

Flags

  • --nameRequired

    string

    Branch name: lowercase letters, digits and dashes (pr-42, alice-test)

    Constraints: 1-40 chars, /^[a-z0-9][a-z0-9-]*$/

  • --recovery-target-timeOptional

    string

    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-hoursOptional

    number

    Hours until the branch is deleted; default 168 (7 days)

    Constraints: integer, 1-720

Example

dcloud rds branches create id --name example

Generated from the API description, the same one the API checks requests against and the CLI is built from.