diff --git a/daprdocs/content/en/developing-applications/building-blocks/actors/howto-actors-partitioning.md b/daprdocs/content/en/developing-applications/building-blocks/actors/howto-actors-partitioning.md index 6356bdb90..ad3473d90 100644 --- a/daprdocs/content/en/developing-applications/building-blocks/actors/howto-actors-partitioning.md +++ b/daprdocs/content/en/developing-applications/building-blocks/actors/howto-actors-partitioning.md @@ -8,7 +8,7 @@ aliases: - "/developing-applications/building-blocks/actors/actors-background" --- -[Actor reminders]({{< ref "howto-actors-partitioning.md#actor-reminders" >}}) are persisted and continue to be triggered after sidecar restarts. Applications with multiple reminders registered can experience the following issues: +[Actor reminders]({{< ref "actors-timers-reminders.md#actor-reminders" >}}) are persisted and continue to be triggered after sidecar restarts. Applications with multiple reminders registered can experience the following issues: - Low throughput on reminders registration and de-registration - Limited number of reminders registered based on the single record size limit on the state store diff --git a/daprdocs/content/en/reference/api/actors_api.md b/daprdocs/content/en/reference/api/actors_api.md index edd6a46ff..180bea672 100644 --- a/daprdocs/content/en/reference/api/actors_api.md +++ b/daprdocs/content/en/reference/api/actors_api.md @@ -187,7 +187,7 @@ Creates a persistent reminder for an actor. POST/PUT http://localhost:/v1.0/actors///reminders/ ``` -#### Request Body +#### Reminder request body A JSON object with the following fields: @@ -351,7 +351,8 @@ Creates a timer for an actor. POST/PUT http://localhost:/v1.0/actors///timers/ ``` -Body: +#### Timer request body: +The format for the timer request body is the same as for [actor reminders]({{< ref "#reminder-request-body" >}}). For example: The following specifies a `dueTime` of 3 seconds and a period of 7 seconds. @@ -484,6 +485,16 @@ Parameter | Description `maxStackDepth` | A value in the reentrancy configuration that controls how many reentrant calls be made to the same actor. `entitiesConfig` | Array of entity configurations that allow per actor type settings. Any configuration defined here must have an entity that maps back into the root level entities. + +{{% alert title="Note" color="primary" %}} +Actor settings in configuration for timeouts and intervals use [time.ParseDuration](https://pkg.go.dev/time#ParseDuration) format. You can use string formats to represent durations. For example: +- `1h30m` or `1.5h`: A duration of 1 hour and 30 minutes +- `1d12h`: A duration of 1 day and 12 hours +- `500ms`: A duration of 500 milliseconds +- `-30m`: A negative duration of 30 minutes + +{{% /alert %}} + ```json { "entities":["actorType1", "actorType2"],