Skip to content

Commit 2efb1af

Browse files
committed
remove arbitrary querying
1 parent a062dea commit 2efb1af

File tree

1 file changed

+1
-6
lines changed

1 file changed

+1
-6
lines changed

graph/patterns/alternate-key.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -29,12 +29,7 @@ https://graph.microsoft.com/v1.0/users(email='[email protected]') Retrieves the em
2929

3030
---
3131

32-
This pattern works and makes sense when the alternate key is good enough to identify a single resource and provides an useful alternative to the client; while it does not work if the resultset has more than one element.
33-
34-
In such case, the workload has two choices:
35-
36-
1. If the workload defines a list of alternate keys for a resource and the requested key is not there, the workload SHOULD return `422`
37-
2. If the workload does not have a list of alternate keys, it can still query the data source, but if the result yields more than a record, it SHOULD return `422` and encourage the user to use `$filter` rather than returning the first result of the query
32+
This pattern works and makes sense when the alternate key is good enough to identify a single resource and provides an useful alternative to the client; while it does not work if the resultset has more than one element. In such case, the workload SHOULD return `400`
3833

3934
## Example
4035

0 commit comments

Comments
 (0)