Skip to main content

Enumeration: ActivityExecutionStatus

Status of a standalone activity. The status is updated when the activity is originally scheduled, paused, unpaused, and when the activity reaches a terminal state. (-- api-linter: core::0216::synonyms=disabled aip.dev/not-precedent: Named consistently with WorkflowExecutionStatus. --)

Enumeration Members​

ACTIVITY_EXECUTION_STATUS_CANCELED​

ACTIVITY_EXECUTION_STATUS_CANCELED: 4

The activity was canceled. Reached when:

  • Cancellation requested while SCHEDULED (immediate), or
  • Cancellation requested while STARTED and worker called RespondActivityTaskCanceled.

Workers discover cancellation requests via heartbeat responses (cancel_requested=true). Activities that do not heartbeat will not learn of cancellation and may complete, fail, or time out normally. CANCELED requires explicit worker acknowledgment or immediate cancellation of a SCHEDULED activity.

ACTIVITY_EXECUTION_STATUS_COMPLETED​

ACTIVITY_EXECUTION_STATUS_COMPLETED: 2

The activity completed successfully. An activity can complete even after cancellation is requested if the worker calls RespondActivityTaskCompleted before acknowledging cancellation.

ACTIVITY_EXECUTION_STATUS_FAILED​

ACTIVITY_EXECUTION_STATUS_FAILED: 3

The activity failed. Causes:

  • Worker returned a non-retryable failure
  • RetryPolicy.maximum_attempts exhausted
  • Attempt failed after cancellation was requested (retries blocked)

ACTIVITY_EXECUTION_STATUS_PAUSED​

ACTIVITY_EXECUTION_STATUS_PAUSED: 7

The activity is paused. Paused state is only reachable after calling PauseActivityExecution on a standalone activity.

ACTIVITY_EXECUTION_STATUS_RUNNING​

ACTIVITY_EXECUTION_STATUS_RUNNING: 1

The activity has not reached a terminal status. See PendingActivityState for the run state (SCHEDULED, STARTED, or CANCEL_REQUESTED).

ACTIVITY_EXECUTION_STATUS_TERMINATED​

ACTIVITY_EXECUTION_STATUS_TERMINATED: 5

The activity was terminated. Immediate; does not wait for worker acknowledgment.

ACTIVITY_EXECUTION_STATUS_TIMED_OUT​

ACTIVITY_EXECUTION_STATUS_TIMED_OUT: 6

The activity timed out. See TimeoutType for the specific timeout.

  • SCHEDULE_TO_START and SCHEDULE_TO_CLOSE timeouts always result in TIMED_OUT.
  • START_TO_CLOSE and HEARTBEAT may retry if RetryPolicy permits; TIMED_OUT is reached when retry is blocked (RetryPolicy.maximum_attempts exhausted, SCHEDULE_TO_CLOSE would be exceeded, or cancellation has been requested).

ACTIVITY_EXECUTION_STATUS_UNSPECIFIED​

ACTIVITY_EXECUTION_STATUS_UNSPECIFIED: 0

ACTIVITY_EXECUTION_STATUS_UNSPECIFIED value