Merge pull request #25912 from microsoftgraph/yuxiang/onboard-regionalInaccessibleCloudPcTrendReport

Danielabom · web-flow · commit af74cdecde17 · 2025-02-14T17:37:21.000-06:00
Onboard regionalInaccessibleCloudPcTrendReport report name
diff --git a/api-reference/beta/api/cloudpcreports-getinaccessiblecloudpcreports.md b/api-reference/beta/api/cloudpcreports-getinaccessiblecloudpcreports.md
@@ -41,6 +41,7 @@ POST /deviceManagement/virtualEndpoint/reports/getInaccessibleCloudPcReports
 |:---|:---|
 |Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
 |Content-Type|application/json. Required.|
+| Prefer: include-unknown-enum-members | Enables evolvable enum values beyond the sentinel value. For more information, see [Best practices for working with Microsoft Graph](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations). Optional. |
 
 ## Request body
 
@@ -53,7 +54,7 @@ The following table shows the parameters that you can use with this method.
 | filter    | String            | OData `$filter` syntax. Only `and`, `or`, `gt` ,`ge` and `eq` are currently supported.     |
 | groupBy   | String collection | Specifies how to group the reports. If used, must have the same content as the select parameter.|
 | orderBy   | String collection | Specifies how to sort the reports.                                                           |
-| reportName | cloudPCInaccessibleReportName | The report name. The possible values are: `inaccessibleCloudPcReports`, `inaccessibleCloudPcTrendReport`, `unknownFutureValue`. The default value is `inaccessibleCloudPcReports` if the **reportName** is empty. |
+| reportName | cloudPCInaccessibleReportName | The report name. The possible values are: `inaccessibleCloudPcReports`, `inaccessibleCloudPcTrendReport`, `unknownFutureValue`, `regionalInaccessibleCloudPcTrendReport`. The default value is `inaccessibleCloudPcReports` if the **reportName** is empty. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `regionalInaccessibleCloudPcTrendReport`. |
 | search    | String            | Specifies a String to search for.                                                          |
 | select    | String collection | OData `$select` syntax. Represents the selected columns of the reports.                    |
 | skip      | Int32             | Number of records to skip.                                                                 |
@@ -66,14 +67,19 @@ The following table shows the parameters that you can use with this method.
 | inaccessibleCloudPcReports    | Indicates a report that contains details of Cloud PCs that are inaccessible, including those with consecutive connection failures or in an unavailable state.    |
 | inaccessibleCloudPcTrendReport| Indicates a daily aggregated report for a specified period that contains details of Cloud PCs that are inaccessible, including those with consecutive connection failures or in an unavailable state.                                          |
 | unknownFutureValue            | Evolvable enumeration sentinel value. Don't use.         |
+| regionalInaccessibleCloudPcTrendReport | Indicates the weekly regional aggregated report of inaccessible Cloud PC trends. |
 
 ## Response
 
 If successful, this method returns a `200 OK` response code and a Stream object in the response body.
 
 ## Examples
 
-### Request
+### Example 1: Get reports of inaccessible Cloud PCs in a specific region
+
+The following example shows how to get reports of inaccessible Cloud PCs in a specific region.
+
+#### Request
 
 The following example shows a request.
 
@@ -142,7 +148,7 @@ Content-length: 199
 
 ---
 
