Added the osVersionNumber and sizeInGB properties to the cloudPcDevic… (#28307)

* Added the osVersionNumber and sizeInGB properties to the cloudPcDeviceImage resource and added the osVersionNumber property to the cloudPcGalleryImage resource.

* Update what's new overview with Cloud PC features

Added new properties for Cloud PC management and updated admin consent requirements for SharePoint permissions.

* Update whats-new-overview.md

* Update release date from February to March 2026

* Apply suggestion from @FaithOmbongi

* Update what's new, fix merge conflict

* Readd what's new

---------

Co-authored-by: Sitao Lu <sitaolu@microsoft.com>
Co-authored-by: MSFT-Andrea <v-andreadr@microsoft.com>
Co-authored-by: Faith Moraa Ombongi <ombongi.moraa.fe@gmail.com>

Author: 4 people

api-reference/v1.0/api/cloudpcdeviceimage-get.md

@@ -127,6 +127,8 @@ Content-Type: application/json
   "sourceImageResourceId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.Compute/images/exampleImageForDev",
   "lastModifiedDateTime": "2023-11-03T07:03:44.97Z",
   "status": "ready",
-  "errorCode": null
+  "errorCode": null,
+  "osVersionNumber": "10.0.22631.3593",
+  "sizeInGB": 64
 }
 ```

api-reference/v1.0/api/cloudpcgalleryimage-get.md

@@ -126,6 +126,7 @@ Content-Type: application/json
   "sizeInGB": 64,
   "startDate": "2024-9-30",
   "endDate": "2027-10-11",
-  "expirationDate": "2028-04-11"
+  "expirationDate": "2028-04-11",
+  "osVersionNumber": "10.0.26100.0"
 }
 ```

api-reference/v1.0/api/virtualendpoint-list-deviceimages.md

@@ -129,7 +129,9 @@ Content-Type: application/json
       "sourceImageResourceId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.Compute/images/exampleImageForDev",
       "lastModifiedDateTime": "2024-11-03T07:03:44.97Z",
       "status": "ready",
-      "errorCode": null
+      "errorCode": null,
+      "osVersionNumber": "10.0.22631.3593",
+      "sizeInGB": 64
     }
   ]
 }

api-reference/v1.0/api/virtualendpoint-list-galleryimages.md

@@ -127,7 +127,8 @@ Content-Type: application/json
       "sizeInGB": 64,
       "startDate": "2023-10-31",
       "endDate": "2026-11-10",
-      "expirationDate": "2027-05-10"
+      "expirationDate": "2027-05-10",
+      "osVersionNumber": "10.0.22631.0"
     },
     {
       "id": "microsoftwindowsdesktop_windows-ent-cpc_win11-24H2-ent-cpc",
@@ -139,7 +140,8 @@ Content-Type: application/json
       "sizeInGB": 64,
       "startDate": "2024-09-30",
       "endDate": "2027-10-11",
-      "expirationDate": "2028-04-11"
+      "expirationDate": "2028-04-11",
+      "osVersionNumber": "10.0.26100.0"
     }
   ]
 }

api-reference/v1.0/api/virtualendpoint-post-deviceimages.md

@@ -141,6 +141,8 @@ Content-Type: application/json
   "status": "pending",
   "errorCode": null,
   "osStatus": null,
