Skip to content

Commit ff079f6

Browse files
committed
additional conditions
1 parent 33b109b commit ff079f6

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

graph/patterns/operations.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,13 @@ If the operation doesn't have any side effects and MUST return a single instance
1717

1818
The operations pattern is well suited to use cases that cannot be modeled as a single HTTP method on a resource and require either multiple round trips to complete a single logical operation or produce one or multiple side effects.
1919

20+
The operation pattern might be justified when a modeling operation represents one or combination of the following:
21+
22+
- a change of a resource (i.e., increment the value of a property) rather than a state (i.e., the final value of the property)
23+
- complex processing logic that shouldn't be exposed to the client
24+
- operation parameters might convey a restricted set of option (i.e., a report that can has to specify a date range)
25+
- the operation leverage some service-side data not exposed to (or easily retrieved in context by) the user.
26+
2027
You can consider related patterns such as [long running operations](./long-running-operations.md) and [change tracking](./change-tracking.md).
2128

2229
## Issues and considerations

0 commit comments

Comments
 (0)