Skip to content

Commit 1f3d11e

Browse files
committed
use primary key
1 parent ba51283 commit 1f3d11e

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

graph/patterns/alternate-key.md

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

33
Microsoft Graph API Design Pattern
44

5-
_The Alternate Key Pattern provides the ability to query for a single, specific resource identifiable through an alternative property (called key) that is not its unique identifier_
5+
_The Alternate Key Pattern provides the ability to query for a single, specific resource identifiable through an alternative property (called key) that is not its primary key_
66

77
## Problem
88

99
---
1010

11-
The resources exposed in Graph are identified by an [UUID (Universally Unique Identifier)](https://en.wikipedia.org/wiki/Universally_unique_identifier) - which guarantees uniqueness inside the same resource type. Often though, that same resource can also be uniquely identified by an alternative, more convenient property that provides a better developer experience.
11+
The resources exposed in Graph are identified through a Primary Key - which guarantees uniqueness inside the same resource type. Often though, that same resource can also be uniquely identified by an alternative, more convenient property (or set of properties) that provides a better developer experience.
1212

1313
Take a look at the `user` resource: while the `id` remains a perfectly valid way to get the resource details, the `mail` address is also an unique property that could be used to identify it.
1414

@@ -102,7 +102,7 @@ GET https://graph.microsoft.com/v1.0/users/?$filter=(ssn eq '123-45-6789')
102102
}
103103
```
104104

105-
2. Get a specific resource through the unique identifier, and then through the two alternate keys:
105+
2. Get a specific resource through its primary key, and then through the two alternate keys:
106106

107107
```http
108108
GET https://graph.microsoft.com/v1.0/users/1a89ade6-9f59-4fea-a139-23f84e3aef66

0 commit comments

Comments
 (0)