Skip to content

DurableTaskAddress

struct

Namespace: Orleans.Durable.Tasks

The address of a durable task which other parties reach: the grain which stores the task and the task's identifier on that grain.
[Orleans.GenerateSerializer]
[Orleans.Immutable]
[Orleans.Alias(Orleans.Durable.Tasks.DurableTaskAddress)]
public readonly struct DurableTaskAddress : IDurableTaskReference, IEquatable<DurableTaskAddress>

Remarks

An address is a value which code stores and sends: Orleans serializes it in grain calls and journaled state, and System.Text.Json serializes it as {"Target":"{grain type}/{grain key}","Id":"{task ID}"}, so JSON journals and HTTP payloads carry it without registration. DurableTaskAddressExtensions turns it back into a reference, which awaits, polls, cancels, or aborts the task.

An address names a task which its grain retains for other parties: a root task, which a client, a grain, or a durable execution started, including a detached task, or a task which a client or another grain invoked. A grain retains a terminal root task for DurableTaskOptions.ResultRetentionPeriod, after which a lookup throws DurableTaskNotFoundException.

Constructors

Properties

  • IdThe task's identifier on Target.
  • TargetThe grain which stores the task.