Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 3 additions & 7 deletions docs/cli/command-reference/activity.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -236,8 +236,7 @@ Use the following options to change the behavior of this command. You can also u
Reset an activity. Not supported for Standalone Activities.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

This restarts the activity as if it were first being

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

scheduled. That is, it will reset both the number of attempts and the
activity timeout, as well as, optionally, the
[heartbeat details](#reset-heartbeats).
activity timeout, as well as the [heartbeat details](#reset-heartbeats).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Heartbeat' instead of 'heartbeat' when referring to a Temporal term.


If the activity may be executing (i.e. it has not yet timed out), the

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

reset will take effect the next time it fails, heartbeats, or times out.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] reported by reviewdog 🐶
[Temporal.Headings] 'reset' should use sentence-style capitalization.

Expand All @@ -261,16 +260,15 @@ the next time they heartbeat after a reset.
If, in your Activity, you need to do any cleanup when an Activity is
reset, handle this error and then re-throw it when you've cleaned up.

If the `reset_heartbeats` flag is set, the heartbeat details will also be cleared.
Reset clears heartbeat details.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Heartbeat' instead of 'heartbeat' when referring to a Temporal term.


Specify the Activity and Workflow IDs:

```
temporal activity reset \
--activity-id YourActivityId \
--workflow-id YourWorkflowId
--workflow-id YourWorkflowId \
--keep-paused
--reset-heartbeats
```

Activities can be reset in bulk with a visibility query list filter:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Query' instead of 'query' when referring to a Temporal term.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'List Filter' instead of 'list filter' when referring to a Temporal term.

Expand All @@ -291,7 +289,6 @@ Use the following options to change the behavior of this command. You can also u
| `--query`, `-q` | No | **string** Content for an SQL-like `QUERY` List Filter. You must set either --workflow-id or --query. Note: Using --query for batch activity operations is an experimental feature and may change in the future. |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

| `--reason` | No | **string** Reason for batch operation. Only use with --query. Defaults to user name. |
| `--reset-attempts` | No | **bool** Reset the activity attempts. |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

| `--reset-heartbeats` | No | **bool** Reset the Activity's heartbeats. |
| `--restore-original-options` | No | **bool** Restore the original options of the activity. |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Activity' instead of 'activity' when referring to a Temporal term.

| `--rps` | No | **float** Limit batch's requests per second. Only allowed if query is present. |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] reported by reviewdog 🐶
[Temporal.terms] Use 'Query' instead of 'query' when referring to a Temporal term.

| `--run-id`, `-r` | No | **string** Run ID. Only use with --workflow-id. Cannot use with --query. |
Expand Down Expand Up @@ -525,4 +522,3 @@ The following options can be used with any command.
| `--tls-key-data` | No | **string** Private certificate key data. Can't be used with --tls-key-path. | |
| `--tls-key-path` | No | **string** Path to x509 private key. Can't be used with --tls-key-data. | |
| `--tls-server-name` | No | **string** Override target TLS server name. | |

Loading
Loading