Skip to main content

Interface: IStartActivityExecutionRequest

Properties of a StartActivityExecutionRequest.

Extends​

Properties​

activityId?​

optional activityId?: string | null

Identifier for this activity. Required. This identifier should be meaningful in the user's own system. It must be unique among activities in the same namespace, subject to the rules imposed by id_reuse_policy and id_conflict_policy.

Inherited from​

$Properties.activityId

activityType?​

optional activityType?: $Properties | null

The type of the activity, a string that corresponds to a registered activity on a worker.

Inherited from​

$Properties.activityType

completionCallbacks?​

optional completionCallbacks?: $Properties[] | null

Callbacks to be called by the server when this activity reaches a terminal state. Callback addresses must be whitelisted in the server's dynamic configuration.

Inherited from​

$Properties.completionCallbacks

optional header?: $Properties | null

Header for context propagation and tracing purposes.

Inherited from​

$Properties.header

heartbeatTimeout?​

optional heartbeatTimeout?: $Properties | null

Maximum permitted time between successful worker heartbeats.

Inherited from​

$Properties.heartbeatTimeout

idConflictPolicy?​

optional idConflictPolicy?: ActivityIdConflictPolicy | null

Defines how to resolve an activity id conflict with a running activity. The default policy is ACTIVITY_ID_CONFLICT_POLICY_FAIL.

Inherited from​

$Properties.idConflictPolicy

identity?​

optional identity?: string | null

The identity of the client who initiated this request

Inherited from​

$Properties.identity

idReusePolicy?​

optional idReusePolicy?: ActivityIdReusePolicy | null

Defines whether to allow re-using the activity id from a previously closed activity. The default policy is ACTIVITY_ID_REUSE_POLICY_ALLOW_DUPLICATE.

Inherited from​

$Properties.idReusePolicy

input?​

optional input?: $Properties | null

Serialized arguments to the activity. These are passed as arguments to the activity function.

Inherited from​

$Properties.input

optional links?: $Properties[] | null

Links to be associated with the activity. Callbacks may also have associated links; links already included with a callback should not be duplicated here.

Inherited from​

$Properties.links

namespace?​

optional namespace?: string | null

StartActivityExecutionRequest namespace

Inherited from​

$Properties.namespace

onConflictOptions?​

optional onConflictOptions?: $Properties | null

Options for handling conflicts when using ACTIVITY_ID_CONFLICT_POLICY_USE_EXISTING.

Inherited from​

$Properties.onConflictOptions

priority?​

optional priority?: $Properties | null

Priority metadata.

Inherited from​

$Properties.priority

propagatedNexusSerializationContext?​

optional propagatedNexusSerializationContext?: $Properties | null

Serialization context propagated from the Nexus caller that started this activity.

Inherited from​

$Properties.propagatedNexusSerializationContext

requestEagerExecution?​

optional requestEagerExecution?: boolean | null

Request that the first activity task be returned directly in the start response instead of being dispatched through a task queue. If set to true, the caller is expected to have a worker available and capable of processing the task. The returned task will be marked as started. The server may ignore this request.

Inherited from​

$Properties.requestEagerExecution

requestId?​

optional requestId?: string | null

A unique identifier for this start request. Typically UUIDv4.

Inherited from​

$Properties.requestId

retryPolicy?​

optional retryPolicy?: $Properties | null

The retry policy for the activity. Will never exceed schedule_to_close_timeout.

Inherited from​

$Properties.retryPolicy

scheduleToCloseTimeout?​

optional scheduleToCloseTimeout?: $Properties | null

Indicates how long the caller is willing to wait for an activity completion. Limits how long retries will be attempted. Either this or start_to_close_timeout must be specified.

(-- api-linter: core::0140::prepositions=disabled aip.dev/not-precedent: "to" is used to indicate interval. --)

Inherited from​

$Properties.scheduleToCloseTimeout

scheduleToStartTimeout?​

optional scheduleToStartTimeout?: $Properties | null

Limits time an activity task can stay in a task queue before a worker picks it up. This timeout is always non retryable, as all a retry would achieve is to put it back into the same queue. Defaults to schedule_to_close_timeout if not specified.

(-- api-linter: core::0140::prepositions=disabled aip.dev/not-precedent: "to" is used to indicate interval. --)

Inherited from​

$Properties.scheduleToStartTimeout

searchAttributes?​

optional searchAttributes?: $Properties | null

Search attributes for indexing.

Inherited from​

$Properties.searchAttributes

startDelay?​

optional startDelay?: $Properties | null

Time to wait before making the first activity task available for dispatch. This delay is not applied to retry attempts.

Inherited from​

$Properties.startDelay

startToCloseTimeout?​

optional startToCloseTimeout?: $Properties | null

Maximum time an activity is allowed to execute after being picked up by a worker. This timeout is always retryable. Either this or schedule_to_close_timeout must be specified.

(-- api-linter: core::0140::prepositions=disabled aip.dev/not-precedent: "to" is used to indicate interval. --)

Inherited from​

$Properties.startToCloseTimeout

taskQueue?​

optional taskQueue?: $Properties | null

Task queue to schedule this activity on.

Inherited from​

$Properties.taskQueue

userMetadata?​

optional userMetadata?: $Properties | null

Metadata for use by user interfaces to display the fixed as-of-start summary and details of the activity.

Inherited from​

$Properties.userMetadata