-  "expirationDate": null
+  "expirationDate": null,
+  "osVersionNumber": null,
+  "sizeInGB": 64
 }
 ```

api-reference/v1.0/resources/cloudpcdeviceimage.md

@@ -38,6 +38,8 @@ Inherits from [entity](../resources/entity.md).
 |operatingSystem|String|The operating system (OS) of the image. For example, `Windows 11 Enterprise`. Read-only.|
 |osBuildNumber|String|The OS build version of the image. For example, `1909`. Read-only.|
 |osStatus|[cloudPcDeviceImageOsStatus](#cloudpcdeviceimageosstatus-values)|The OS status of this image. The possible values are: `supported`, `supportedWithWarning`, `unknown`, `unknownFutureValue`. The default value is `unknown`. Read-only.|
+|osVersionNumber|String|The operating system version of this image. For example, `10.0.22000.296`. Read-only.|
+|sizeInGB|Int32|The size of the image in GB. For example, `64`. Read-only.|
 |sourceImageResourceId|String|The unique identifier (ID) of the source image resource on Azure. The required ID format is: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}". Read-only.|
 |status|[cloudPcDeviceImageStatus](#cloudpcdeviceimagestatus-values)|The status of the image on the Cloud PC. The possible values are: `pending`, `ready`, `failed`, `unknownFutureValue`. Read-only.|
 |version|String|The image version. For example, `0.0.1` and `1.5.13`. Read-only.|
@@ -102,6 +104,8 @@ The following JSON representation shows the resource type.
   "operatingSystem": "String",
   "osBuildNumber": "String",
   "osStatus": "String",
+  "osVersionNumber": "String",
+  "sizeInGB": "Int32",
   "sourceImageResourceId": "String",
   "status": "String",
   "version": "String"

api-reference/v1.0/resources/cloudpcgalleryimage.md

@@ -32,6 +32,7 @@ Inherits from [entity](../resources/entity.md).
 |expirationDate|Date|The date when the image is no longer available. Users are unable to provision new Cloud PCs if the current time is later than **expirationDate**. The value is usually **endDate** plus six months. For example, if the **startDate** is `2025-10-14`, the **expirationDate** is usually `2026-04-14`. Read-only.|
 |id|String|The unique identifier (ID) of the gallery image resource on Cloud PC. The ID format is {publisherName_offerName_skuName}. For example, `MicrosoftWindowsDesktop_windows-ent-cpc_win11-22h2-ent-cpc-m365`. You can find the **publisherName**, **offerName**, and **skuName** in the Azure Marketplace. Inherited from [entity](../resources/entity.md). Read-only.|
 |offerName|String|The offer name of this gallery image that is passed to Azure Resource Manager (ARM) to retrieve the image resource. Read-only.|
+|osVersionNumber|String|The operating system version of this gallery image. For example, `10.0.22000.296`. Read-only.|
 |publisherName|String|The publisher name of this gallery image that is passed to Azure Resource Manager (ARM) to retrieve the image resource. Read-only.|
 |sizeInGB|Int32|Indicates the size of this image in gigabytes. For example, `64`. Read-only.|
 |skuName|String|The SKU name of this image that is passed to Azure Resource Manager (ARM) to retrieve the image resource. Read-only.|
@@ -71,6 +72,7 @@ The following JSON representation shows the resource type.
   "expirationDate": "String (Date)",
   "id": "String (identifier)",
   "offerName": "String",
+  "osVersionNumber": "String",
   "publisherName": "String",
   "sizeInGB": "Int32",
   "skuName": "String",

changelog/Microsoft.CloudManagedDesktop.json

@@ -176,6 +176,40 @@
       "WorkloadArea": "Devices and app management",
       "SubArea": "Cloud PC"
     },
+    {
+      "ChangeList": [
+        {
+          "Id": "8fd3fd60-1c7c-4874-930c-9e62eb206c2f",
+          "ApiChange": "Property",
+          "ChangedApiName": "osVersionNumber",
+          "ChangeType": "Addition",
+          "Description": "Added the **osVersionNumber** property to the [cloudPcDeviceImage](https://learn.microsoft.com/en-us/graph/api/resources/cloudpcdeviceimage?view=graph-rest-1.0) resource.",
+          "Target": "cloudPcDeviceImage"
+        },
+        {
+          "Id": "8fd3fd60-1c7c-4874-930c-9e62eb206c2f",
+          "ApiChange": "Property",
+          "ChangedApiName": "sizeInGB",
+          "ChangeType": "Addition",
+          "Description": "Added the **sizeInGB** property to the [cloudPcDeviceImage](https://learn.microsoft.com/en-us/graph/api/resources/cloudpcdeviceimage?view=graph-rest-1.0) resource.",
+          "Target": "cloudPcDeviceImage"
+        },
+        {
+          "Id": "8fd3fd60-1c7c-4874-930c-9e62eb206c2f",
+          "ApiChange": "Property",
+          "ChangedApiName": "osVersionNumber",
+          "ChangeType": "Addition",
+          "Description": "Added the **osVersionNumber** property to the [cloudPcGalleryImage](https://learn.microsoft.com/en-us/graph/api/resources/cloudpcgalleryimage?view=graph-rest-1.0) resource.",
+          "Target": "cloudPcGalleryImage"
+        }
+      ],
+      "Id": "8fd3fd60-1c7c-4874-930c-9e62eb206c2f",
+      "Cloud": "Prod",
+      "Version": "v1.0",
+      "CreatedDateTime": "2026-03-24T00:00:00Z",
+      "WorkloadArea": "Devices and app management",
+      "SubArea": "Cloud PC"
+    },
     {
       "ChangeList": [
         {

concepts/whats-new-overview.md

@@ -24,6 +24,11 @@ For details about previous updates to Microsoft Graph, see [Microsoft Graph what
 
 Using the **signInAudience** property to limit where an [application](/graph/api/resources/application) can be used **isn't** a replacement for proper tenant validation and authorization enforcement in your application code. If your application expects access only in specific tenants, you *must* enforce that validation in your application code. To learn more, see [Secure applications and APIs by validating claims](/entra/identity-platform/claims-validation).
 
+### Device and app management | Cloud PC
+
+- Use the **osVersionNumber** property on [cloudPcDeviceImage](/graph/api/resources/cloudpcdeviceimage) and [cloudPcGalleryImage](/graph/api/resources/cloudpcgalleryimage) resources to get the operating system version of an image.
+- Use the **sizeInGB** property on [cloudPcDeviceImage](/graph/api/resources/cloudpcdeviceimage) to get the size of the image in GB.
+
 ### Files
 
 - Use the following new container columns APIs added to further support structured file storage in SharePoint Embedded applications: