microsoftgraph / microsoftgraph/msgraph-metadata
`Delta` functions should have `Deltatoken` query parameter
Open
@irvinesunday is already working on this.
Since Jul 12, 2023.
Area: Annotations
Area: odata-to-openapi
Needs: Directive
Needs: Investigation
priority:p1
- Dominant language
- XSLT
- Stars
- 166
- Forks
- 55
- Avg merge
- 16h 12m
- Merged PRs (30d)
- 14
Description
All Delta functions should have Deltatoken query parameter via CustomQueryOptions as described in the API reference at https://learn.microsoft.com/en-us/graph/delta-query-users?tabs=http#deltalink-request. Deltatoken is used to get to pass the deltaToken from the last response, you'll get changes (additions, deletions, or updates) to resource since the last request.
OData capability annotations allows for:
<Term Name="OperationRestrictions" Type="Capabilities.OperationRestrictionsType" Nullable="false" AppliesTo="Action Function">
<Annotation Term="Core.Description" String="Restrictions for function or action operation"/>
</Term>
<ComplexType Name="OperationRestrictionsType">
<Property Name="FilterSegmentSupported" Type="Edm.Boolean" Nullable="false" DefaultValue="true">
<Annotation Term="Core.Description" String="Bound action or function can be invoked on a collection-valued binding parameter path with a `/$filter(...)` segment"/>
</Property>
<Property Name="Permissions" Type="Collection(Capabilities.PermissionType)" Nullable="true">
<Annotation Term="Core.Description" String="Required permissions. One of the specified sets of scopes is required to invoke an action or function"/>
</Property>
<Property Name="CustomHeaders" Type="Collection(Capabilities.CustomParameter)" Nullable="false">
<Annotation Term="Core.Description" String="Supported or required custom headers"/>
</Property>
<Property Name="CustomQueryOptions" Type="Collection(Capabilities.CustomParameter)" Nullable="false">
<Annotation Term="Core.Description" String="Supported or required custom query options"/>
</Property>
<Property Name="ErrorResponses" Type="Collection(Capabilities.HttpResponse)" Nullable="false">
<Annotation Term="Core.Description" String="Possible error responses returned by the request."/>
</Property>
</ComplexType>
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.