IDurableOrchestrationContext.ContinueAsNew(Object, Boolean) Method

Definition

Namespace:

Microsoft.Azure.WebJobs.Extensions.DurableTask

Assembly:

Microsoft.Azure.WebJobs.Extensions.DurableTask.dll

Package:

Microsoft.Azure.WebJobs.Extensions.DurableTask v2.8.1

Source:

IDurableOrchestrationContext.cs

Restarts the orchestration by clearing its history.

public void ContinueAsNew (object input, bool preserveUnprocessedEvents = false);

abstract member ContinueAsNew : obj * bool -> unit

Public Sub ContinueAsNew (input As Object, Optional preserveUnprocessedEvents As Boolean = false)

Parameters

input

Object

The JSON-serializeable data to re-initialize the instance with.

preserveUnprocessedEvents

Boolean

If set to true, re-adds any unprocessed external events into the new execution history when the orchestration instance restarts. If false, any unprocessed external events will be discarded when the orchestration instance restarts.

Remarks

Large orchestration histories can consume a lot of memory and cause delays in instance load times. This method can be used to periodically truncate the stored history of an orchestration instance.

Note that any unprocessed external events will be discarded when an orchestration instance restarts itself using this method.