Merge branch 'main' into Danielabom-patch-1

Author: Danielabom

api-reference/beta/api/cloudpcreports-getcloudpcperformancereport.md

@@ -1,5 +1,5 @@
 ---
-title: "cloudPcReports: getCloudPCPerformanceReport"
+title: "cloudPcReports: getCloudPCPerformanceReport (deprecated)"
 description: "Get a report related to the performance of Cloud PCs."
 author: "Gutentag0004"
 ms.localizationpriority: medium
@@ -8,14 +8,17 @@ doc_type: apiPageType
 ms.date: 11/30/2024
 ---
 
-# cloudPcReports: getCloudPCPerformanceReport
+# cloudPcReports: getCloudPCPerformanceReport (deprecated)
 
 Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
 Get a report related to the performance of Cloud PCs.
 
+>[!CAUTION] 
+> This API is deprecated and stopped returning data on December 31, 2024. Going forward, use the [retrieveCloudPcTenantMetricsReport](cloudpcreports-retrievecloudpctenantmetricsreport.md) API.
+
 [!INCLUDE [national-cloud-support](../../includes/global-us.md)]
 
 ## Permissions

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`. 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`.|
+|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`.|
 |select|String collection|The selected columns of the report. Optional.|
 
 ## Response

api-reference/beta/api/cloudpcreports-retrievecloudpctenantmetricsreport.md

@@ -0,0 +1,288 @@
+---
+title: "cloudPcReports: retrieveCloudPcTenantMetricsReport"
+description: "Get a report related to the performance of Cloud PCs."
+author: "YanLemon"
+ms.localizationpriority: medium
+ms.subservice: "cloud-pc"
+doc_type: apiPageType
+ms.date: 1/13/2025
+---
+
+# cloudPcReports: retrieveCloudPcTenantMetricsReport
+
+Namespace: microsoft.graph
+
+[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
+
+Get a report related to the performance of Cloud PCs.
+
+[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
+
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "cloudpcreports-retrieveCloudPcTenantMetricsReport" } -->
+[!INCLUDE [permissions-table](../includes/permissions/cloudpcreports-retrievecloudpctenantmetricsreport-permissions.md)]
+
+## HTTP request
+
+<!-- {
+  "blockType": "ignored"
+}
+-->
+``` http
+POST /deviceManagement/virtualEndpoint/reports/retrieveCloudPcTenantMetricsReport
+```
+
+## Request headers
+
+|Name|Description|
+|:---|:---|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that you can use with this method.
+
+| Parameter  | Type                         | Description                                                                                          |
+|:-----------|:-----------------------------|:-----------------------------------------------------------------------------------------------------|
+| filter     | String                       | OData `$filter` syntax. Supported filters are: `and`, `or`, `gt`, and `eq`.                          |
+| 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 | [cloudPCPerformanceReportName](../resources/cloudpcreports.md#cloudpcperformancereportname-values) | The report name. The possible values are: `performanceTrendReport`, `unknownFutureValue`, `cloudPcInsightReport`. 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): `cloudPcInsightReport`. |
+| search     | String                       | Specifies a String to search.                                                                        |
+| select     | String collection            | OData `$select` syntax. The selected columns of the reports.                                         |
+| skip       | Int32                        | Number of records to skip.                                                                           |
+| top        | Int32                        | Specifies the page size. If not defined, the default is 25, with a maximum value of 100.             |
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a Stream object in the response body.
+
+## Examples
+
+### Example 1: Get a performance trend report
+
+The following example shows how to get the performance trend report with daily aggregated data that provides a list of connection quality metrics for Cloud PCs over the past seven days within a tenant.
+
+#### Request
+
+The following example shows a request.
+
+<!-- {
+  "blockType": "request",
+  "name": "cloudpcreportsthis.retrieveCloudPcTenantMetricsReport.performanceTrendReport"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/retrieveCloudPcTenantMetricsReport
+Content-Type: application/json
+
+{
+  "reportName": "performanceTrendReport",
+  "filter": "EventDateTime gt datetime'2023-10-13T00:00:00.000Z'",
+  "select": [
+    "EventDateTime",
+    "SlowRoundTripTimeCloudPcCount",
+    "LowUdpConnectionPercentageCount",
+    "NoActiveTimeConnectedCount",
+    "LowActiveTimeConnectedCount"
+  ],
+  "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": "EventDateTime",
+      "PropertyType": "DateTime"
+    },
+    {
+      "Column": "SlowRoundTripTimeCloudPcCount",
+      "PropertyType": "Int64"
+    },
+    {
+      "Column": "LowUdpConnectionPercentageCount",
+      "PropertyType": "Int64"
+    },
+    {
+      "Column": "NoActiveTimeConnectedCount",
+      "PropertyType": "Int64"
+    },
+    {
+      "Column": "LowActiveTimeConnectedCount",
+      "PropertyType": "Int64"
+    }
+  ],
+  "Values": [
+    [
+      "2023-10-16T00:00:00Z",
+      3,
+      8,
+      3,
+      92
+    ],
+    [
+      "2023-10-15T00:00:00Z",
+      4,
+      6,
+      5,
+      91
+    ]
+  ]
+}
+```
+
+### Example 2: Get a Cloud PC insight report
+
+The following example shows how to get the Cloud PC insight report that provides configuration data and insights at the Cloud PC level.
+
+#### Request
+
+The following example shows a request.
+
+<!-- {
+  "blockType": "request",
+  "name": "cloudpcreportsthis.retrieveCloudPcTenantMetricsReport.cloudPcInsightReport"
+}
+-->
+``` http
+POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/retrieveCloudPcTenantMetricsReport
+
+{
+  "reportName": "cloudPcInsightReport",
+  "filter": "",
+  "select": [
+    "ManagedDeviceName",
+    "DeviceId",
+    "ClientOS",
+    "ClientVersion",
+    "MultimediaRedirectVersion",
+    "TeamsClientVersion",
+    "HostOSVersion",
+    "HostSxSStackVersion",
+    "HostAgentVersion",
+    "PolicyName",
+    "UserSettingName",
+    "HostRegion",
+    "AzureNetworkConnectName"
+  ],
+  "search": "",
+  "skip": 0,
+  "top": 50
+}
+```
+
+#### Response
+
+The following example shows the response.
+
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "Edm.Stream"
+} -->
+``` http
+HTTP/1.1 200 OK
+
+{
+  "TotalRowCount": 1,
+  "Schema": [
+    {
+      "Column": "ManagedDeviceName",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "DeviceId",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "ClientOS",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "ClientVersion",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "MultimediaRedirectVersion",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "TeamsClientVersion",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "HostOSVersion",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "HostOSVersion",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "HostSxSStackVersion",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "HostAgentVersion",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "PolicyName",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "UserSettingName",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "HostRegion",
+      "PropertyType": "String"
+    },
+    {
+      "Column": "AzureNetworkConnectName",
+      "PropertyType": "String"
+    }
+  ],
+  "Values": [
+    [
+      "CPC_96718d38-74ef-4026-8d54-508d52901763",
+      "96718d38-74ef-4026-8d54-508d52901763",
+      "Windows 10",
+      "2.0.02817.898",
+      "1.0.2311.2004",
+      "1.7.00.26062",
+      "10.0.22631.4169",
+      "rdp-sxs240705700",
+      "1.0.9742.1900_release",
+      "zengyantestPolicy",
+      "mingjunTest",
+      "eastus",
+      "CRUD_TestIntuneAdminWSubReader"
+    ]
+  ]
+}
+```

