nodes:stage:lease:acquire

Reference for flywheel nodes:stage:lease:acquire.

Command Group

Nodes & Graph Commands

Acquire an edit lease for an existing node.

flywheel nodes:stage:lease:acquire <FLAGS>

Flag	Value	Description
`--node_id`	`string`	Target node identifier.
`--stage_session_id`	`string`	Client-provided session identifier for the lease.
`--base_committed_revision`	`integer`	Committed revision the edit is based on.

Flag	Value	Default	Choices	Description
`--format`	`FORMAT`		`json`, `tsv`, `csv`, `table`	Output format for command results.
`--env`	`PROFILE`			Use a configured CLI profile for this invocation.
`--out`	`PATH`			Write output to a file path, or use - for stdout.
`--open`				Open browser-bound URLs when supported.
`--no-retry`				Disable transient-error retries.
`--retry-max`	`N`			Maximum transient-error retry attempts.
`--wait`				Block on async operations until a terminal state is reached.
`--wait-timeout`	`SECONDS`	`600`		Seconds to wait for --wait before timing out. Defaults to 600.
`--allow-self`				Allow mutating the currently active credential.
`--timeout`	`SECONDS`			Set the per-request timeout budget in seconds.
`--idempotency-key`	`KEY`			Reuse an Idempotency-Key so ambiguous write failures can be retried with the same key.
`--force`				Force safety-gated operations where supported.
`--yes`				Skip confirmation prompts for destructive operations.
`--debug`				Print structured request debugging with secrets masked.
`--verbose`				Print verbose progress for long-running operations.
`-h, --help`				Show this help.

Acquire a lease before committing a staged edit.

flywheel nodes:stage:lease:acquire --node_id n_abc --stage_session_id session-1 --base_committed_revision 7

Acquire a lease using the --key=value long form.

flywheel nodes:stage:lease:acquire --node_id=n_abc --stage_session_id=session-2 --base_committed_revision=12