Skip to content

Commit 6c7a276

Browse files
committed
deprecation dates fix
1 parent bbcdbf5 commit 6c7a276

File tree

2 files changed

+11
-11
lines changed

2 files changed

+11
-11
lines changed

graph/GuidelinesGraph.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -205,8 +205,8 @@ Limitations of \$query requests made to Microsoft Graph:
205205

206206
### Resource Modeling Patterns
207207

208-
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.
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.
208+
You can model structured 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.
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, for more information refer to [Microsoft REST API Guidelines](https://github.com/microsoft/api-guidelines/blob/graph/Guidelines.md#93-collection-url-patterns). Complex types are better suited to represent composite properties of API entities.
210210

211211
```XML
212212
<EntityType Name="Author">
@@ -384,7 +384,7 @@ breaking change.
384384
- Addition of a required request header
385385
- Addition of a EnumType members for non-evolvable enumerations
386386
- Addition of a Nullable="false" properties to existing types
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
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
388388
- 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
389389
- Changes to top-level error codes
390390
- Introduction of server-side pagination to existing collections

graph/deprecation.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,11 +21,11 @@ to annotate any usages of that type.
2121
<Annotation Term="Org.OData.Core.V1.Revisions">
2222
<Collection>
2323
<Record>
24-
<PropertyValue Property = "Date" Date="2020-08-20"/>
25-
<PropertyValue Property = "Version" String="2020-08/Tasks_And_Plans"/>
24+
<PropertyValue Property = "Date" Date="2022-03-30"/>
25+
<PropertyValue Property = "Version" String="2022-03/Tasks_And_Plans"/>
2626
<PropertyValue Property = "Kind" EnumMember="Org.OData.Core.V1.RevisionKind/Deprecated"/>
27-
<PropertyValue Property = "Description" String="The Outlook tasks API is deprecated and will stop returning data on August 20, 2022. Please use the new To Do API."/>
28-
<PropertyValue Property = "RemovalDate" Date="2022-08-20"/>
27+
<PropertyValue Property = "Description" String="The Outlook tasks API is deprecated and will stop returning data on June 30, 2024. Please use the new To Do API."/>
28+
<PropertyValue Property = "RemovalDate" Date="2024-06-30"/>
2929
</Record>
3030
</Collection>
3131
</Annotation>
@@ -35,13 +35,13 @@ to annotate any usages of that type.
3535

3636
When the request URL contains a reference to a deprecated model element, the gateway will add a [Deprecation
3737
header](https://tools.ietf.org/html/draft-dalal-deprecation-header-02) (with the
38-
date the element was marked as deprecated) and a Sunset header (with the date 2
38+
date the element was marked as deprecated) and a Sunset header (with the date of 2
3939
years beyond the Deprecation date) to the response.
4040

4141
**Deprecation header example:**
4242

4343
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
44-
Deprecation: Thursday, 30 June 2022 11:59:59 GMT
45-
Sunset: Wed, 30 Mar 2022 23:59:59 GMT
46-
Link: https://docs.microsoft.com/en-us/graph/changelog#2022-03-30_name ; rel="deprecation"; type="text/html"; title="name",https://docs.microsoft.com/en-us/graph/changelog#2020-06-30_state ; rel="deprecation"; type="text/html"; title="state"
44+
Deprecation: Wed, 30 Mar 2022 11:59:59 GMT
45+
Sunset: Thursday, 30 June 2024 23:59:59 GMT
46+
Link: https://docs.microsoft.com/en-us/graph/changelog#2022-03-30_name ; rel="deprecation"; type="text/html"; title="name",https://docs.microsoft.com/en-us/graph/changelog#2022-03-30_state ; rel="deprecation"; type="text/html"; title="state"
4747
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

0 commit comments

Comments
 (0)