Skip to content

Commit 8096615

Browse files
committed
problem update
1 parent 0cdfbd0 commit 8096615

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

graph/patterns/operations.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,16 @@
22

33
Microsoft Graph API Design Pattern
44

5-
*The operations pattern provides the ability to model a change that impacts multiple resources and can't be effectively modeled by using HTTP methods.*
5+
*The operations pattern provides the ability to model a change that might impact multiple resources and can't be effectively modeled by using HTTP methods.*
66

77
## Problem
88

9-
Sometimes when modeling a complex business domain, API designers need to model a business operation that effects multiple resources and needs to be performed as a single unit. Modeling the operation via HTTP methods on each individual resource might be either ineffective or not reflect how it's processed by the backend service. In addition, the operation might produce observable side effects.
9+
Sometimes when modeling a complex business domain, API designers need to model a business operation that effects one or multiple resources and has additional semantic meaning that cannot be expressed by HTTP methods. Modeling the operation via HTTP methods on each individual resource might be either ineffective or expose internal implementation details. In addition, the operation might produce observable side effects.
1010

1111
## Solution
1212

13-
To address these use cases, API designers might use operational resources such as functions or actions.
14-
If the operation doesn't have any side effects and MUST return a single instance of a type or a collection of instances, then the designer SHOULD use the OData function; otherwise, the designer can model the operation as an action.
13+
To address these use cases, API designers can use operational resources such as functions or actions.
14+
If the operation doesn't have any side effects and MUST return a single instance of a type or a collection of instances, then the designer SHOULD use OData functions; otherwise, the designer can model the operation as an action.
1515

1616
## When to use this pattern
1717

0 commit comments

Comments
 (0)