GrpcDurableTaskClient.ScheduleNewOrchestrationInstanceAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Schedules a new orchestration instance for execution.
public override System.Threading.Tasks.Task<string> ScheduleNewOrchestrationInstanceAsync (Microsoft.DurableTask.TaskName orchestratorName, object? input = default, Microsoft.DurableTask.StartOrchestrationOptions? options = default, System.Threading.CancellationToken cancellation = default);override this.ScheduleNewOrchestrationInstanceAsync : Microsoft.DurableTask.TaskName * obj * Microsoft.DurableTask.StartOrchestrationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>Public Overrides Function ScheduleNewOrchestrationInstanceAsync (orchestratorName As TaskName, Optional input As Object = Nothing, Optional options As StartOrchestrationOptions = Nothing, Optional cancellation As CancellationToken = Nothing) As Task(Of String)Parameters
- orchestratorName
- TaskName
The name of the orchestrator to schedule.
- input
- Object
The optional input to pass to the scheduled orchestration instance. This must be a serializable value.
- options
- StartOrchestrationOptions
The options to start the new orchestration with.
- cancellation
- CancellationToken
The cancellation token. This only cancels enqueueing the new orchestration to the backend. Does not cancel the orchestration once enqueued.
Returns
A task that completes when the orchestration instance is successfully scheduled. The value of this task is
the instance ID of the scheduled orchestration instance. If a non-null instance ID was provided via
options, the same value will be returned by the completed task.