Skip to content

Commit bbcdbf5

Browse files
committed
updated beta to v1.0
1 parent fd1d240 commit bbcdbf5

File tree

2 files changed

+6
-5
lines changed

2 files changed

+6
-5
lines changed

graph/GuidelinesGraph.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -184,7 +184,8 @@ Guidelines](https://github.com/microsoft/api-guidelines/blob/master/Guidelines.m
184184
| :ballot_box_with_check: **SHOULD** support \$filter with eq, ne operations on properties of entities for collections|
185185
| :heavy_check_mark: **MUST** support [server-side pagination](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_ServerDrivenPaging) using a [nextLink](http://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_ControlInformationnextLinkodatanextL) for collections |
186186
| :ballot_box_with_check: **SHOULD** support pagination $top, $skip and $count for collections |
187-
| :ballot_box_with_check: **SHOULD** sorting with \$orderby both ascending and descending on properties of the entities
187+
| :ballot_box_with_check: **SHOULD** sorting with \$orderby both ascending and descending on properties of the entities |
188+
188189
The query options part of an OData URL can be quite long, potentially exceeding
189190
the maximum length of URLs supported by components involved in transmitting or
190191
processing the request. One way to avoid this is to use the POST verb instead of
@@ -205,7 +206,7 @@ Limitations of \$query requests made to Microsoft Graph:
205206
### Resource Modeling Patterns
206207

207208
You can model complex resources for your APIs using OData Entity Type or Complex Type. The main difference between these types is that Entity type declares a key property to uniquely identify its objects and Complex Type does not. In Microsoft Graph this key property is called "id" for server-created key values. If there is a natural name for the key property then the workload can use that.
208-
Since objects of complex types on Graph don’t have unique identifiers, they are not directly addressable via URIs and therefore you must not use Complex Type to model addressable resources, such as individually addressable resources within a collection. Complex types are better suited to represent composite properties of API entities.
209+
Since objects of complex types on Graph don’t have unique identifiers, they are not directly addressable via URIs and therefore you must not use Complex Type to model addressable resources, such as individually addressable items within a collection. Complex types are better suited to represent composite properties of API entities.
209210

210211
```XML
211212
<EntityType Name="Author">
@@ -383,8 +384,8 @@ breaking change.
383384
- Addition of a required request header
384385
- Addition of a EnumType members for non-evolvable enumerations
385386
- Addition of a Nullable="false" properties to existing types
386-
- Addition of a parameter not marked as Nullable to existing actions or functions
387-
- Addition of a parameter not marked as Optional to an existing function
387+
- Addition of a parameter not marked as [Nullable](http://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/odata-csdl-xml-v4.01.html#sec_Nullable) to existing actions or functions
388+
- Addition of a parameter not marked as [Optional](https://github.com/oasis-tcs/odata-vocabularies/blob/main/vocabularies/Org.OData.Core.V1.md#OptionalParameter) to an existing function
388389
- Changes to top-level error codes
389390
- Introduction of server-side pagination to existing collections
390391
- Significant changes to the performance of APIs such as increased latency, rate limits or concurrency.

graph/patterns/facets.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ The driveItem resource represents a file, folder,image or other item stored in a
6767
API request to get all items from a personal OneDrive will return a heterogenous collection with different facets populated. In the example below there is a folder, a file and an image in the collection. The image entity has two facets populated: file and image.
6868

6969
```
70-
https://graph.microsoft.com/beta/me/drive/root/children
70+
https://graph.microsoft.com/v1.0/me/drive/root/children
7171
7272
Response shortened for readability:
7373

0 commit comments

Comments
 (0)