mirror of https://github.com/dapr/docs.git
Merge pull request #3439 from hhunter-ms/issue_2766
[actor runtime config] Add note for timeouts and intervals format
This commit is contained in:
commit
f8ea187507
|
@ -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
|
||||
|
|
|
@ -187,7 +187,7 @@ Creates a persistent reminder for an actor.
|
|||
POST/PUT http://localhost:<daprPort>/v1.0/actors/<actorType>/<actorId>/reminders/<name>
|
||||
```
|
||||
|
||||
#### 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:<daprPort>/v1.0/actors/<actorType>/<actorId>/timers/<name>
|
||||
```
|
||||
|
||||
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"],
|
||||
|
|
Loading…
Reference in New Issue