-### Response
+#### Response
 
 The following example shows the response.
 <!-- {
@@ -240,3 +246,78 @@ Content-Type: application/octet-stream
 }
 ```
 
+### Example 2: Get the weekly regional aggregated report of inaccessible Cloud PC trends
+
+The following example shows how to get the weekly regional aggregated report of inaccessible Cloud PC trends.
+
+#### Request
+
+The following example shows a request.
+
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/getInaccessibleCloudPcReports
+Content-Type: application/json
+Prefer: include-unknown-enum-members
+
+{
+  "reportName": "regionalInaccessibleCloudPcTrendReport",
+  "filter": "",
+  "select": [
+    "HostRegionName",
+    "CloudPcCount",
+    "WeeklyPeakInaccessibleCloudPcCount",
+    "Last24hPeakInaccessibleCloudPcCount",
+    "WeeklyInaccessibleTrend"
+  ],
+  "search": "",
+  "skip": 0,
+  "top": 50
+}
+```
+
+#### Response
+
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "Edm.Stream"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/octet-stream
+
+{
+  "TotalRowCount": 2,
+  "Schema": [
+    {
+      "Column": "HostRegionName",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "CloudPcCount",
+      "PropertyType": "Int64"
+    },
+    {
+      "Column": "WeeklyPeakInaccessibleCloudPcCount",
+      "PropertyType": "Int64"
+    },
+    {
+      "Column": "Last24hPeakInaccessibleCloudPcCount",
+      "PropertyType": "Int64"
+    },
+    {
+      "Column": "WeeklyInaccessibleTrend",
+      "PropertyType": "String"
+    }
+  ],
+  "Values": [
+    [ "Japan East", 46, 10, 5, "Increasing" ],
+    [ "East US", 1, 0, 0, "Decreasing" ]
+  ]
+}
+```
+
diff --git a/api-reference/beta/api/cloudpcreports-post-exportjobs.md b/api-reference/beta/api/cloudpcreports-post-exportjobs.md
@@ -50,7 +50,7 @@ You can specify the following properties when you create a **cloudPcExportJob**.
 |:---|:---|:---|
 |filter|String|The filter applied on the report. Optional.|
 |format|String|The format of the exported report. Optional.|
-|reportName|[cloudPcReportName](../resources/cloudpcexportjob.md#cloudpcreportname-values)|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`, `performanceTrendReport`, `inaccessibleCloudPcTrendReport`, `regionalConnectionQualityTrendReport`, `regionalConnectionQualityInsightsReport`, `remoteConnectionQualityReport`, `cloudPcInsightReport`. Use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`, `performanceTrendReport`, `inaccessibleCloudPcTrendReport`, `regionalConnectionQualityTrendReport`, `regionalConnectionQualityInsightsReport`, `remoteConnectionQualityReport`, `cloudPcInsightReport`.|
+|reportName|[cloudPcReportName](../resources/cloudpcexportjob.md#cloudpcreportname-values)|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`, `performanceTrendReport`, `inaccessibleCloudPcTrendReport`, `regionalConnectionQualityTrendReport`, `regionalConnectionQualityInsightsReport`, `remoteConnectionQualityReport`, `cloudPcInsightReport`, `regionalInaccessibleCloudPcTrendReport`. Use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`, `performanceTrendReport`, `inaccessibleCloudPcTrendReport`, `regionalConnectionQualityTrendReport`, `regionalConnectionQualityInsightsReport`, `remoteConnectionQualityReport`, `cloudPcInsightReport`, `regionalInaccessibleCloudPcTrendReport`.|
 |select|String collection|The selected columns of the report. Optional.|
 
 ## Response
diff --git a/api-reference/beta/resources/cloudpcexportjob.md b/api-reference/beta/resources/cloudpcexportjob.md
@@ -33,7 +33,7 @@ Represents the export job for downloading a specified Cloud PC report.
 | filter             | String                                                   | The filter applied on the report.                                                                                                                                                       |
 | format             | String                                                   | The format of the exported report.                                                                                                                                                      |
 | id                 | String                                                   | The unique identifier for the report. Read-only.                                                                                                                                        |
-| reportName         | [cloudPcReportName](#cloudpcreportname-values)           | The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `actionStatusReport`, `rawRemoteConnectionReports`, `cloudPcUsageCategoryReports`, `crossRegionDisasterRecoveryReport`, `regionalConnectionQualityTrendReport`, `regionalConnectionQualityInsightsReport`, `remoteConnectionQualityReport`, `bulkActionStatusReport`, `cloudPcInsightReport`. Use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `rawRemoteConnectionReports`, `cloudPcUsageCategoryReports`, `crossRegionDisasterRecoveryReport`, `cloudPcInsightReport`.|
+| reportName         | [cloudPcReportName](#cloudpcreportname-values)           | The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `actionStatusReport`, `rawRemoteConnectionReports`, `cloudPcUsageCategoryReports`, `crossRegionDisasterRecoveryReport`, `regionalConnectionQualityTrendReport`, `regionalConnectionQualityInsightsReport`, `remoteConnectionQualityReport`, `bulkActionStatusReport`, `cloudPcInsightReport`, `regionalInaccessibleCloudPcTrendReport`. Use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `rawRemoteConnectionReports`, `cloudPcUsageCategoryReports`, `crossRegionDisasterRecoveryReport`, `cloudPcInsightReport`, `regionalInaccessibleCloudPcTrendReport`.|
 | requestDateTime    | DateTimeOffset                                           | The date and time when the export job was requested.  |
 | select             | String collection                                        | The selected columns of the report.   |
 
@@ -73,6 +73,7 @@ Represents the export job for downloading a specified Cloud PC report.
 | remoteConnectionQualityReport               | The overall connection quality reports for all devices under a tenant.   |
 | bulkActionStatusReport               | The details of Cloud PC bulk actions, including bulk action status, name, type, state, completion state, and request date time.   |
 | cloudPcInsightReport                     | Indicates Cloud PC-level configuration data and troubleshooting data with insights, including client version, client operating system, host region, Teams media, error source, error code symbolic, and error message. |
+| regionalInaccessibleCloudPcTrendReport      | The weekly regional aggregated report of inaccessible Cloud PC trends.    |
 
 ## Relationships
 
diff --git a/api-reference/beta/resources/enums.md b/api-reference/beta/resources/enums.md
@@ -5000,6 +5000,7 @@ Possible values for user account types (group membership), per Windows definitio
 | inaccessibleCloudPcReports     |
 | inaccessibleCloudPcTrendReport |
 | unknownFutureValue             |
+| regionalInaccessibleCloudPcTrendReport |
 
 ### nonAdminSetting values
 
diff --git a/changelog/Microsoft.CloudManagedDesktop.json b/changelog/Microsoft.CloudManagedDesktop.json
@@ -58,6 +58,32 @@
       "WorkloadArea": "Device and app management",
       "SubArea": "Cloud PC"
     },
+    {
+      "ChangeList": [
+        {
+          "Id": "2e32a5b5-133e-45f4-9978-53c81843ca6d",
+          "ApiChange": "Member",
+          "ChangedApiName": "regionalInaccessibleCloudPcTrendReport",
+          "ChangeType": "Addition",
+          "Description": "Added the `regionalInaccessibleCloudPcTrendReport` member to the **cloudPCInaccessibleReportName** enumeration.",
+          "Target": "cloudPCInaccessibleReportName"
+        },
+        {
+          "Id": "2e32a5b5-133e-45f4-9978-53c81843ca6d",
+          "ApiChange": "Member",
+          "ChangedApiName": "regionalInaccessibleCloudPcTrendReport",
+          "ChangeType": "Addition",
+          "Description": "Added the `regionalInaccessibleCloudPcTrendReport` member to the **cloudPcReportName** enumeration.",
+          "Target": "cloudPcReportName"
+        }
+      ],
+      "Id": "2e32a5b5-133e-45f4-9978-53c81843ca6d",
+      "Cloud": "Prod",
+      "Version": "beta",
+      "CreatedDateTime": "2025-02-14T20:16:26.0746374Z",
+      "WorkloadArea": "Device and app management",
+      "SubArea": "Cloud PC"
+    },
     {
       "ChangeList": [
         {
@@ -787,7 +813,7 @@
       "Cloud": "Prod",
       "Version": "beta",
       "CreatedDateTime": "2024-07-22T07:08:27.3298762Z",
-      "WorkloadArea": "Devices and apps",
+      "WorkloadArea": "Device and app management",
       "SubArea": "Cloud PC"
     },
     {
@@ -5715,7 +5741,7 @@
       "Cloud": "Prod",
       "Version": "beta",
       "CreatedDateTime": "2023-12-07T11:14:41.3424906Z",
-      "WorkloadArea": "Devices and apps",
+      "WorkloadArea": "Device and app management",
       "SubArea": "Cloud PC"
     },
     {
@@ -6361,7 +6387,7 @@
       "Cloud": "Prod",
       "Version": "beta",
       "CreatedDateTime": "2024-10-21T08:35:28.2259205Z",
-      "WorkloadArea": "Devices and apps",
+      "WorkloadArea": "Device and app management",
       "SubArea": "Cloud PC"
     },
     {
@@ -6379,7 +6405,7 @@
       "Cloud": "Prod",
       "Version": "beta",
       "CreatedDateTime": "2024-11-27T06:03:45.3975846Z",
-      "WorkloadArea": "Devices and apps",
+      "WorkloadArea": "Device and app management",
       "SubArea": "Cloud PC"
     },
     {
diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md
@@ -43,6 +43,10 @@ Added [teamsMessageEvidence](/graph/api/resources/security-teamsmessageevidence)
 
 Added the **itemsToInclude**, **cloudAttachmentVersion**, **documentVersion**, **additionalDataOptions**, and **statisticsOptions** as supported properties and parameters across various resources and actions of the eDiscovery API.
 
+### Device and app management | Cloud PC
+
+[Get the weekly regional aggregated report of inaccessible Cloud PC trends](/graph/api/cloudpcreports-getinaccessiblecloudpcreports?view=graph-rest-beta&&preserve-view=true#example-2-get-the-weekly-regional-aggregated-report-of-inaccessible-cloud-pc-trends).
+
 ### Identity and access | Identity and sign-in
 
 Replaced the following API operations for managing custom authentication extensions:
@@ -105,6 +109,7 @@ Enabled change notifications support to the methods to [list](/graph/api/subscri
 - [Retry](/graph/api/cloudpcbulkaction-retry?view=graph-rest-beta&preserve-view=true) a bulk action with selected Cloud PCs.
 - Use the **productType** property on [cloudPC](/graph/api/resources/cloudpc?view=graph-rest-beta&preserve-view=true) to get the product type of a Cloud PC or to filter Cloud PCs by product type.
 - Deprecated the [getCloudPcPerformanceReport](/graph/api/cloudpcreports-getcloudpcperformancereport?view=graph-rest-beta&preserve-view=true) method of the [cloudPcReports](/graph/api/resources/cloudpcreports?view=graph-rest-beta&preserve-view=true) resource in favor of the [retrieveCloudPcTenantMetricsReport](/graph/api/cloudpcreports-retrievecloudpctenantmetricsreport?view=graph-rest-beta&preserve-view=true) method.
+- [Get the weekly regional aggregated report of inaccessible Cloud PC trends](/graph/api/cloudpcreports-getinaccessiblecloudpcreports?view=graph-rest-beta&&preserve-view=true#example-2-get-the-weekly-regional-aggregated-report-of-inaccessible-cloud-pc-trends).
 
 ### Files
 
