Updates from: 06/23/2021 03:14:51
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Cloudpc Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpc-get.md
Content-Type: application/json
"value": { "@odata.type": "#microsoft.graph.cloudPC", "id": "ac74ae8b-85f7-4272-88cc-54192674ffff",
- "displayName": "Display Name value",
- "imageDisplayName": "Image Display Name value",
+ "displayName": "Demo-0",
+ "imageDisplayName": "Windows-10 19h1-evd",
"managedDeviceId": "e87f50c7-fa7f-4687-aade-dd45f3d6ffff",
- "managedDeviceName": "Device Name value",
+ "managedDeviceName": "A00002GI001",
"provisioningPolicyId": "13fa0778-ba00-438a-96d3-488c8602ffff",
- "provisioningPolicyName": "Provisioning Policy Name value",
- "onPremisesConnectionName": "On-premises connection Name value",
+ "provisioningPolicyName": "Marketing provisioning policy",
+ "onPremisesConnectionName": "on-Premises connection for Marketing",
"servicePlanId": "da5615b4-a484-4742-a019-2d52c91cffff", "servicePlanName": "standard", "status": "failed", "statusDetails": { "@odata.type": "microsoft.graph.cloudPcStatusDetails",
- "code": "Sample code",
- "message": "Sample message",
+ "code": "internalServerError",
+ "message": "There was an internal server error. Please contact support xxx.",
"additionalInformation": [ { "@odata.type": "microsoft.graph.keyValuePair",
- "name": "Name value",
- "value": "Sample value"
+ "name": "correlationId",
+ "value": "52367774-cfb7-4e9c-ab51-1b864c31f2d1"
} ] },
- "userPrincipalName": "User Principal Name value",
+ "userPrincipalName": "pmitchell@cpccustomer001.onmicrosoft.com",
"lastModifiedDateTime": "2020-11-03T18:14:34Z",
- "gracePeriodEndDateTime": "Grace Period End Date Time value "
+ "gracePeriodEndDateTime": "2020-11-010T20:00:34Z"
} } ```
v1.0 Cloudpcprovisioningpolicy Assign https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpcprovisioningpolicy-assign.md
POST /deviceManagement/virtualEndpoint/provisioningPolicies/{id}/assign
In the request body, supply a JSON representation of the [cloudPcProvisioningPolicyAssignment](../resources/cloudpcprovisioningpolicyassignment.md) object.
-The following table shows the properties that are required when you create the [cloudPcProvisioningPolicyAssignment](../resources/cloudpcprovisioningpolicyassignment.md).
-
-|Property|Type|Description|
+|Parameter|Type|Description|
|:|:|:|
-|id|String|The ID of the provisioning policy assignment. If target is a user group, then the ID is shown as {policyId}_{groupId}. |
-|target|[cloudPcManagementAssignmentTarget](../resources/cloudpcmanagementassignmenttarget.md)|The assignment target for the provisioning policy. Currently, the only target supported is a user group.|
+|assignments|[cloudPcProvisioningPolicyAssignment](../resources/cloudpcprovisioningpolicyassignment.md) collection | The collection of cloud PC provisioning policy resources each to be assigned to the corresponding target group. Only Microsoft 365 groups and security groups in Azure AD are currently supported. |
## Response
Content-Type: application/json
### Response
-**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true
v1.0 Cloudpcusersetting Assign https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/cloudpcusersetting-assign.md
POST /deviceManagement/virtualEndpoint/userSettings/{id}/assign
In the request body, supply a JSON representation of the [cloudPcUserSettingAssignment](../resources/cloudpcusersettingassignment.md) object.
-The following table shows the properties that are required when you create the [cloudPcUserSettingAssignment](../resources/cloudpcusersettingassignment.md).
-
-|Property|Type|Description|
+|Parameter|Type|Description|
|:|:|:|
-|target|[cloudPcManagementAssignmentTarget](../resources/cloudpcmanagementassignmenttarget.md)|The assignment target for the provisioning policy. Currently, the only target supported is a user group.|
+|assignments|[cloudPcUserSettingAssignment](../resources/cloudpcusersettingassignment.md) collection | The collection of cloud PC user setting resources each to be assigned to the corresponding target group. Only Microsoft 365 groups and security groups in Azure AD are currently supported. |
## Response
v1.0 Virtualendpoint List Cloudpcs https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/virtualendpoint-list-cloudpcs.md
Content-Type: application/json
{ "@odata.type": "#microsoft.graph.cloudPC", "id": "662009bc-7732-4f6f-8726-25883518ffff",
- "displayName": "Display Name value",
- "imageDisplayName": "Image Display Name value",
+ "displayName": "Demo-1",
+ "imageDisplayName": "Windows-10 19h1-evd",
"managedDeviceId": "bdc8e6dd-0455-4412-83d9-c818664fffff",
- "managedDeviceName": "Managed Device Name value",
+ "managedDeviceName": "A00002GI001",
"provisioningPolicyId": "7ed725ad-0a00-4117-b557-d965c373ffff",
- "provisioningPolicyName": "Provisioning Policy Name value",
- "onPremisesConnectionName": "On-premises connection Name value",
+ "provisioningPolicyName": "HR provisioning policy",
+ "onPremisesConnectionName": "on-Premises connection for HR",
"servicePlanId": "dbb9148c-ff83-4a4c-8d7f-28752e93ffff", "servicePlanName": "lite", "status": "provisioned",
- "userPrincipalName": "User Principal Name value",
+ "userPrincipalName": "pmitchell@cpccustomer001.onmicrosoft.com",
"lastModifiedDateTime": "2020-11-03T10:29:57Z", "statusDetails": null,
- "gracePeriodEndDateTime": "Grace Period End Date Time value "
+ "gracePeriodEndDateTime": "2020-11-010T20:00:34Z"
} ] }
v1.0 Changenotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/changenotification.md
None.
| Property | Type | Description | |:|:--|:|
-| changeType | string | Indicates the type of change that will raise the change notification. The supported values are: `created`, `updated`, `deleted`. Required. |
+| changeType | changeType | Indicates the type of change that will raise the change notification. The supported values are: `created`, `updated`, `deleted`. Required. |
| clientState | string | Value of the **clientState** property sent specified in the subscription request (if any). The maximum length is 255 characters. The client can check whether the change notification came from the service by comparing the values of the **clientState** property. The value of the **clientState** property sent with the subscription is compared with the value of the **clientState** property received with each change notification. Optional. |
-| encryptedContent | [microsoft.graph.changeNotificationEncryptedContent](changenotificationencryptedcontent.md) | (Preview) Encrypted content attached with the change notification. Only provided if **encryptionCertificate** and **includeResourceData** were defined during the subscription request and if the resource supports it. Optional. |
-| lifecycleEvent | string | The type of lifecycle notification if the current notification is a lifecycle notification. Optional. Supported values are `missed`, `removed`, `reauthorizationRequired`. |
+| encryptedContent | [changeNotificationEncryptedContent](changenotificationencryptedcontent.md) | (Preview) Encrypted content attached with the change notification. Only provided if **encryptionCertificate** and **includeResourceData** were defined during the subscription request and if the resource supports it. Optional. |
| id | string | Unique ID for the notification. Optional. |
+| lifecycleEvent | lifecycleEventType | The type of lifecycle notification if the current notification is a lifecycle notification. Optional. Supported values are `missed`, `removed`, `reauthorizationRequired`. |
| resource | string | The URI of the resource that emitted the change notification relative to `https://graph.microsoft.com`. Required. |
-| resourceData | [microsoft.graph.resourceData](resourcedata.md) | The content of this property depends on the type of resource being subscribed to. Required. |
-| subscriptionExpirationDateTime | [dateTime](https://tools.ietf.org/html/rfc3339) | The expiration time for the subscription. Required. |
-| subscriptionId | string | The unique identifier of the subscription that generated the notification. |
-| tenantId | guid | The unique identifier of the tenant from which the change notification originated. |
+| resourceData | [resourceData](resourcedata.md) | The content of this property depends on the type of resource being subscribed to. Required. |
+| subscriptionExpirationDateTime | DateTimeOffset | The expiration time for the subscription. Required. |
+| subscriptionId | GUID | The unique identifier of the subscription that generated the notification. |
+| tenantId | GUID | The unique identifier of the tenant from which the change notification originated. |
## Relationships
v1.0 Cloudpcmanagementassignmenttarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcmanagementassignmenttarget.md
Namespace: microsoft.graph
Base type for assignment targets.
-The [cloudPcManagementGroupAssignmentTarget](cloudpcmanagementgroupassignmenttarget.md) resource. which represents an assignment target group, inherits from this base type, **cloudPcManagementAssignmentTarget**.
+The [cloudPcManagementGroupAssignmentTarget](cloudpcmanagementgroupassignmenttarget.md) resource, which represents an assignment target group, inherits from this base type.
[!INCLUDE [cloudpc-api-preview](../../includes/cloudpc-api-preview.md)]+ ## Properties Not applicable.
v1.0 Cloudpcprovisioningpolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcprovisioningpolicy.md
Represents a cloud PC provisioning policy.
|Relationship|Type|Description| |:|:|:|
-|assignments|[cloudPcProvisioningPolicyAssignment](../resources/cloudpcprovisioningpolicyassignment.md) collection|A defined collection of provisioning policy assignments. Returned only on `$expand`. See an [example](../api/cloudpcprovisioningpolicy-get.md) of getting the assignments relationship. |
+|assignments|[cloudPcProvisioningPolicyAssignment](../resources/cloudpcprovisioningpolicyassignment.md) collection|A defined collection of provisioning policy assignments. Represents the set of Microsoft 365 groups and security groups in Azure AD that have provisioning policy assigned. Returned only on `$expand`. See an [example](../api/cloudpcprovisioningpolicy-get.md) of getting the assignments relationship. |
## JSON representation
v1.0 Cloudpcprovisioningpolicyassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcprovisioningpolicyassignment.md
Represents a defined collection of provisioning policy assignments.
|Property|Type|Description| |:|:|:|
-|id|String|Unique Identifier for the provisioning policy assignment. Read-only. If `target` is a user group, then the ID is shown as {policyId}_{groupId}.|
-|target|[cloudPcManagementAssignmentTarget](../resources/cloudpcmanagementassignmenttarget.md)|The assignment target for the provisioning policy. Currently, the only target supported for this policy is a user group.|
+|id|String|Unique Identifier for the provisioning policy assignment. Read-only. If `target` is a user group, then the ID is shown as {policyId}\_{groupId}.|
+|target|[cloudPcManagementAssignmentTarget](../resources/cloudpcmanagementassignmenttarget.md)|The assignment target for the provisioning policy. Currently, the only target supported for this policy is a user group. For details, see [cloudPcManagementGroupAssignmentTarget](cloudpcmanagementgroupassignmenttarget.md). |
## Relationships
v1.0 Cloudpcusersetting https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcusersetting.md
Represents a cloud PC user setting.
|[Create cloudPcUserSetting](../api/virtualendpoint-post-usersettings.md)|[cloudPcUserSetting](../resources/cloudpcusersetting.md)|Create a new [cloudPcUserSetting](../resources/cloudpcusersetting.md) object.| |[Update cloudPcUserSetting](../api/cloudpcusersetting-update.md)|[cloudPcUserSetting](../resources/cloudpcusersetting.md)|Update the properties of a [cloudPcUserSetting](../resources/cloudpcusersetting.md) object.| |[Delete cloudPcUserSetting](../api/cloudpcusersetting-delete.md)|None|Deletes a [cloudPcUserSetting](../resources/cloudpcusersetting.md) object.|
-|[assign](../api/cloudpcusersetting-assign.md)|None|Assign a [cloudPcUserSetting](../resources/cloudpcusersetting.md) to user groups.|
+|[Assign](../api/cloudpcusersetting-assign.md)|None|Assign a [cloudPcUserSetting](../resources/cloudpcusersetting.md) to user groups.|
## Properties |Property|Type|Description| |:|:|:| |id|String|Unique identifier for the cloud PC user setting. Read-only.| |displayName|String|The setting name displayed in the user interface. |
-|localAdminEnabled|Boolean|Indicates whether the local admin option is enabled. Default value is `false`. To enable the local admin option, change the setting to `true`. |
-|selfServiceEnabled|Boolean|Indicates whether the self-service option is enabled. Default value is `false`. To enable the self-service option, change the setting to `true`.ΓÇ»|
+|localAdminEnabled|Boolean|Indicates whether the local admin option is enabled. Default value is `false`. To enable the local admin option, change the setting to `true`. If the local admin option is enabled, the end user can be an admin of the cloud PC device. |
+|selfServiceEnabled|Boolean|Indicates whether the self-service option is enabled. Default value is `false`. To enable the self-service option, change the setting to `true`. If the self-service option is enabled, the end user is allowed to perform some self-service operations, such as upgrading the cloud PC through the end user portal.|
|lastModifiedDateTime|DateTimeOffset|The last date and time the setting was modified. The Timestamp type represents the date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 looks like this:ΓÇ»'2014-01-01T00:00:00Z'.ΓÇ»| |createdDateTime|DateTimeOffset|The date and time the setting was created. The Timestamp type represents the date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 looks like this: '2014-01-01T00:00:00Z'.ΓÇ»| ## Relationships |Relationship|Type|Description| |:|:|:|
-|assignments|[cloudPcUserSettingAssignment](../resources/cloudpcusersettingassignment.md) collection|Office 365 and security groups in Azure AD can have a set of user settings assigned.|
+|assignments|[cloudPcUserSettingAssignment](../resources/cloudpcusersettingassignment.md) collection|Represents the set of Microsoft 365 groups and security groups in Azure AD that have cloudPCUserSetting assigned. Returned only on `$expand`. For an example, see [Get cloudPcUserSettingample](../api/cloudpcusersetting-get.md).|
## JSON representation The following is a JSON representation of the resource.
v1.0 Cloudpcusersettingassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/cloudpcusersettingassignment.md
Represents a defined collection of user setting assignments.
|Property|Type|Description| |:|:|:|
-|id|String|Unique Identifier for the user setting assignment. Read-only. If `target` is a user group, the ID has this structure: {policyID}_{groupID}.|
-|target|[cloudPcManagementAssignmentTarget](../resources/cloudpcmanagementassignmenttarget.md)|The assignment target for the user setting. Currently, the only target supported for user setting is a user group.|
+|id|String|Unique Identifier for the user setting assignment. Read-only. If `target` is a user group, the ID has this structure: {policyID}\_{groupID}.|
+|target|[cloudPcManagementAssignmentTarget](../resources/cloudpcmanagementassignmenttarget.md)|The assignment target for the user setting. Currently, the only target supported for this user setting is a user group. For details, see [cloudPcManagementGroupAssignmentTarget](cloudpcmanagementgroupassignmenttarget.md).|
|createdDateTime|DateTimeOffset|The date and time this assignment was created. The Timestamp type represents the date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 looks like this: '2014-01-01T00:00:00Z'. ΓÇ»| ## Relationships
v1.0 Conditionalaccessdevices https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/conditionalaccessdevices.md
Represents devices in the policy scope.
| Property | Type | Description | |:-|:|:|
-| includeDevices | String collection | States in the scope of the policy. `All` is the only allowed value. |
-| excludeDevices | String collection | States excluded from the scope of the policy. Possible values: `Compliant`, `DomainJoined`. |
+| includeDevices | String collection | States in the scope of the policy. `All` is the only allowed value. Cannot be set if *deviceFIlter* is set. |
+| excludeDevices | String collection | States excluded from the scope of the policy. Possible values: `Compliant`, `DomainJoined`. Cannot be set if **deviceFIlter** is set. |
+| deviceFilter | [conditionalAccessFilter](conditionalaccessfilter.md) | Filter defining the dynamic-device-syntax rule to include/exclude devices. A filter can use device properties (such as extension attributes) to include/exclude them. Cannot be set if **includeDevices** or **excludeDevices** is set. |
| includeDeviceStates (deprecated)| String collection | States in the scope of the policy. `All` is the only allowed value. | | excludeDeviceStates (deprecated)| String collection | States excluded from the scope of the policy. Possible values: `Compliant`, `DomainJoined`. |
The following is a JSON representation of the resource.
"blockType": "resource", "optionalProperties": [ "includeDevices",
- "excludeDevices"
+ "excludeDevices",
+ "deviceFilter"
], "@odata.type": "microsoft.graph.conditionalAccessDevices", "baseType": null
The following is a JSON representation of the resource.
```json { "includeDevices": [ "String" ],
- "excludeDevices": [ "String" ]
+ "excludeDevices": [ "String" ],
+ "deviceFilter": {"@odata.type": "microsoft.graph.conditionalAccessFilter"}
} ```
v1.0 Conditionalaccessfilter https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/conditionalaccessfilter.md
+
+ Title: "conditionalAccessFilter resource type"
+description: "Represents filter in the policy scope."
+localization_priority: Normal
+++
+# conditionalAccessFilter resource type
+
+Namespace: microsoft.graph
++
+Represents filter in the policy scope.
+
+## Properties
+
+| Property | Type | Description |
+|:-|:|:|
+| mode | filterMode | Mode to use for the filter. Possible values are `include` or `exclude`. |
+| rule | String | Rule syntax is similar to that used for membership rules for groups in Azure AD. For details, see [rules with multiple expressions](/azure/active-directory/enterprise-users/groups-dynamic-membership#rules-with-multiple-expressions) |
+
+## Relationships
+
+None.
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+ "mode",
+ "rule"
+ ],
+ "@odata.type": "microsoft.graph.conditionalAccessFilter",
+ "baseType": null
+}-->
+
+```json
+{
+ "mode": "String",
+ "rule": "String"
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "conditionalAccessFilter resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
++
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/enums.md
Namespace: microsoft.graph
+### filterMode values
+
+|Member|
+|:|
+|include|
+|exclude|
+
+### lifecycleEventType values
+
+|Member|
+|:|
+|missed|
+|subscriptionRemoved|
+|reauthorizationRequired|
+
+### changeType values
+
+|Member|
+|:|
+|created|
+|updated|
+|deleted|
+ ### countryLookupMethodType values |Member|
Possible values for user account types (group membership), per Windows definitio
|Member| Value | Description | |:|:- | : | |standard| 0 |Default type for a tag. Tags of type standard can be managed in the team by members who have permissions.|+
v1.0 Subscription https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/subscription.md
See [Use the Microsoft Graph API to get change notifications](webhooks.md) for t
| Property | Type | Description | Supported Resources | |:|:--|:|:--|
+| applicationId | string | Identifier of the application used to create the subscription. Read-only. | All |
| changeType | string | Indicates the type of change in the subscribed resource that will raise a change notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list. Required. <br><br>Note: Drive root item and list change notifications support only the `updated` changeType. User and group change notifications support `updated` and `deleted` changeType. | All |
-| notificationUrl | string | The URL of the endpoint that receives the change notifications. This URL must make use of the HTTPS protocol. Required. | All |
-| lifecycleNotificationUrl | string | The URL of the endpoint that receives lifecycle notifications, including `subscriptionRemoved` and `missed` notifications. This URL must make use of the HTTPS protocol. Optional. <br><br>[Read more](/graph/webhooks-lifecycle) about how Outlook resources use lifecycle notifications. | All |
-| resource | string | Specifies the resource that will be monitored for changes. Do not include the base URL (`https://graph.microsoft.com/bet) for each supported resource. Required. | All |
-| expirationDateTime | DateTimeOffset | Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. See the table below for maximum supported subscription length of time. Required. | All |
| clientState | string | Specifies the value of the **clientState** property sent by the service in each change notification. The maximum length is 255 characters. The client can check that the change notification came from the service by comparing the value of the **clientState** property sent with the subscription with the value of the **clientState** property received with each change notification. Optional. | All |
-| id | string | Unique identifier for the subscription. Read-only. | All |
-| applicationId | string | Identifier of the application used to create the subscription. Read-only. | All |
| creatorId | string | Identifier of the user or service principal that created the subscription. If the app used delegated permissions to create the subscription, this field contains the ID of the signed-in user the app called on behalf of. If the app used application permissions, this field contains the ID of the service principal corresponding to the app. Read-only. | All |
-| includeResourceData | Boolean | When set to `true`, change notifications [include resource data](/graph/webhooks-with-resource-data) (such as content of a chat message). Optional. | All |
| encryptionCertificate | string | A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Optional. Required when **includeResourceData** is true. | All | | encryptionCertificateId | string | A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Optional. Required when **includeResourceData** is true. | All |
+| expirationDateTime | DateTimeOffset | Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. See the table below for maximum supported subscription length of time. Required. | All |
+| id | string | Unique identifier for the subscription. Read-only. | All |
+| includeResourceData | Boolean | When set to `true`, change notifications [include resource data](/graph/webhooks-with-resource-data) (such as content of a chat message). Optional. | All |
| latestSupportedTlsVersion | string | Specifies the latest version of Transport Layer Security (TLS) that the notification endpoint, specified by **notificationUrl**, supports. The possible values are: `v1_0`, `v1_1`, `v1_2`, `v1_3`. </br></br>For subscribers whose notification endpoint supports a version lower than the currently recommended version (TLS 1.2), specifying this property by a set [timeline](https://developer.microsoft.com/graph/blogs/microsoft-graph-subscriptions-deprecating-tls-1-0-and-1-1/) allows them to temporarily use their deprecated version of TLS before completing their upgrade to TLS 1.2. For these subscribers, not setting this property per the timeline would result in subscription operations failing. </br></br>For subscribers whose notification endpoint already supports TLS 1.2, setting this property is optional. In such cases, Microsoft Graph defaults the property to `v1_2`. | All |
+| lifecycleNotificationUrl | string | The URL of the endpoint that receives lifecycle notifications, including `subscriptionRemoved` and `missed` notifications. This URL must make use of the HTTPS protocol. Optional. <br><br>[Read more](/graph/webhooks-lifecycle) about how Outlook resources use lifecycle notifications. | All |
| notificationContentType | string | Desired content-type for MS Graph change notifications for supported resource types. The default content-type is the "application/json" content-type. | All | | notificationQueryOptions | string | OData Query Options for specifying value for the targeting resource. Clients receive notifications when resource reaches the state matching the query options provided here. With this new property in the subscription creation payload along with all existing properties, Webhooks will deliver notifications whenever a resource reaches the desired state mentioned in the notificationQueryOptions property eg when the print job is completed, when a print job resource `isFetchable` property value becomes true etc. | [Universal Print Service](/graph/universal-print-webhook-notifications) |
+| notificationUrl | string | The URL of the endpoint that receives the change notifications. This URL must make use of the HTTPS protocol. Required. | All |
+| resource | string | Specifies the resource that will be monitored for changes. Do not include the base URL (`https://graph.microsoft.com/bet) for each supported resource. Required. | All |
### Maximum length of subscription per resource type
v1.0 Changenotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/changenotification.md
None.
| Property | Type | Description | |:|:--|:|
-| changeType | string | Indicates the type of change that will raise the change notification. The supported values are: `created`, `updated`, `deleted`. Required. |
+| changeType | changeType | Indicates the type of change that will raise the change notification. The supported values are: `created`, `updated`, `deleted`. Required. |
| clientState | string | Value of the **clientState** property sent in the subscription request (if any). The maximum length is 255 characters. The client can check whether the change notification came from the service by comparing the values of the **clientState** property. The value of the **clientState** property sent with the subscription is compared with the value of the **clientState** property received with each change notification. Optional. |
-| lifecycleEvent | string | The type of lifecycle notification if the current notification is a lifecycle notification. Optional. Supported values are `missed`, `removed`, `reauthorizationRequired`. |
-| encryptedContent | [microsoft.graph.changeNotificationEncryptedContent](changenotificationencryptedcontent.md) | (Preview) Encrypted content attached with the change notification. Only provided if **encryptionCertificate** and **includeResourceData** were defined during the subscription request and if the resource supports it. Optional. |
+| encryptedContent | [changeNotificationEncryptedContent](changenotificationencryptedcontent.md) | (Preview) Encrypted content attached with the change notification. Only provided if **encryptionCertificate** and **includeResourceData** were defined during the subscription request and if the resource supports it. Optional. |
| id | string | Unique ID for the notification. Optional. |
+| lifecycleEvent | lifecycleEventType| The type of lifecycle notification if the current notification is a lifecycle notification. Optional. Supported values are `missed`, `removed`, `reauthorizationRequired`. |
| resource | string | The URI of the resource that emitted the change notification relative to `https://graph.microsoft.com`. Required. |
-| resourceData | [microsoft.graph.resourceData](resourcedata.md) | The content of this property depends on the type of resource being subscribed to. Required. |
-| subscriptionExpirationDateTime | [dateTime](https://tools.ietf.org/html/rfc3339) | The expiration time for the subscription. Required. |
-| subscriptionId | string | The unique identifier of the subscription that generated the notification. |
-| tenantId | guid | The unique identifier of the tenant from which the change notification originated. |
+| resourceData | [resourceData](resourcedata.md) | The content of this property depends on the type of resource being subscribed to. Required. |
+| subscriptionExpirationDateTime | DateTimeOffset | The expiration time for the subscription. Required. |
+| subscriptionId | GUID | The unique identifier of the subscription that generated the notification. |
+| tenantId | GUID | The unique identifier of the tenant from which the change notification originated. |
## Relationships
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/enums.md
doc_type: enumPageType
Namespace: microsoft.graph
+### lifecycleEventType values
+
+|Member|
+|:|
+|missed|
+|subscriptionRemoved|
+|reauthorizationRequired|
+
+### changeType values
+
+|Member|
+|:|
+|clientIpAddress|
+|authenticatorAppGps|
+ ### consentRequestFilterByCurrentUserOptions values |Member|
v1.0 Subscription https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/subscription.md
See [Use the Microsoft Graph API to get change notifications](webhooks.md) for t
| Property | Type | Description | Supported Resources | |:|:--|:|:--|
+| applicationId | string | Identifier of the application used to create the subscription. Read-only. | All |
| changeType | string | Required. Indicates the type of change in the subscribed resource that will raise a change notification. The supported values are: `created`, `updated`, `deleted`. Multiple values can be combined using a comma-separated list.<br><br>Note: Drive root item and list change notifications support only the `updated` changeType. User and group change notifications support `updated` and `deleted` changeType. | All |
-| notificationUrl | string | Required. The URL of the endpoint that will receive the change notifications. This URL must make use of the HTTPS protocol. | All |
-| lifecycleNotificationUrl | string | The URL of the endpoint that receives lifecycle notifications, including `subscriptionRemoved` and `missed` notifications. This URL must make use of the HTTPS protocol. Optional. <br><br>[Read more](/graph/webhooks-lifecycle) about how Outlook resources use lifecycle notifications. | All |
-| resource | string | Required. Specifies the resource that will be monitored for changes. Do not include the base URL (`https://graph.microsoft.com/v1.0/`). See the possible resource path [values](webhooks.md) for each supported resource.| All |
-| expirationDateTime | [dateTime](https://tools.ietf.org/html/rfc3339) | Required. Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. See the table below for maximum supported subscription length of time. | All |
| clientState | string | Optional. Specifies the value of the `clientState` property sent by the service in each change notification. The maximum length is 128 characters. The client can check that the change notification came from the service by comparing the value of the `clientState` property sent with the subscription with the value of the `clientState` property received with each change notification. | All |
-| id | string | Unique identifier for the subscription. Read-only. | All |
-| applicationId | string | Identifier of the application used to create the subscription. Read-only. | All |
| creatorId | string | Identifier of the user or service principal that created the subscription. If the app used delegated permissions to create the subscription, this field contains the id of the signed-in user the app called on behalf of. If the app used application permissions, this field contains the id of the service principal corresponding to the app. Read-only. | All |
-| includeResourceData | Boolean | When set to `true`, change notifications [include resource data](/graph/webhooks-with-resource-data) (such as content of a chat message). Optional. | All |
| encryptionCertificate | string | A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Optional. Required when **includeResourceData** is true. | All | | encryptionCertificateId | string | A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Optional.| All |
+| expirationDateTime | DateTimeOffset | Required. Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. See the table below for maximum supported subscription length of time. | All |
+| id | string | Unique identifier for the subscription. Read-only. | All |
+| includeResourceData | Boolean | When set to `true`, change notifications [include resource data](/graph/webhooks-with-resource-data) (such as content of a chat message). Optional. | All |
| latestSupportedTlsVersion | String | Specifies the latest version of Transport Layer Security (TLS) that the notification endpoint, specified by **notificationUrl**, supports. The possible values are: `v1_0`, `v1_1`, `v1_2`, `v1_3`. </br></br>For subscribers whose notification endpoint supports a version lower than the currently recommended version (TLS 1.2), specifying this property by a set [timeline](https://developer.microsoft.com/graph/blogs/microsoft-graph-subscriptions-deprecating-tls-1-0-and-1-1/) allows them to temporarily use their deprecated version of TLS before completing their upgrade to TLS 1.2. For these subscribers, not setting this property per the timeline would result in subscription operations failing. </br></br>For subscribers whose notification endpoint already supports TLS 1.2, setting this property is optional. In such cases, Microsoft Graph defaults the property to `v1_2`. | All |
+| lifecycleNotificationUrl | string | The URL of the endpoint that receives lifecycle notifications, including `subscriptionRemoved` and `missed` notifications. This URL must make use of the HTTPS protocol. Optional. <br><br>[Read more](/graph/webhooks-lifecycle) about how Outlook resources use lifecycle notifications. | All |
| notificationContentType | string | Desired content-type for MS Graph change notifications for supported resource types. The default content-type is the "application/json" content-type. | All | | notificationQueryOptions | string | OData Query Options for specifying value for the targeting resource. Clients receive notifications when resource reaches the state matching the query options provided here. With this new property in the subscription creation payload along with all existing properties, Webhooks will deliver notifications whenever a resource reaches the desired state mentioned in the notificationQueryOptions property eg when the print job is completed, when a print job resource `isFetchable` property value becomes true etc. | [Universal Print Service](/graph/universal-print-webhook-notifications) |
+| notificationUrl | string | Required. The URL of the endpoint that will receive the change notifications. This URL must make use of the HTTPS protocol. | All |
+| resource | string | Required. Specifies the resource that will be monitored for changes. Do not include the base URL (`https://graph.microsoft.com/v1.0/`). See the possible resource path [values](webhooks.md) for each supported resource.| All |
### Maximum length of subscription per resource type