Updates from: 08/16/2022 05:51:50
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Callrecords Callrecord Getdirectroutingcalls https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/callrecords-callrecord-getdirectroutingcalls.md
The following table shows the parameters that can be used with this function.
|Parameter|Type|Description| |:|:|:| |fromDateTime|DateTimeOffset|Start of time range to query. UTC, inclusive.<br/>Time range is based on the call start time.|
-|toDateTime|DateTimeOffset|End of time range to query. UTC, inclusive.|
+|toDateTime|DateTimeOffset|End of time range to query. UTC, exclusive.|
## Response
v1.0 Cloudpc Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-get.md
One of the following permissions is required to call this API. To learn more, in
} -->
+To get the [cloudPC](../resources/cloudpc.md) of the specified user (who is the signed-in user) in the organization using delegated permission:
+
+``` http
+GET /me/cloudPCs{id}
+GET /users/{userId}/cloudPCs/{id}
+```
+
+To get the specified [cloudPC](../resources/cloudpc.md) in the organization, using either delegated permission (the signed-in user should be the administrator) or application permission:
+ ``` http GET /deviceManagement/virtualEndpoint/cloudPCs/{id} ```
The following is an example of a request.
--> ``` http
-GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/40cee9d2-03fb-4066-8d35-dbdf2875c33f?$select=id,displayName,imageDisplayName,lastModifiedDateTime,lastRemoteActionResult,lastLoginResult
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/40cee9d2-03fb-4066-8d35-dbdf2875c33f?$select=id,displayName,imageDisplayName,lastModifiedDateTime,lastRemoteActionResult,lastLoginResult,connectivityResult
``` # [C#](#tab/csharp)
Content-Type: application/json
"cloudPcId": "662009bc-7732-4f6f-8726-25883518b33e", "managedDeviceId": "bdc8e6dd-0455-4412-83d9-c818664fe1f1", "statusDetails": null
+ },
+ "connectivityResult": {
+ "status": "unavailable",
+ "updatedDatetime": "2022-03-22T10:28:32.8260335Z",
+ "failedHealthCheckItems": [
+ {
+ "displayName": "DomainJoinCheck",
+ "result": "failure",
+ "lastHealthCheckDateTime": "2022-03-22T10:28:32.8260335Z",
+ "additionalDetails": "SessionHost unhealthy: SessionHost is not joined to a domain"
+ }
+ ]
} } ```+
+### Exmaple 3: Get the default properties of a Cloud PC of the signed-in user
+
+#### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "user_get_cloudpc_default_properties"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "name": "user_get_cloudpc_default_properties",
+ "@odata.type": "microsoft.graph.cloudPC"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.cloudPC",
+ "aadDeviceId": "61204a22-0ca8-11ed-861d-0242ac120002",
+ "id": "36bd4942-0ca8-11ed-861d-0242ac120002",
+ "displayName": "Demo-1",
+ "imageDisplayName": "Windows-10 19h1-evd",
+ "managedDeviceId": "70341bb0-0ca8-11ed-861d-0242ac120002",
+ "managedDeviceName": "A00002GI001",
+ "provisioningPolicyId": "7a3bdee0-0ca8-11ed-861d-0242ac120002",
+ "provisioningPolicyName": "Marketing provisioning policy",
+ "onPremisesConnectionName": "Azure network connection for Marketing",
+ "servicePlanId": "83fca22a-0ca8-11ed-861d-0242ac120002",
+ "servicePlanName": "standard",
+ "servicePlanType": "enterprise",
+ "status": "failed",
+ "statusDetails": {
+ "@odata.type": "microsoft.graph.cloudPcStatusDetails",
+ "code": "internalServerError",
+ "message": "There was an internal server error. Please contact support xxx.",
+ "additionalInformation": [
+ {
+ "@odata.type": "microsoft.graph.keyValuePair",
+ "name": "correlationId",
+ "value": "8fea34e4-0ca8-11ed-861d-0242ac120002"
+ }
+ ]
+ },
+ "userPrincipalName": "pmitchell@cpccustomer001.onmicrosoft.com",
+ "lastModifiedDateTime": "2020-11-03T18:14:34Z",
+ "gracePeriodEndDateTime": "2020-11-010T20:00:34Z"
+}
+```
v1.0 Cloudpc Getcloudpcconnectivityhistory https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-getcloudpcconnectivityhistory.md
+
+ Title: "cloudPC: getCloudPcConnectivityHistory"
+description: "Get the connectivity history of a specific Cloud PC."
+
+ms.localizationpriority: medium
++
+# cloudPC: getCloudPcConnectivityHistory
+
+Namespace: microsoft.graph
++
+Get the connectivity history of a specific Cloud PC.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|CloudPC.Read.All, CloudPC.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|CloudPC.Read.All, CloudPC.ReadWrite.All|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /deviceManagement/virtualEndpoint/cloudPCs/{id}/getCloudPcConnectivityHistory
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [cloudPcConnectivityEvent](../resources/cloudpcconnectivityevent.md) collection object in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of a request.
+
+<!-- {
+ "blockType": "request",
+ "name": "cloudpc.getCloudPcConnectivityHistory"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/{id}/getCloudPcConnectivityHistory
+```
+
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "@odata.type": "Collection(microsoft.graph.cloudPcConnectivityEvent)",
+ "name": "cloudpc.getCloudPcConnectivityHistory"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "@odata.type": "microsoft.graph.cloudPcConnectivityEvent",
+ "eventDateTime": "2022-03-23T18:40:00Z",
+ "eventName": "DomainJoinCheck",
+ "eventResult": "failure",
+ "eventType": "deviceHealthCheck",
+ "message": "SessionHost unhealthy: SessionHost is not joined to a domain"
+ }
+ ]
+}
+```
v1.0 Cloudpc Reboot https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-reboot.md
One of the following permissions is required to call this API. To learn more, in
} -->
+To reboot the [cloudPC](../resources/cloudpc.md) of the specified user (who is the signed-in user) in the organization using delegated permission:
+
+```http
+POST /me/cloudPCs/{cloudPCId}/reboot
+POST /users/{userId}/cloudPCs/{cloudPCId}/reboot
+```
+
+To reboot the specified [cloudPC](../resources/cloudpc.md) in the organization, using either delegated permission (the signed-in user should be the administrator) or application permission:
+ ``` http POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/reboot ```
If successful, this method returns a `204 No Content` response code.
## Examples
-### Request
+### Example 1: Reboot the cloudPC for the adminstrator
+
+#### Request
# [HTTP](#tab/http)
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/
-### Response
+#### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 2: Reboot the cloudPC for the signed-in user
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "user_reboot_cloudpc"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002/reboot
+```
+
+#### Response
<!-- { "blockType": "response",
v1.0 Cloudpc Rename https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-rename.md
One of the following permissions is required to call this API. To learn more, in
} -->
+To rename the [cloudPC](../resources/cloudpc.md) of the specified user (who is the signed-in user) in the organization using delegated permission:
+
+``` http
+POST /me/cloudPCs/{cloudPCId}/rename
+POST /users/{userId}/cloudPCs/{cloudPCId}/rename
+```
+
+To rename the specified [cloudPC](../resources/cloudpc.md) in the organization, using either delegated permission (the signed-in user should be the administrator) or application permission:
+ ``` http POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/rename ```
If successful, this method returns a `204 No Content` response code.
## Examples
-### Request
+### Example 1: Rename the cloudPC for the administrator
+
+#### Request
# [HTTP](#tab/http)
Content-Type: application/json
-### Response
+#### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 2: Rename the cloudPC for the signed-in user
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "user_rename_cloudpc"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002/rename
+```
+
+#### Response
<!-- { "blockType": "response",
v1.0 Cloudpc Reprovision https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-reprovision.md
One of the following permissions is required to call this API. To learn more, in
} -->
+To reprovision the [cloudPC](../resources/cloudpc.md) of the specified user (who is the signed-in user) in the organization using delegated permission:
+
+``` http
+POST /me/cloudPCs/{id}/reprovision
+POST /users/{userId}/cloudPCs/{id}/reprovision
+```
+
+To reprovision the specified [cloudPC](../resources/cloudpc.md) in the organization, using either delegated permission (the signed-in user should be the administrator) or application permission:
+ ``` http POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/reprovision ```
POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/reprovision
## Request body
+> **Note**: Only the APIs for **admin** support request body.
+ In the request body, supply a JSON representation of the parameters. The following table shows the parameters that can be used with this action.
If successful, this method returns a `204 No Content` response code.
## Examples
-### Request
+### Example 1: Reprovision the cloudPC for the administrator
+
+#### Request
# [HTTP](#tab/http)
Content-length: 61
-### Response
+#### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
+
+### Example 2: Reprovision the cloudPC for the signed-in user
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "user_cloudpc_reprovision"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002/reprovision
+```
+
+#### Response
<!-- { "blockType": "response",
v1.0 Cloudpc Troubleshoot https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpc-troubleshoot.md
One of the following permissions is required to call this API. To learn more, in
} -->
+To troubleshoot the [cloudPC](../resources/cloudpc.md) of the specified user (who is the signed-in user) in the organization using delegated permission:
+
+``` http
+POST /me/cloudPCs/{cloudPCId}/troubleshoot
+POST /users/{userId}/cloudPCs/{cloudPCId}/troubleshoot
+```
+
+To troubleshoot the specified [cloudPC](../resources/cloudpc.md) in the organization, using either delegated permission (the signed-in user should be the administrator) or application permission:
+ ``` http POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/troubleshoot ```
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/
``` http HTTP/1.1 204 No Content ```+
+### Example 2: Troubleshoot the cloudPC for the signed-in user
+
+#### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "user_troubleshoot_cloudpc"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002/troubleshoot
+```
+
+#### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Cloudpcorganizationsettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcorganizationsettings-get.md
Content-Type: application/json
{ "value": { "@odata.type": "#microsoft.graph.cloudPcOrganizationSettings",
+ "enableMEMAutoEnroll": false,
"id": "8660bf17-bf17-8660-17bf-608617bfffff",
- "userAccountType": "standardUser",
"osVersion": "windows11",
+ "userAccountType": "standardUser",
"windowsSettings": { "language": "en-US" }
v1.0 Cloudpcorganizationsettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/cloudpcorganizationsettings-update.md
PATCH /deviceManagement/virtualEndpoint/organizationSettings
|Property|Type|Description| |:|:|:|
+|enableMEMAutoEnroll|Boolean|Specifies whether new Cloud PCs will be automatically enrolled in Microsoft Endpoint Manager(MEM). The default value is `false`. Optional.|
|osVersion|cloudPcOperatingSystem|The version of the operating system (OS) to provision on Cloud PCs. The possible values are: `windows10`, `windows11`, `unknownFutureValue`. Optional.| |userAccountType|cloudPcUserAccountType|The account type of the user on provisioned Cloud PCs. The possible values are: `standardUser`, `administrator`, `unknownFutureValue`. Optional.| |windowsSettings|cloudPcWindowsSettings|The settings to apply to Windows while creating Cloud PCs for this organization. The default language value is `en-US`.|
Content-length: 127
{ "@odata.type": "#microsoft.graph.cloudPcOrganizationSettings",
- "userAccountType": "standardUser",
+ "enableMEMAutoEnroll": true,
"osVersion": "windows11",
+ "userAccountType": "standardUser",
"windowsSettings": { "language": "en-US" }
v1.0 Manageddevice Getcloudpcreviewstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/manageddevice-getcloudpcreviewstatus.md
Content-Type: application/json
"subscriptionId": "f68bd846-16ad-4b51-a7c6-c84944a3367c", "subscriptionName": "deschutes-INT-DR-test", "azureStorageAccountId": "/subscriptions/f68bd846-16ad-4b51-a7c6-c84944a3367c/resourceGroups/Review/providers/Microsoft.Storage/storageAccounts/snapshotsUnderReview",
- "azureStorageAccountName": "snapshotsUnderReview"
+ "azureStorageAccountName": "snapshotsUnderReview",
+ "azureStorageContainerName": "snapshotsContainer"
} ```
v1.0 Cloudpc https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpc.md
Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled into
|[Bulk set review status](../api/manageddevice-bulksetcloudpcreviewstatus.md)|[cloudPcBulkRemoteActionResult](../resources/cloudpcbulkremoteactionresult.md)|Set the review status of multiple Cloud PC devices with a single request that includes the IDs of Intune managed devices.| |[List for user](../api/user-list-cloudpcs.md)|[cloudPC](../resources/cloudpc.md) collection|List the [cloudPC](../resources/cloudpc.md) devices that are attributed to the signed-in user.| |[Get launch info for user](../api/cloudpc-getcloudpclaunchinfo.md)|[cloudPCLaunchInfo](../resources/cloudpclaunchinfo.md)|Get the [cloudPCLaunchInfo](../resources/cloudpclaunchinfo.md) for the signed-in user.|
+|[Get connectivity history](../api/cloudpc-getcloudpcconnectivityhistory.md)|[cloudPcConnectivityEvent](../resources/cloudpcconnectivityevent.md) collection|Get the Cloud PC connectivity history.|
## Properties |Property|Type|Description| |:|:|:| |aadDeviceId|String|The Azure Active Directory (Azure AD) device ID of the Cloud PC.|
+|connectivityResult|[cloudPcConnectivityResult](../resources/cloudpcconnectivityresult.md)|The connectivity health check result of a Cloud PC, including the updated timestamp and whether the Cloud PC is able to be connected or not.|
|displayName|String|The display name of the Cloud PC.| |gracePeriodEndDateTime|DateTimeOffset|The date and time when the grace period ends and reprovisioning/deprovisioning happens. Required only if the status is `inGracePeriod`. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| |id|String|The unique identifier for the Cloud PC. Read-only.|
The following is a JSON representation of the resource.
"userAccountType": "String", "osVersion": "String", "lastRemoteActionResult": "String",
- "lastLoginResult": "String"
+ "lastLoginResult": "String",
+ "connectivityResult": "String"
} ```
v1.0 Cloudpcconnectivityevent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcconnectivityevent.md
+
+ Title: "cloudPcConnectivityEvent resource type"
+description: "Describes a user connection record, including when and how the Cloud PC was connected and whether the connection was successful. "
+
+ms.localizationpriority: medium
++
+# cloudPcConnectivityEvent resource type
+
+Namespace: microsoft.graph
++
+Describes a user connection record, including when and how the Cloud PC was connected and whether the connection was successful.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|eventDateTime|DateTimeOffset|Indicates the date and time when this event was created. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 appears as `2014-01-01T00:00:00Z`.|
+|eventName|string|Name of the event.|
+|eventResult|[cloudPcConnectivityEventResult](#cloudpcconnectivityeventresult-values)|Result of this event. Possible values are: `unknown`, `success`, `failure`, and `unknownFutureValue`.|
+|eventType|[cloudPcConnectivityEventType](#cloudpcconnectivityeventtype-values)|Type of this event. Possible values are: `unknown`, `userConnection`, `userTroubleshooting`, `deviceHealthCheck`, and `unknownFutureValue`.|
+|message|string|Additional message for this event.|
+
+### cloudPcConnectivityEventResult values
+
+|Member|Value|Description|
+|:|:|:|
+|unknown|0|The event result is unknown.|
+|success|1|The event result is success.|
+|failure|2|The event result is failure.|
+|unknownFutureValue|999|Evolvable enumeration sentinel value. Do not use.|
+
+### cloudPcConnectivityEventType values
+
+|Member|Value|Description|
+|:|:|:|
+|unknown|0|The event type is unknown.|
+|userConnection|1|The event comes from user connecting to Cloud PC.|
+|userTroubleshooting|2|The event comes from user's troubleshooting action.|
+|deviceHealthCheck|3|The event comes from service's regular device health check.|
+|unknownFutureValue|999|Evolvable enumeration sentinel value. Do not use.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcConnectivityEvent"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcConnectivityEvent",
+ "eventDateTime": "String (timestamp)",
+ "eventName": "String",
+ "eventResult": "String",
+ "eventType": "String",
+ "message": "String"
+}
+```
v1.0 Cloudpcconnectivityresult https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcconnectivityresult.md
+
+ Title: "cloudPcConnectivityResult resource type"
+description: "Represents the details of the Cloud PC connectivity status."
+
+ms.localizationpriority: medium
++
+# cloudPcConnectivityResult resource type
+
+Namespace: microsoft.graph
++
+Represents the details of the Cloud PC connectivity status, including whether the Cloud PC is available, and if not, the failed health check items.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|failedHealthCheckItems|[cloudPcHealthCheckItem](../resources/cloudpchealthcheckitem.md) collection|A list of failed health check items. If the status property is `available`, this property will be empty.|
+|status|[cloudPcConnectivityStatus](#cloudpcconnectivitystatus-values)|Connectivity status of the Cloud PC. Possible values are: `unknown`, `available`, `availableWithWarning`, `unavailable`, and `unknownFutureValue`.|
+|updatedDateTime|string|Datetime when the status was updated. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 appears as `2014-01-01T00:00:00Z`. |
+
+### cloudPcConnectivityStatus values
+
+|Member|Value|Description|
+|:|:|:|
+|unknown|0|The Cloud PC connectivity status is unknown.|
+|available|1|The Cloud PC is able to be connected.|
+|availableWithWarning|2|The Cloud PC is able to be connected but there are warnings.|
+|unavailable|3|The Cloud PC is unable to be connected.|
+|unknownFutureValue|999|Evolvable enumeration sentinel value. Do not use.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcConnectivityResult"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcConnectivityResult",
+ "failedHealthCheckItems": "String",
+ "status": "String",
+ "updatedDateTime": "String (timestamp)"
+}
+```
v1.0 Cloudpchealthcheckitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpchealthcheckitem.md
+
+ Title: "cloudPcHealthCheckItem resource type"
+description: "Represents the details of the Cloud PC connectivity health check item."
+
+ms.localizationpriority: medium
++
+# cloudPcHealthCheckItem resource type
+
+Namespace: microsoft.graph
++
+Represents the details of the Cloud PC connectivity health check item.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|additionalDetails|string|Additional message for this health check.|
+|displayName|string|The connectivity health check item name.|
+|lastHealthCheckDateTime|DateTimeOffset|Timestamp when the last check occurs. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 appears as `2014-01-01T00:00:00Z`. |
+|result|[cloudPcConnectivityEventResult](../resources/cloudpcconnectivityevent.md#cloudpcconnectivityeventresult-values)|The result of this health check item. Possible values are: `unknown`, `success`, `failure`.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.cloudPcHealthCheckItem"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.cloudPcHealthCheckItem",
+ "additionalDetails": "String",
+ "displayName": "String",
+ "lastHealthCheckDateTime": "String (timestamp)",
+ "result": "String"
+}
+```
v1.0 Cloudpconpremisesconnectionhealthcheck https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpconpremisesconnectionhealthcheck.md
Title: "cloudPcOnPremisesConnectionHealthCheck resource type"
-description: "The result of a cloud PC Azure network connection health check."
+description: "The result of a Cloud PC Azure network connection health check."
ms.localizationpriority: medium ms.prod: "cloud-pc"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-The result of a cloud PC Azure network connection health check.
+The result of a Cloud PC Azure network connection health check.
[!INCLUDE [on-premise-rename-note](../../includes/on-premise-rename-note.md)]
The result of a cloud PC Azure network connection health check.
|endpointConnectivityCheckWVDUrlNotAllowListed|During provisioning, one or more required WVD URLs couldn't be contacted. Please make sure that all of the required URLs are allowed through the firewalls and proxies.| |endpointConnectivityCheckIntuneUrlNotAllowListed|During provisioning, one or more required Intune URLs couldnΓÇÖt be contacted. Please make sure that all of the required URLs are allowed through the firewalls and proxies.| |endpointConnectivityCheckUnknownError|During provisioning, one or more required URLs couldn't be contacted. Please make sure that all of the required URLs are allowed through the firewalls and proxies.|
-|azureAdDeviceSyncCheckDeviceNotFound|The cloud PC computer object can't be found in Azure Active Directory (Azure AD). Please make sure that Azure AD connect works and syncs frequently so that the cloud PC computer objects are synced to Azure AD. Azure AD device sync must be enabled and synced within the last 60 minutes.|
-|azureAdDeviceSyncCheckLongSyncCircle|The check whether the cloud PC computer object has been synced to Azure Active Directory (Azure AD) has timed out. Please make sure that Azure AD connect works and syncs frequently so that the cloud PC computer objects are synced to Azure AD. Azure AD device sync must be enabled and synced within the last 60 minutes.|
+|azureAdDeviceSyncCheckDeviceNotFound|The Cloud PC computer object can't be found in Azure Active Directory (Azure AD). Please make sure that Azure AD connect works and syncs frequently so that the Cloud PC computer objects are synced to Azure AD. Azure AD device sync must be enabled and synced within the last 60 minutes.|
+|azureAdDeviceSyncCheckLongSyncCircle|The check whether the Cloud PC computer object has been synced to Azure Active Directory (Azure AD) has timed out. Please make sure that Azure AD connect works and syncs frequently so that the Cloud PC computer objects are synced to Azure AD. Azure AD device sync must be enabled and synced within the last 60 minutes.|
|azureAdDeviceSyncCheckConnectDisabled|The Azure Active Directory (Azure AD) device sync check failed because the Azure AD Connect is disabled. Please make sure the Azure AD Connect is enabled and it syncs frequently. If the Azure AD Connect doesn't sync the computer within 60 minutes, then the check will fail.| |azureAdDeviceSyncCheckDurationExceeded|The Azure Active Directory (Azure AD) device sync check failed because the Azure AD Connect sync didn't sync within 60 minutes. Please make sure the Azure AD Connect is enabled and it syncs frequently. If the Azure AD Connect doesn't sync the computer within 60 minutes, then the check will fail.| |azureAdDeviceSyncCheckScpNotConfigured|The Hybrid Azure Active Directory (Azure AD) join failed due to misconfiguration in the Service Configuration Point (SCP). Please make sure your SCP configuration is valid and available to perform a Hybrid Azure AD join. Your SCP can be created and configured in the Azure AD Connect wizard.| |azureAdDeviceSyncCheckTransientServiceError|The Azure Active Directory (Azure AD) device sync check failed due to a transient error. Please try it again. If the issue persists, please contact customer support.|
-|azureAdDeviceSyncCheckUnknownError|Hybrid Azure Active Directory (Azure AD) connectivity check failed. Please make sure that Azure AD connect works and syncs frequently so that the cloud PC computer objects are synced to Azure AD. Azure AD device sync must be enabled and synced within the last 60 minutes.|
+|azureAdDeviceSyncCheckUnknownError|Hybrid Azure Active Directory (Azure AD) connectivity check failed. Please make sure that Azure AD connect works and syncs frequently so that the Cloud PC computer objects are synced to Azure AD. Azure AD device sync must be enabled and synced within the last 60 minutes.|
|resourceAvailabilityCheckNoSubnetIP|The subnet provided doesn't have IP addresses available. Please make sure that the subnet provided in the Azure network connection has sufficient IP addresses available. Please expand the current selected subnet or select a different subnet to be used for provisioning.| |resourceAvailabilityCheckSubscriptionDisabled|The Azure subscription provided is disabled. Please make sure that the Azure subscription is enabled and available for provisioning.| |resourceAvailabilityCheckAzurePolicyViolation|The Azure subscription provided can't be found. Please ensure that the Azure subscription is available for provisioning.|
The result of a cloud PC Azure network connection health check.
|resourceAvailabilityCheckSubnetDelegationFailed|The selected Azure virtual network has subnet delegation which blocks the creation of a network interface (Nic). Please ask your Azure virtual network owner to modify their subnet delegation policy to allow provisioning to succeed.| |resourceAvailabilityCheckSubnetWithExternalResources|The selected subnet can't be used because it contains external resources. Please remove any resources that could cause conflicts and try again. Alternatively, update this Azure network connection with another subnet.| |resourceAvailabilityCheckResourceGroupLockedForReadonly|The selected resource group is locked and can't be modified for provisioning. Please remove this lock to allow provisioning to succeed.|
-|resourceAvailabilityCheckResourceGroupLockedForDelete|The selected resource group or its parent scope has been locked for delete actions. It may be because the IP addresses are used up. Please remove the lock and try again.|
+|resourceAvailabilityCheckResourceGroupLockedForDelete|The selected resource group or its parent scope has been locked for delete actions. It might be because the IP addresses are used up. Please remove the lock and try again.|
|resourceAvailabilityCheckTransientServiceError|The resource availability check failed due to a transient error. Please try it again. If the issue persists, please contact customer support.|
+|resourceAvailabilityCheckNoIntuneReaderRoleError|The Cloud PC service principal doesn't have sufficient permissions to check the Intune platform restriction settings. Please make sure that the Cloud PC service principal has the *Reader* permissions on the subscription.|
+|resourceAvailabilityCheckIntuneDefaultWindowsRestrictionViolation|The Intune has a default Windows platform restriction policy, which may block you from provisioning.|
+|resourceAvailabilityCheckIntuneCustomWindowsRestrictionViolation|The Intune has a custom Windows platform restriction policy, which may block you from provisioning.|
|resourceAvailabilityCheckUnknownError|The resource availability check for Azure resources failed due to an unknown error. Please ensure that all Azure resources meet the prerequisites.|
-|permissionCheckNoSubscriptionReaderRole|The cloud PC service principal doesn't have sufficient permissions on the Azure subscription. Please make sure that the cloud PC service principal has the *Reader* permissions on the subscription.|
-|permissionCheckNoResourceGroupOwnerRole|The cloud PC service principal doesn't have sufficient permissions on the Azure resource group. Please make sure that the cloud PC service principal has the *Owner* permissions on the resource group. |
-|permissionCheckNoVNetContributorRole|The cloud PC service principal doesn't have sufficient permissions on the Azure vNet. Please make sure that the cloud PC service has the *Network contributor* permissions on the vNet.|
+|permissionCheckNoSubscriptionReaderRole|The Cloud PC service principal doesn't have sufficient permissions on the Azure subscription. Please make sure that the Cloud PC service principal has the *Reader* permissions on the subscription.|
+|permissionCheckNoResourceGroupOwnerRole|The Cloud PC service principal doesn't have sufficient permissions on the Azure resource group. Please make sure that the Cloud PC service principal has the *Owner* permissions on the resource group. |
+|permissionCheckNoVNetContributorRole|The Cloud PC service principal doesn't have sufficient permissions on the Azure vNet. Please make sure that the Cloud PC service has the *Network contributor* permissions on the vNet.|
|permissionCheckNoResourceGroupNetworkContributorRole|Cloud PC service principal doesn't have sufficient permissions on the Azure resource group. Please make sure that the application has Network contributor permissions on the resource group.| |permissionCheckTransientServiceError|The first-party app permission check failed due to a transient error. Please try it again. If the issue persists, please contact customer support.|
-|permissionCheckUnknownError|The cloud PC service principal doesn't have sufficient permissions. Please make sure that the cloud PC service principal is granted sufficient Azure permissions.|
+|permissionCheckUnknownError|The Cloud PC service principal doesn't have sufficient permissions. Please make sure that the Cloud PC service principal is granted sufficient Azure permissions.|
|internalServerErrorDeploymentCanceled|The deployment was canceled. Please try again later. If the problem persists, please contact support.| |internalServerErrorAllocateResourceFailed|The allocation of resources failed. Please try again later. If the problem persists, please contact support.| |internalServerErrorVMDeploymentTimeout|The virtual machine deployment timed out. Please try again later. If the problem persists, please contact support.|
-|internalServerErrorUnableToRunDscScript|During provisioning, some PowerShell DSC scripts are executed on the cloud PC. Unable to either download these DSC scripts or execute them during the health check. Please ensure vNet has unrestricted access to the required endpoints, and PowerShell isn't blocked in the environment or Group Policy.|
+|internalServerErrorUnableToRunDscScript|During provisioning, some PowerShell DSC scripts are executed on the Cloud PC. Unable to either download these DSC scripts or execute them during the health check. Please ensure vNet has unrestricted access to the required endpoints, and PowerShell isn't blocked in the environment or Group Policy.|
|internalServerUnknownError|The provisioning has failed due to an internal error. Please contact customer support.| |unknownFutureValue|Evolvable enumeration sentinel value. Do not use.|
v1.0 Cloudpcorganizationsettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcorganizationsettings.md
Represents the Cloud PC organization settings for a tenant. A tenant has only on
## Properties |Property|Type|Description| |:|:|:|
+|enableMEMAutoEnroll|Boolean|Specifies whether new Cloud PCs will be automatically enrolled in Microsoft Endpoint Manager(MEM). The default value is `false`.|
|id|String|The ID of the organization settings.| |osVersion|[cloudPcOperatingSystem](#cloudpcoperatingsystem-values)|The version of the operating system (OS) to provision on Cloud PCs. The possible values are: `windows10`, `windows11`, `unknownFutureValue`.| |userAccountType|[cloudPcUserAccountType](#cloudpcuseraccounttype-values)|The account type of the user on provisioned Cloud PCs. The possible values are: `standardUser`, `administrator`, `unknownFutureValue`.|
The following is a JSON representation of the resource.
``` json { "@odata.type": "#microsoft.graph.cloudPcOrganizationSettings",
+ "enableMEMAutoEnroll": "Boolean",
"id": "String (identifier)", "osVersion": "String", "userAccountType": "String",
v1.0 Cloudpcreviewstatus https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcreviewstatus.md
Represents details about the review status of a Cloud PC.
|:|:|:| |azureStorageAccountId|String|The resource ID of the Azure Storage account in which the Cloud PC snapshot is being saved.| |azureStorageAccountName|String|The name of the Azure Storage account in which the Cloud PC snapshot is being saved.|
+|azureStorageContainerName|String|The name of the container in an Azure Storage account in which the Cloud PC snapshot is being saved.|
|inReview|Boolean| `True` if the Cloud PC is set to in review by the administrator.| |restorePointDateTime|DateTimeOffset|The specific date and time of the Cloud PC snapshot that was taken and saved automatically, when the Cloud PC is set to in review. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 appears as `2014-01-01T00:00:00Z`.| |reviewStartDateTime|DateTimeOffset|The specific date and time when the Cloud PC was set to in review. The timestamp is shown in ISO 8601 format and Coordinated Universal Time (UTC). For example, midnight UTC on Jan 1, 2014 appears as `2014-01-01T00:00:00Z`.|
The following is a JSON representation of the resource.
"@odata.type": "#microsoft.graph.cloudPcReviewStatus", "azureStorageAccountId": "String", "azureStorageAccountName": "String",
+ "azureStorageContainerName": "String",
"inReview": "Boolean", "restorePointDateTime": "String (timestamp)", "reviewStartDateTime": "String (timestamp)",
v1.0 Projectrome Historyitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/projectrome-historyitem.md
Title: "historyItem resource type"
-description: "Represents a history item for an activity in an app. User activities represent a single destination within your app - for example, a TV show, a document, or a current campaign in a video game. When a user engages with that activity, the engagement is captured as a history item that indicates the start and end time for that activity. As the user re-engages with that activity over time, multiple history items are recorded for a single user activity."
+description: "Represents a history item for an activity in an app."
ms.localizationpriority: medium ms.prod: "project-rome" doc_type: resourcePageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Represents a history item for an [activity](projectrome-activity.md) in an app. User activities represent a single destination within your app - for example, a TV show, a document, or a current campaign in a video game. When a user engages with that activity, the engagement is captured as a history item that indicates the start and end time for that activity. As the user re-engages with that activity over time, multiple history items are recorded for a single user activity.
+Represents a history item for an [activity](projectrome-activity.md) in an app. User activities represent a single destination within your app; for example, a TV show, a document, or a current campaign in a video game. When a user engages with that activity, the engagement is captured as a history item that indicates the start and end time for that activity. As the user re-engages with that activity over time, multiple history items are recorded for a single user activity.
When an app creates a session, a **historyItem** object should be added to the **activity** object to reflect the period of user engagement. Each time a user re-engages with an activity, a new **historyItem** is added to the activity to accrue user engagement.
When an app creates a session, a **historyItem** object should be added to the *
|Method | Return Type | Description| |:|:|:--|
-|[Create or replace historyItem](../api/projectrome-put-historyitem.md) | [historyItem](projectrome-historyitem.md) | Creates or replaces an existing **historyItem** for that activity (upsert). The ID needs to be a GUID.|
-|[Delete a historyItem](../api/projectrome-delete-historyitem.md) | No Content | Deletes the specified **historyItem** for that activity.|
+|[Create or replace historyItem](../api/projectrome-put-historyitem.md) | [historyItem](projectrome-historyitem.md) | Create or replace an existing **historyItem** for that activity (upsert). The ID needs to be a GUID.|
+|[Delete a historyItem](../api/projectrome-delete-historyitem.md) | No Content | Delete the specified **historyItem** for that activity.|
## Properties
When an app creates a session, a **historyItem** object should be added to the *
## JSON representation
-Here is a JSON representation of the resource.
+The following is a JSON representation of the resource.
<!-- { "blockType": "resource",
Here is a JSON representation of the resource.
```json {
- "status": "String (EnumType)",
+ "activeDurationSeconds":"int",
"createdDateTime": "DateTimeOffset",
- "lastModifiedDateTime": "DateTimeOffset",
- "id": "String",
"expirationDateTime": "DateTimeOffset",
- "startedDateTime": "DateTimeOffset",
- "userTimezone": "String",
+ "id": "String",
"lastActiveDateTime": "DateTimeOffset",
- "activeDurationSeconds":"int"
+ "lastModifiedDateTime": "DateTimeOffset",
+ "startedDateTime": "DateTimeOffset",
+ "status": "String",
+ "userTimezone": "String"
} ```
v1.0 Report https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/report.md
In Microsoft 365 reports, user information such as usernames, groups, and sites
The following table shows the availability for each API across all cloud deployments.
-| APIs | Microsoft Graph global service | **Microsoft Cloud for US Government** | **Microsoft Cloud China operated by 21Vianet** | **Microsoft Cloud Germany** |
-| | | - | - | |
-| [Microsoft 365 activations](/graph/api/resources/office-365-activations-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Microsoft 365 active users](/graph/api/resources/office-365-active-users-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Microsoft 365 apps usage](/graph/api/resources/microsoft-365-apps-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Microsoft 365 browser usage](/graph/api/resources/microsoft-365-browser-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
-| [Microsoft 365 groups activity](/graph/api/resources/office-365-groups-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Microsoft Teams device usage](/graph/api/resources/microsoft-teams-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ₧û | Γ₧û |
-| [Microsoft Teams team usage](/graph/api/resources/microsoft-teams-team-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ₧û | Γ₧û |
-| [Microsoft Teams user activity](/graph/api/resources/microsoft-teams-user-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ₧û | Γ₧û |
-| [Outlook activity](/graph/api/resources/email-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
-| [Outlook app usage](/graph/api/resources/email-app-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
-| [Outlook mailbox usage](/graph/api/resources/mailbox-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
-| [OneDrive activity](/graph/api/resources/onedrive-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
-| [OneDrive usage](/graph/api/resources/onedrive-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
-| [SharePoint activity](/graph/api/resources/sharepoint-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
-| [SharePoint site usage](/graph/api/resources/sharepoint-site-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û |
-| [Skype for Business activity](/graph/api/resources/skype-for-business-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Skype for Business device usage](/graph/api/resources/skype-for-business-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Skype for Business organizer activity](/graph/api/resources/skype-for-business-organizer-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Skype for Business participant activity](/graph/api/resources/skype-for-business-participant-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Skype for Business peer-to-peer activity](/graph/api/resources/skype-for-business-peer-to-peer-activity?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û |
-| [Yammer activity](/graph/api/resources/yammer-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
-| [Yammer device usage](/graph/api/resources/yammer-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
-| [Yammer groups activity](/graph/api/resources/yammer-groups-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û |
+| APIs | Microsoft Graph global service | **Microsoft Cloud for US Government** | **Microsoft Cloud China operated by 21Vianet** | **Microsoft Cloud Germany** | **Microsoft Cloud for USNat and USSec** |
+| | | - | - | | |
+| [Microsoft 365 activations](/graph/api/resources/office-365-activations-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û |
+| [Microsoft 365 active users](/graph/api/resources/office-365-active-users-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û |
+| [Microsoft 365 apps usage](/graph/api/resources/microsoft-365-apps-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | Γ₧û |
+| [Microsoft 365 browser usage](/graph/api/resources/microsoft-365-browser-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | Γ₧û |
+| [Microsoft 365 groups activity](/graph/api/resources/office-365-groups-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û |
+| [Microsoft Teams device usage](/graph/api/resources/microsoft-teams-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ₧û | Γ₧û | Γ£ö |
+| [Microsoft Teams team usage](/graph/api/resources/microsoft-teams-team-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ₧û | Γ₧û | Γ£ö |
+| [Microsoft Teams user activity](/graph/api/resources/microsoft-teams-user-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ₧û | Γ₧û | Γ£ö |
+| [Outlook activity](/graph/api/resources/email-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | Γ£ö |
+| [Outlook app usage](/graph/api/resources/email-app-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | Γ£ö |
+| [Outlook mailbox usage](/graph/api/resources/mailbox-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | Γ£ö |
+| [OneDrive activity](/graph/api/resources/onedrive-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | Γ£ö |
+| [OneDrive usage](/graph/api/resources/onedrive-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | Γ£ö |
+| [SharePoint activity](/graph/api/resources/sharepoint-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | Γ£ö |
+| [SharePoint site usage](/graph/api/resources/sharepoint-site-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | Γ£ö |
+| [Skype for Business activity](/graph/api/resources/skype-for-business-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û |
+| [Skype for Business device usage](/graph/api/resources/skype-for-business-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û |
+| [Skype for Business organizer activity](/graph/api/resources/skype-for-business-organizer-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û |
+| [Skype for Business participant activity](/graph/api/resources/skype-for-business-participant-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û |
+| [Skype for Business peer-to-peer activity](/graph/api/resources/skype-for-business-peer-to-peer-activity?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | Γ₧û |
+| [Yammer activity](/graph/api/resources/yammer-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | Γ₧û |
+| [Yammer device usage](/graph/api/resources/yammer-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | Γ₧û |
+| [Yammer groups activity](/graph/api/resources/yammer-groups-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | Γ₧û |
## What's new Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set.
v1.0 Callrecords Callrecord Getdirectroutingcalls https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/callrecords-callrecord-getdirectroutingcalls.md
The following table shows the parameters that can be used with this function.
|Parameter|Type|Description| |:|:|:| |fromDateTime|DateTimeOffset|Start of time range to query. UTC, inclusive.<br/>Time range is based on the call start time.|
-|toDateTime|DateTimeOffset|End of time range to query. UTC, inclusive.|
+|toDateTime|DateTimeOffset|End of time range to query. UTC, exclusive.|
## Response
v1.0 Projectrome Historyitem https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/projectrome-historyitem.md
Title: "historyItem resource type"
-description: "Represents a history item for an activity in an app. User activities represent a single destination within your app - for example, a TV show, a document, or a current campaign in a video game. When a user engages with that activity, the engagement is captured as a history item that indicates the start and end time for that activity. As the user re-engages with that activity over time, multiple history items are recorded for a single user activity."
+description: "Represents a history item for an activity in an app. User activities represent a single destination within your app."
ms.localizationpriority: medium ms.prod: "project-rome"
doc_type: resourcePageType
Namespace: microsoft.graph
-Represents a history item for an [activity](projectrome-activity.md) in an app. User activities represent a single destination within your app - for example, a TV show, a document, or a current campaign in a video game. When a user engages with that activity, the engagement is captured as a history item that indicates the start and end time for that activity. As the user re-engages with that activity over time, multiple history items are recorded for a single user activity.
+Represents a history item for an [activity](projectrome-activity.md) in an app. User activities represent a single destination within your app; for example, a TV show, a document, or a current campaign in a video game. When a user engages with that activity, the engagement is captured as a history item that indicates the start and end time for that activity. As the user re-engages with that activity over time, multiple history items are recorded for a single user activity.
When an app creates a session, a **historyItem** object should be added to the **activity** object to reflect the period of user engagement. Each time a user re-engages with an activity, a new **historyItem** is added to the activity to accrue user engagement.
When an app creates a session, a **historyItem** object should be added to the *
|Method | Return Type | Description| |:|:|:--|
-|[Create or replace historyItem](../api/projectrome-put-historyitem.md) | [historyItem](projectrome-historyitem.md) | Creates or replaces an existing **historyItem** for that activity (upsert). The ID needs to be a GUID.|
-|[Delete a historyItem](../api/projectrome-delete-historyitem.md) | No Content | Deletes the specified **historyItem** for that activity.|
+|[Create or replace historyItem](../api/projectrome-put-historyitem.md) | [historyItem](projectrome-historyitem.md) | Create or replace an existing **historyItem** for that activity (upsert). The ID needs to be a GUID.|
+|[Delete a historyItem](../api/projectrome-delete-historyitem.md) | No Content | Delete the specified **historyItem** for that activity.|
## Properties
When an app creates a session, a **historyItem** object should be added to the *
## JSON representation
-Here is a JSON representation of the resource.
+The following is a JSON representation of the resource.
<!-- { "blockType": "resource",
Here is a JSON representation of the resource.
```json {
- "status": "active | updated | deleted | ignored",
+ "activeDurationSeconds":"int",
"createdDateTime": "DateTimeOffset",
- "lastModifiedDateTime": "DateTimeOffset",
- "id": "String",
"expirationDateTime": "DateTimeOffset",
- "startedDateTime": "DateTimeOffset",
- "userTimezone": "String",
+ "id": "String",
"lastActiveDateTime": "DateTimeOffset",
- "activeDurationSeconds":"int"
+ "lastModifiedDateTime": "DateTimeOffset",
+ "startedDateTime": "DateTimeOffset",
+ "status": "String",
+ "userTimezone": "String"
} ```