Updates from: 01/22/2021 04:17:06
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscription-delete.md
@@ -35,6 +35,7 @@ Depending on the resource and the permission type (delegated or application) req
|[list](../resources/list.md) | Sites.ReadWrite.All | Not supported | Sites.ReadWrite.All | |[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | |[presence](../resources/presence.md) | Presence.Read.All | Not supported | Not supported |
+|[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All |
|[printTaskDefinition](../resources/printtaskdefinition.md) | Not supported | Not supported | PrintTaskDefinition.ReadWrite.All | |[security alert](../resources/alert.md) | SecurityEvents.ReadWrite.All | Not supported | SecurityEvents.ReadWrite.All | |[todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
@@ -50,6 +51,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note:** `/teams/getAllMessages` and `/chats/getAllMessages` are available to users that have the  [required licenses](https://aka.ms/teams-changenotification-licenses).
+In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscription-get.md
@@ -4,7 +4,7 @@ description: "Retrieve the properties and relationships of a subscription."
localization_priority: Normal author: "davidmu1" doc_type: apiPageType
-ms.prod: ""
+ms.prod: "change-notifications"
--- # Get subscription
@@ -35,6 +35,7 @@ Depending on the resource and the permission type (delegated or application) req
|[list](../resources/list.md) | Sites.ReadWrite.All | Not supported | Sites.ReadWrite.All | |[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | |[presence](../resources/presence.md) | Presence.Read.All | Not supported | Not supported |
+|[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All |
|[printTaskDefinition](../resources/printtaskdefinition.md) | Not supported | Not supported | PrintTaskDefinition.ReadWrite.All | |[security alert](../resources/alert.md) | SecurityEvents.ReadWrite.All | Not supported | SecurityEvents.ReadWrite.All | |[todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
@@ -50,6 +51,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note:** `/teams/getAllMessages` and `/chats/getAllMessages` are available to users that have the  [required licenses](https://aka.ms/teams-changenotification-licenses).
+In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-post-subscriptions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscription-post-subscriptions.md
@@ -4,7 +4,7 @@ description: "Subscribes a listener application to receive change notifications
localization_priority: Normal author: "davidmu1" doc_type: apiPageType
-ms.prod: ""
+ms.prod: "change-notifications"
--- # Create subscription
@@ -37,6 +37,7 @@ Creating a subscription requires read permission to the resource. For example, t
|[list](../resources/list.md) | Sites.ReadWrite.All | Not supported | Sites.ReadWrite.All | |[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | |[presence](../resources/presence.md) | Presence.Read.All | Not supported | Not supported |
+|[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All |
|[printTaskDefinition](../resources/printtaskdefinition.md) | Not supported | Not supported | PrintTaskDefinition.ReadWrite.All | |[security alert](../resources/alert.md) | SecurityEvents.ReadWrite.All | Not supported | SecurityEvents.ReadWrite.All | |[todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
@@ -52,6 +53,7 @@ Creating a subscription requires read permission to the resource. For example, t
> **Note:** `/teams/getAllMessages` and `/chats/getAllMessages` are available to users that have the  [required licenses](https://aka.ms/teams-changenotification-licenses).
+In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
> **Note:** `/chats/getAllMessages` only returns messages from chats owned by the tenant. If a chat thread is initiated by a user outside the tenant, that chat thread is not owned by the tenant, and does not create change notifications.
@@ -161,6 +163,7 @@ The following are valid values for the resource property.
|[List](../resources/list.md)|`sites/{site-id}/lists/{list-id}`| |[Mail](../resources/message.md)|`me/mailfolders('inbox')/messages`, `me/messages`| |[Presence](../resources/presence.md)| `/communications/presences/{id}` (single user), `/communications/presences?$filter=id in ({id},{id}…)` (multiple users)|
+|[printer](../resources/printer.md) |`print/printers/{id}/jobs`|
|[PrintTaskDefinition](../resources/printtaskdefinition.md)|`print/taskDefinitions/{id}/tasks`| |[Users](../resources/user.md)|`users`| |[todoTask](../resources/todotask.md) | `/me/todo/lists/{todoTaskListId}/tasks`
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscription-update.md
@@ -4,7 +4,7 @@ description: "Renew a subscription by extending its expiry time."
localization_priority: Normal author: "davidmu1" doc_type: apiPageType
-ms.prod: ""
+ms.prod: "change-notifications"
--- # Update subscription
@@ -37,6 +37,7 @@ Depending on the resource and the permission type (delegated or application) req
|[list](../resources/list.md) | Sites.ReadWrite.All | Not supported | Sites.ReadWrite.All | |[message](../resources/message.md) | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | |[presence](../resources/presence.md) | Presence.Read.All | Not supported | Not supported |
+|[printer](../resources/printer.md) | Not supported | Not supported | Printer.Read.All, Printer.ReadWrite.All |
|[printTaskDefinition](../resources/printtaskdefinition.md) | Not supported | Not supported | PrintTaskDefinition.ReadWrite.All | |[security alert](../resources/alert.md) | SecurityEvents.ReadWrite.All | Not supported | SecurityEvents.ReadWrite.All | |[todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
@@ -52,6 +53,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note:** `/teams/getAllMessages` and `/chats/getAllMessages` are available to users that have the  [required licenses](https://aka.ms/teams-changenotification-licenses).
+In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/team-list-installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-list-installedapps.md
@@ -11,6 +11,8 @@ doc_type: apiPageType
Namespace: microsoft.graph
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+ Retrieve the list of [apps installed](../resources/teamsappinstallation.md) in the specified [team](../resources/team.md). ## Permissions
v1.0 https://docs.microsoft.com/en-us/graph/api/user-list-transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-transitivememberof.md
@@ -153,10 +153,9 @@ The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: text/plain
-```
893-
+```
### Example 3: Use OData cast to get only a count of transitive membership in groups
@@ -186,10 +185,9 @@ The following is an example of the response.
```http HTTP/1.1 200 OK Content-type: text/plain
-```
588-
+```
### Example 4: Use $search and OData cast to get transitive membership in groups with display names that contain the letters 'tier' including a count of returned objects
v1.0 https://docs.microsoft.com/en-us/graph/resources/directoryaudit https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/directoryaudit.md
@@ -31,7 +31,7 @@ Represents the directory audit items and its collection.
| additionalDetails | [keyValue](keyvalue.md) collection | Indicates additional details on the activity. | | category | String | Indicates which resource category that's targeted by the activity. (For example: User Management, Group Management etc..) | | correlationId | GUID | Indicates a unique ID that helps correlate activities that span across various services. Can be used to trace logs across services. |
-| id | String | Indicates the unique ID for the activity. This is a GUID. |
+| id | String | Indicates the unique ID for the activity. |
| initiatedBy | [auditActivityInitiator](auditactivityinitiator.md) | Indicates information about the user or app initiated the activity. | | loggedByService | String | Indicates information on which service initiated the activity (For example: Self-service Password Management, Core Directory, B2C, Invited Users, Microsoft Identity Manager, Privileged Identity Management. | | result | string | Indicates the result of the activity. Possible values are: `success`, `failure`, `timeout`, `unknownFutureValue`. |
v1.0 https://docs.microsoft.com/en-us/graph/resources/printer https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/printer.md
@@ -3,7 +3,7 @@ title: printer resource type
description: Represents a physical printer device that has been registered with the Universal Print service. Printer resources can be used to manage print jobs, printer settings, printer metadata and registration status. author: braedenp-msft localization_priority: Normal
-ms.prod: universal-print
+ms.prod: cloud-printing
doc_type: resourcePageType ---
@@ -15,6 +15,9 @@ Namespace: microsoft.graph
Represents a printer device that has been registered with the Universal Print service. Printer resources can be used to manage print jobs, printer settings, printer metadata and registration status.
+This resource supports:
+* [Subscribing to change notifications](/graph/universal-print-webhook-notifications).
+ ## Methods | Method | Return Type | Description |
v1.0 https://docs.microsoft.com/en-us/graph/resources/printtaskdefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/printtaskdefinition.md
@@ -3,7 +3,7 @@ title: printTaskDefinition resource type
description: Represents a task that can be triggered when various events occur within Universal Print. author: braedenp-msft localization_priority: Normal
-ms.prod: universal-print
+ms.prod: cloud-printing
doc_type: resourcePageType ---
@@ -17,6 +17,9 @@ Represents an abstract definition for a task that can be triggered when various
For details about how to use this resource to add pull printing support to Universal Print, see [Extending Universal Print to support pull printing](/graph/universal-print-concept-overview#extending-universal-print-to-support-pull-printing).
+This resource supports:
+* [Subscribing to change notifications](/graph/universal-print-webhook-notifications).
+ ## Methods | Method | Return Type | Description |
v1.0 https://docs.microsoft.com/en-us/graph/resources/regionalandlanguagesettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/regionalandlanguagesettings.md
@@ -44,11 +44,11 @@ The following is a JSON definition of the resource.
```json { "defaultDisplayLanguage": {"@odata.type":"microsoft.graph.localeInfo"},
- "authoringLanguages":[{"@odata.type":"microsoft.graph.localeInfo"}] ,
+ "authoringLanguages": [{"@odata.type":"microsoft.graph.localeInfo"}],
"defaultTranslationLanguage": {"@odata.type":"microsoft.graph.localeInfo"}, "defaultSpeechInputLanguage": {"@odata.type":"microsoft.graph.localeInfo"},
- "defaultRegionalFormat":{"@odata.type":"microsoft.graph.localeInfo"} ,
- "regionalFormatOverrides":{"@odata.type":"microsoft.graph.regionalFormatOverrides"}
+ "defaultRegionalFormat": {"@odata.type":"microsoft.graph.localeInfo"},
+ "regionalFormatOverrides": {"@odata.type":"microsoft.graph.regionalFormatOverrides"}
} ``` <!-- {
v1.0 https://docs.microsoft.com/en-us/graph/resources/subscription https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/subscription.md
@@ -4,7 +4,7 @@ description: "A subscription allows a client app to receive change notifications
localization_priority: Normal author: "davidmu1" doc_type: resourcePageType
-ms.prod: ""
+ms.prod: "change-notifications"
--- # subscription resource type
@@ -24,6 +24,7 @@ A subscription allows a client app to receive change notifications about changes
- A [message][], [event][], or [contact][] in Outlook - The [presence][] of a user in Microsoft Teams - A [user][] or [group][] in Azure Active Directory
+- A [printer][] in Print Service (when a print job for the printer gets to JobFetchable state - ready to be fetched for printing).
- A [printTaskDefinition][] in Print Service - A [todoTask] of a user in Microsoft To Do
@@ -70,6 +71,7 @@ See [Use the Microsoft Graph API to get change notifications](webhooks.md) for t
| Outlook **message**, **event**, **contact** | 4230 minutes (under 3 days) | | **user**, **group**, other directory resources | 4230 minutes (under 3 days) | | **presence** | 60 minutes (1 hour) |
+| Print **printer** | 4230 minutes (under 3 days) |
| Print **printTaskDefinition** | 4230 minutes (under 3 days) | | **todoTask** | 4230 minutes (under 3 days) |
@@ -136,6 +138,7 @@ Here is a JSON representation of the resource.
[chatMessage]: ./chatmessage.md [callRecord]: ./callrecords-callrecord.md [presence]: ./presence.md
+[printer]: ./printer.md
[printTaskDefinition]: ./printtaskdefinition.md [todoTask]: ./todotask.md
v1.0 https://docs.microsoft.com/en-us/graph/resources/unifiedrolepermission https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/unifiedrolepermission.md
@@ -48,8 +48,8 @@ For example: `microsoft.directory/applications/credentials/update`.
### condition property Conditions define constraints that must be met. For example, a requirement that the principal be an "owner" of the target. The following are the supported conditions: -- Self: "@Subject.objectId == @Resource.objectId"-- Owner: "@Subject.objectId Any_of @Resource.owners"
+- Self: "$ResourceIsSelf"
+- Owner: "$SubjectIsOwner"
The following is an example of a role permission with a condition.
@@ -60,7 +60,7 @@ The following is an example of a role permission with a condition.
"microsoft.directory/applications/basic/update", "microsoft.directory/applications/credentials/update" ],
- "condition": "$ResourceIsSelf"
+ "condition": "$SubjectIsOwner"
} ]
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/subscription-delete.md
@@ -43,6 +43,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note:** `/teams/getAllMessages` and `/chats/getAllMessages` are available to users that have the  [required licenses](https://aka.ms/teams-changenotification-licenses).
+In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/subscription-get.md
@@ -43,6 +43,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note:** `/teams/getAllMessages` and `/chats/getAllMessages` are available to users that have the  [required licenses](https://aka.ms/teams-changenotification-licenses).
+In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-post-subscriptions https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/subscription-post-subscriptions.md
@@ -48,6 +48,7 @@ Subscribes a listener application to receive change notifications when the reque
> **Note:** `/chats/getAllMessages` only returns messages from chats owned by the tenant. If a chat thread is initiated by a user outside the tenant, that chat thread is not owned by the tenant, and does not create change notifications.
+In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/api/subscription-update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/subscription-update.md
@@ -45,6 +45,7 @@ Depending on the resource and the permission type (delegated or application) req
> **Note:** `/teams/getAllMessages` and `/chats/getAllMessages` are available to users that have the  [required licenses](https://aka.ms/teams-changenotification-licenses).
+In the future, Microsoft may require you or your customers to pay additional fees based on the amount of data accessed through the API.
### driveItem
v1.0 https://docs.microsoft.com/en-us/graph/resources/application https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/application.md
@@ -22,7 +22,7 @@ This resource supports using [delta query](/graph/delta-query-overview) to track
|[List applications](../api/application-list.md) | [application](application.md) collection | Retrieve the list of applications in the organization. | |[Create application](../api/application-post-applications.md) | [application](application.md) | Creates (registers) a new application.| |[Get application](../api/application-get.md) | [application](application.md) |Read properties and relationships of application object.|
-|[Update application](../api/application-update.md) | [application](application.md) |Update application object. |
+|[Update application](../api/application-update.md) | None |Update application object. |
|[Delete application](../api/application-delete.md) | None |Delete application object. | |[Get delta](../api/application-delta.md)|[application](application.md)|Get newly created, updated, or deleted applications without performing a full read of the entire resource collection.| |[List deleted applications](../api/directory-deleteditems-list.md) | [directoryObject](directoryobject.md) collection | Retrieve a list of recently deleted applications. |