Skip to content

Commit 6f60f06

Browse files
authored
Apply mx-tableFixed formatting to supported resources for subscriptions (#28552)
* Apply mx-tableFixed formatting to supported resources for subscriptions * Fix list & suppressions
1 parent 53c9b96 commit 6f60f06

4 files changed

Lines changed: 71 additions & 49 deletions

File tree

api-reference/beta/resources/change-notifications-api-overview.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,3 +72,13 @@ In general, subscription operations require read permission to the resource. For
7272
[callTranscript]: ./calltranscript.md
7373
[callRecording]: ./callrecording.md
7474
[approvals]: ./approvalitem.md
75+
76+
<!-- {
77+
"type": "#page.annotation",
78+
"description": "",
79+
"keywords": "",
80+
"section": "documentation",
81+
"suppressions": [
82+
"Error: /resources/change-notifications-api-overview.md:\n Exception processing links.\n Link Definition was null. Link text: !div class='mx-tableFixed' (Parameter 'Definition')"
83+
]
84+
} -->

api-reference/v1.0/resources/change-notifications-api-overview.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,4 +23,14 @@ The Microsoft Graph REST API can deliver change notifications to clients through
2323
- [subscription resource type](./subscription.md)
2424
- [Lifecycle notifications](/graph/change-notifications-lifecycle-events)
2525
- [Change notification C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-change-notification/csharp)
26-
- [Change notification Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-change-notification/nodejs)
26+
- [Change notification Node.js sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/graph-change-notification/nodejs)
27+
28+
<!-- {
29+
"type": "#page.annotation",
30+
"description": "",
31+
"keywords": "",
32+
"section": "documentation",
33+
"suppressions": [
34+
"Error: /resources/change-notifications-api-overview.md:\n Exception processing links.\n Link Definition was null. Link text: !div class='mx-tableFixed' (Parameter 'Definition')"
35+
]
36+
} -->

concepts/includes/change-notifications-rich-notifications-supported-resources.md

Lines changed: 16 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -15,21 +15,22 @@ Rich notifications are available for the following resources.
1515
> [!NOTE]
1616
> Rich notifications for subscriptions to endpoints marked with an asterisk (*) are only available on the `/beta` endpoint.
1717
18-
| Resource | Supported resource paths | Limitations |
19-
|--|--|--|
20-
| Copilot [aiInteraction][] | Copilot AI interactions that a particular user is part of: `copilot/users/{userId}/interactionHistory/getAllEnterpriseInteractions` <br><br> Copilot AI interactions in an organization: `copilot/interactionHistory/getAllEnterpriseInteractions` | Maximum subscription quotas: <li> Per app and tenant combination (for subscriptions tracking AI interactions across a tenant): 1 <li> Per app and user combination (for subscriptions tracking AI interactions a particular user is part of): 1 <li> Per user (for subscriptions tracking AI interactions a particular user is part of): 10 subscriptions. <li> Per organization: 10,000 total subscriptions. |
21-
| Outlook [event][] | Changes to all events in a user's mailbox: `/users/{id}/events` | Requires `$select` to return only a subset of properties in the rich notification. For more information, see [Change notifications for Outlook resources](/graph/outlook-change-notifications-overview). |
22-
| Outlook [message][] | Changes to all messages in a user's mailbox: `/users/{id}/messages` <br/><br/>Changes to messages in a user's inbox: `/users/{id}/mailFolders/{id}/messages` | Requires `$select` to return only a subset of properties in the rich notification. For more information, see [Change notifications for Outlook resources](/graph/outlook-change-notifications-overview). |
23-
| Outlook personal [contact][] | Changes to all personal contacts in a user's mailbox: `/users/{id}/contacts` <br/><br/>Changes to all personal contacts in a user's contactFolder: `/users/{id}/contactFolders/{id}/contacts`| Requires `$select` to return only a subset of properties in the rich notification. For more information, see [Change notifications for Outlook resources](/graph/outlook-change-notifications-overview). |
24-
| Teams [callRecording][] | All recordings in an organization: `communications/onlineMeetings/getAllRecordings` <br><br> All recordings for a specific meeting: `communications/onlineMeetings/{onlineMeetingId}/recordings` <br><br> A call recording that becomes available in a meeting organized by a specific user: `users/{id}/onlineMeetings/getAllRecordings` <br><br> A call recording that becomes available in a meeting where a particular Teams app is installed: `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings` * | Maximum subscription quotas: <li> Per app and online-meeting combination: 1 <li> Per app and user combination: 1 <li> Per user (for subscriptions tracking recordings in all onlineMeetings organized by the user): 10 subscriptions. <li> Per organization: 10,000 total subscriptions. |
25-
| Teams [callTranscript][] | All transcripts in an organization: `communications/onlineMeetings/getAllTranscripts` <br><br> All transcripts for a specific meeting: `communications/onlineMeetings/{onlineMeetingId}/transcripts` <br><br> A call transcript that becomes available in a meeting organized by a specific user: `users/{id}/onlineMeetings/getAllTranscripts` <br><br> A call transcript that becomes available in a meeting where a particular Teams app is installed: `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts` * | Maximum subscription quotas: <li> Per app and online-meeting combination: 1 <li> Per app and user combination: 1 <li> Per user (for subscriptions tracking transcripts in all onlineMeetings organized by the user): 10 subscriptions. <li> Per organization: 10,000 total subscriptions. |
26-
| Teams [channel][] | Changes to channels in all teams: `/teams/getAllChannels`<br/><br/>Changes to channel in a specific team: `/teams/{id}/channels` | - |
27-
| Teams [chat][] | Changes to any chat in the tenant: `/chats`<br/><br/>Changes to a specific chat: `/chats/{id}` | - |
28-
| Teams [chatMessage][] | Changes to chat messages in all channels in all teams: `/teams/getAllMessages`<br/><br/>Changes to chat messages in a specific channel: `/teams/{id}/channels/{id}/messages`<br/><br/>Changes to chat messages in all chats: `/chats/getAllMessages`<br/><br/>Changes to chat messages in a specific chat: `/chats/{id}/messages`<br/><br/>Changes to chat messages in all chats a particular user is part of: `/users/{id}/chats/getAllMessages` | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. |
29-
| Teams [conversationMember][] | Changes to membership in a specific team: `/teams/{id}/members`<br/><br/> Changes to membership in all teams across the tenant: `/teams/getAllMembers`<br/><br/>Changes to membership in all channels under a specific team: `/teams/{id}/channels/getAllMembers`<br/><br/>Changes to membership for all channels across the entire tenant: `/teams/getAllChannels/getAllMembers`<br/><br/>Changes to membership in a specific chat: `/chats/{id}/members` <br/><br/>Changes to membership for all Teams chats: `/chats/getAllMembers` | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. |
30-
| Teams [onlineMeeting][] * | Changes to an online meeting: `/communications/onlineMeetings(joinWebUrl='{encodedJoinWebUrl}')/meetingCallEvents` * | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. One subscription allowed per application per online meeting. For more information, see [Get change notifications for Microsoft Teams meeting call event updates](/graph/changenotifications-for-onlinemeeting). |
31-
| Teams [presence][] | Changes to a single user's presence: `/communications/presences/{id}` <br><br> Changes to multiple users' presence: `/communications/presences?$filter=id in ({id},{id}...)` | The subscription for multiple users' presence is limited to 650 distinct users. Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. One subscription allowed per application per delegated user. For more information, see [Get change notifications for presence updates in Microsoft Teams](/graph/changenotifications-for-presence). |
32-
| Teams [team][] | Changes to any team in the tenant: `/teams`<br/><br/>Changes to a specific team: `/teams/{id}` | - |
18+
> [!div class="mx-tableFixed"]
19+
> | Resource | Supported resource paths | Limitations |
20+
> |--|--|--|
21+
> | Copilot [aiInteraction][] | Copilot AI interactions that a particular user is part of: `copilot/users/{userId}/interactionHistory/getAllEnterpriseInteractions` <br><br> Copilot AI interactions in an organization: `copilot/interactionHistory/getAllEnterpriseInteractions` | Maximum subscription quotas: <ul><li> Per app and tenant combination (for subscriptions tracking AI interactions across a tenant): 1</li> <li> Per app and user combination (for subscriptions tracking AI interactions a particular user is part of): 1</li> <li> Per user (for subscriptions tracking AI interactions a particular user is part of): 10 subscriptions.</li> <li> Per organization: 10,000 total subscriptions.</li></ul> |
22+
> | Outlook [event][] | Changes to all events in a user's mailbox: `/users/{id}/events` | Requires `$select` to return only a subset of properties in the rich notification. For more information, see [Change notifications for Outlook resources](/graph/outlook-change-notifications-overview). |
23+
> | Outlook [message][] | Changes to all messages in a user's mailbox: `/users/{id}/messages` <br/><br/>Changes to messages in a user's inbox: `/users/{id}/mailFolders/{id}/messages` | Requires `$select` to return only a subset of properties in the rich notification. For more information, see [Change notifications for Outlook resources](/graph/outlook-change-notifications-overview). |
24+
> | Outlook personal [contact][] | Changes to all personal contacts in a user's mailbox: `/users/{id}/contacts` <br/><br/>Changes to all personal contacts in a user's contactFolder: `/users/{id}/contactFolders/{id}/contacts`| Requires `$select` to return only a subset of properties in the rich notification. For more information, see [Change notifications for Outlook resources](/graph/outlook-change-notifications-overview). |
25+
> | Teams [callRecording][] | All recordings in an organization: `communications/onlineMeetings/getAllRecordings` <br><br> All recordings for a specific meeting: `communications/onlineMeetings/{onlineMeetingId}/recordings` <br><br> A call recording that becomes available in a meeting organized by a specific user: `users/{id}/onlineMeetings/getAllRecordings` <br><br> A call recording that becomes available in a meeting where a particular Teams app is installed: `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings` * | Maximum subscription quotas: <ul><li> Per app and online-meeting combination: 1</li> <li> Per app and user combination: 1</li> <li> Per user (for subscriptions tracking recordings in all onlineMeetings organized by the user): 10 subscriptions.</li> <li> Per organization: 10,000 total subscriptions.</li></ul> |
26+
> | Teams [callTranscript][] | All transcripts in an organization: `communications/onlineMeetings/getAllTranscripts` <br><br> All transcripts for a specific meeting: `communications/onlineMeetings/{onlineMeetingId}/transcripts` <br><br> A call transcript that becomes available in a meeting organized by a specific user: `users/{id}/onlineMeetings/getAllTranscripts` <br><br> A call transcript that becomes available in a meeting where a particular Teams app is installed: `appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTrancripts` * | Maximum subscription quotas: <ul><li> Per app and online-meeting combination: 1</li> <li> Per app and user combination: 1</li> <li> Per user (for subscriptions tracking transcripts in all onlineMeetings organized by the user): 10 subscriptions.</li> <li> Per organization: 10,000 total subscriptions.</li></ul> |
27+
> | Teams [channel][] | Changes to channels in all teams: `/teams/getAllChannels`<br/><br/>Changes to channel in a specific team: `/teams/{id}/channels` | - |
28+
> | Teams [chat][] | Changes to any chat in the tenant: `/chats`<br/><br/>Changes to a specific chat: `/chats/{id}` | - |
29+
> | Teams [chatMessage][] | Changes to chat messages in all channels in all teams: `/teams/getAllMessages`<br/><br/>Changes to chat messages in a specific channel: `/teams/{id}/channels/{id}/messages`<br/><br/>Changes to chat messages in all chats: `/chats/getAllMessages`<br/><br/>Changes to chat messages in a specific chat: `/chats/{id}/messages`<br/><br/>Changes to chat messages in all chats a particular user is part of: `/users/{id}/chats/getAllMessages` | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. |
30+
> | Teams [conversationMember][] | Changes to membership in a specific team: `/teams/{id}/members`<br/><br/> Changes to membership in all teams across the tenant: `/teams/getAllMembers`<br/><br/>Changes to membership in all channels under a specific team: `/teams/{id}/channels/getAllMembers`<br/><br/>Changes to membership for all channels across the entire tenant: `/teams/getAllChannels/getAllMembers`<br/><br/>Changes to membership in a specific chat: `/chats/{id}/members` <br/><br/>Changes to membership for all Teams chats: `/chats/getAllMembers` | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. |
31+
> | Teams [onlineMeeting][] * | Changes to an online meeting: `/communications/onlineMeetings(joinWebUrl='{encodedJoinWebUrl}')/meetingCallEvents` * | Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. One subscription allowed per application per online meeting. For more information, see [Get change notifications for Microsoft Teams meeting call event updates](/graph/changenotifications-for-onlinemeeting). |
32+
> | Teams [presence][] | Changes to a single user's presence: `/communications/presences/{id}` <br><br> Changes to multiple users' presence: `/communications/presences?$filter=id in ({id},{id}...)` | The subscription for multiple users' presence is limited to 650 distinct users. Doesn't support using `$select` to return only selected properties. The rich notification consists of all the properties of the changed instance. One subscription allowed per application per delegated user. For more information, see [Get change notifications for presence updates in Microsoft Teams](/graph/changenotifications-for-presence). |
33+
> | Teams [team][] | Changes to any team in the tenant: `/teams`<br/><br/>Changes to a specific team: `/teams/{id}` | - |
3334
3435
[aiInteraction]: /graph/api/resources/aiinteraction
3536
[channel]: /graph/api/resources/channel

0 commit comments

Comments
 (0)