Skip to main content

tctl workflow reset-batch

The tctl workflow reset-batch command resets a batch of Workflow Executions by resetType.

Resetting a Workflow allows the process to be resumed from a certain point without losing your parameters or Event History.

To reset individual Workflows, see tctl workflow reset.

tctl workflow reset-batch <modifiers>

The following modifiers control the behavior of the command.

--input_file

Provide an input file that specifies Workflow Execution to reset.

Each line contains one Workflow Id as the base Run and, optionally, a Run Id. If a Run Id is not specified, the current Run Id is used.

Alias: --if

Example

tctl workflow reset-batch --input_file <filename>

--query

Specify an SQL-like query of Search Attributes describing the Workflow Executions to reset.

Alias: -q

Example

tctl workflow reset-batch --query <value>

--exclude_file

Provide an input file that specifies Workflow Executions to exclude from resetting.

Each line contains one Workflow Id.

Example

tctl workflow reset-batch --exclude_file <filename>

--input_separator

Specify the separator for the input file. The default is a tab (\t).

Example

tctl workflow reset-batch --input_separator <string>

--reason

Specify a reason for resetting the Workflow Executions.

Example

tctl workflow reset-batch --reason <string>

--input_parallism

Specify the number of goroutines to run in parallel. Each goroutine processes one line for every second. The default is 1.

Example

tctl workflow reset-batch --input_parallism <value>

--skip_current_open

Indicate that a Workflow Execution should be skipped if the current Run is open for the same Workflow Id as the base Run.

Example

tctl workflow reset-batch --skip_current_open

--skip_base_is_not_current

Indicate that a Workflow Execution should be skipped if the base Run is not the current Run.

Example

tctl workflow reset-batch --skip_base_is_not_current

--only_non_deterministic

Indicate that a Workflow Execution should be reset only if its last event is WorkflowTaskFailed with a nondeterministic error.

Example

tctl workflow reset-batch --only_non_deterministic

--dry_run

Simulate use of the tctl workflow reset-batch command without resetting any Workflow Executions. Output is logged to stdout.

Example

tctl workflow reset-batch --dry_run

--reset_type

Specify the event type to which you want to reset.

ValueDescription
FirstWorkflowTaskReset to the beginning of the Event History.
LastWorkflowTaskReset to the end of the Event History.
LastContinuedAsNewReset to the end of the Event History for the previous Run.
BadBinaryReset to the point where a bad binary was used.

Example

tctl workflow reset-batch --reset_type <value>

--reset_bad_binary_checksum

Specify the binary checksum when using --reset_type BadBinary.

Example

tctl workflow reset-batch --reset_bad_binary_checksum <value>