api-reference/beta/api/filestoragecontainer-lock.md

@@ -1,6 +1,6 @@
 ---
 title: "fileStorageContainer: lock"
-description: "Lock a fileStorageContainer."
+description: "Lock a fileStorageContainer to prevent modifications to its content."
 author: "javieralvarezchiang"
 ms.localizationpriority: medium
 ms.subservice: "onedrive"
@@ -14,7 +14,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Lock a [fileStorageContainer](../resources/filestoragecontainer.md) to prevent users from adding, updating, or deleting content.
+Lock a [fileStorageContainer](../resources/filestoragecontainer.md) to prevent modifications to its content.
 
 This action updates the [lockState](../resources/enums.md#sitelockstate-values).
 

api-reference/beta/api/filestoragecontainer-restore.md

@@ -59,6 +59,7 @@ If successful, this action returns a `200 OK` response code and a [fileStorageCo
 
 The following example shows a request.
 
+# [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
   "name": "filestoragecontainerthis.restore"
@@ -68,6 +69,36 @@ The following example shows a request.
 POST https://graph.microsoft.com/beta/storage/fileStorage/deletedContainers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/restore
 ```
 
+# [C#](#tab/csharp)
+[!INCLUDE [sample-code](../includes/snippets/csharp/filestoragecontainerthisrestore-csharp-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [CLI](#tab/cli)
+[!INCLUDE [sample-code](../includes/snippets/cli/filestoragecontainerthisrestore-cli-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Go](#tab/go)
+[!INCLUDE [sample-code](../includes/snippets/go/filestoragecontainerthisrestore-go-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Java](#tab/java)
+[!INCLUDE [sample-code](../includes/snippets/java/filestoragecontainerthisrestore-java-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [JavaScript](#tab/javascript)
+[!INCLUDE [sample-code](../includes/snippets/javascript/filestoragecontainerthisrestore-javascript-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [PHP](#tab/php)
+[!INCLUDE [sample-code](../includes/snippets/php/filestoragecontainerthisrestore-php-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Python](#tab/python)
+[!INCLUDE [sample-code](../includes/snippets/python/filestoragecontainerthisrestore-python-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+---
+
 
 ### Response