Merge pull request #27788 from microsoftgraph/users/sitaolu/cloudPcDeviceImage_getSourceImages_doc_update

FaithOmbongi · web-flow · commit 24c3a8806a7a · 2026-01-20T13:02:17.000+03:00
Add category field to cloudpcsourcedeviceimage and adding filter to g…
diff --git a/api-reference/beta/api/cloudpcdeviceimage-getsourceimages.md b/api-reference/beta/api/cloudpcdeviceimage-getsourceimages.md
@@ -36,6 +36,10 @@ Choose the permission or permissions marked as least privileged for this API. Us
 GET /deviceManagement/virtualEndpoint/deviceImages/getSourceImages
 ```
 
+## Optional query parameters
+
+This method supports the `$filter` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
 ## Request headers
 
 |Name|Description|
@@ -48,11 +52,15 @@ Don't supply a request body for this method.
 
 ## Response
 
-If successful, this function returns a `200 OK` response code and a [cloudPcSourceDeviceImage](../resources/cloudpcsourcedeviceimage.md) collection in the response body.
+If successful, this function returns a `200 OK` response code and a collection of [cloudPcSourceDeviceImage](../resources/cloudpcsourcedeviceimage.md) objects in the response body.
 
 ## Examples
 
-### Request
+### Example 1: Get cloudPcSourceDeviceImage objects without any query parameters
+
+The following example shows how to get **cloudPcSourceDeviceImage** objects without any query parameters.
+
+#### Request
 
 The following example shows a request.
 
@@ -93,7 +101,63 @@ GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/deviceImag
 
 ---
 
-### Response
+#### Response
+
+The following example shows the response.
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "Collection(microsoft.graph.cloudPcSourceDeviceImage)"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+  "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.cloudPcSourceDeviceImage)",
+  "value": [
+    {
+      "id": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.Compute/images/exampleImageForDev",
+      "resourceId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.Compute/images/exampleImageForDev",
+      "displayName": "exampleImageForDev",
+      "subscriptionId": "0ac520ee-14c0-480f-b6c9-0a90c585ffff",
+      "subscriptionDisplayName": "Reserved for IT",
+      "category": "managedImage"
+    },
+    {
+      "id": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.Compute/galleries/exampleGallery/images/exampleImageForDev/versions/1.0.0",
+      "resourceId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.Compute/galleries/exampleGallery/images/exampleImageForDev/versions/1.0.0",
+      "displayName": "1.0.0",
+      "subscriptionId": "0ac520ee-14c0-480f-b6c9-0a90c585ffff",
+      "subscriptionDisplayName": "Reserved for IT",
+      "category": "azureComputeGallery"
+    }
+  ]
+}
+```
+
+### Example 2: Get cloudPcSourceDeviceImage objects with a specific category
+
+The following example shows how to get **cloudPcSourceDeviceImage** objects with a specific category.
+
+#### Request
+
+The following example shows a request.
+
+<!-- {
+  "blockType": "request",
+  "name": "cloudpcdeviceimage_getsourceimageswithcategory"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/deviceImages/getSourceImages?$filter=category eq 'managedImage'
+```
+
+#### Response
 
 The following example shows the response.
 
@@ -117,7 +181,8 @@ Content-Type: application/json
       "resourceId": "/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.Compute/images/exampleImageForDev",
       "displayName": "exampleImageForDev",
       "subscriptionId": "0ac520ee-14c0-480f-b6c9-0a90c585ffff",
-      "subscriptionDisplayName": "Reserved for IT"
+      "subscriptionDisplayName": "Reserved for IT",
+      "category": "managedImage"
     }
   ]
 }
diff --git a/api-reference/beta/resources/cloudpcsourcedeviceimage.md b/api-reference/beta/resources/cloudpcsourcedeviceimage.md
@@ -20,12 +20,21 @@ Represents the source image associated with your Azure subscription.
 
 |Property|Type|Description|
 |:---|:---|:---|
+|category|[cloudPcSourceImageCategory](#cloudpcsourceimagecategory-values)|The category of the source image that is requested. Possible values are: `managedImage`, `azureComputeGallery`, `unknownFutureValue`. The default value is `managedImage`. Read-only.|
 |displayName|String|The display name for the source image. Read-only.|
 |resourceId|String| The fully qualified unique identifier (ID) of the source image resource in Azure. The ID format is: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}". Read-only.|
 |subscriptionDisplayName|String|The display name of the subscription that hosts the source image. Read-only.|
 |subscriptionId|String|The unique identifier (ID) of the subscription that hosts the source image. Read-only.|
 |id (deprecated)|String|The unique identifier (ID) of the source image. Read-only. The **id** property is deprecated and will stop returning data on January 31, 2024. Going forward, use the **resourceId** property.|
 
+### cloudPcSourceImageCategory values
+
+|Member|Description|
+|:---|:---|
+|managedImage|Indicates that the source image is from a managed image.|
+|azureComputeGallery|Indicates that the source image is from an Azure compute gallery.|
+|unknownFutureValue|Evolvable enumeration sentinel value. Don't use.|
+
 ## Relationships
 
 None.
@@ -42,6 +51,7 @@ The following JSON representation shows the resource type.
 ``` json
 {
   "@odata.type": "#microsoft.graph.cloudPcSourceDeviceImage",
+  "category": "String",
   "displayName": "String",
   "id": "String (identifier)",
   "resourceId": "String (identifier)",
diff --git a/changelog/Microsoft.CloudManagedDesktop.json b/changelog/Microsoft.CloudManagedDesktop.json
@@ -1,5 +1,31 @@
 {
   "changelog": [
+    {
+      "ChangeList": [
+        {
+          "Id": "b88cc6c6-4eff-4a61-9835-9086446bdcb6",
+          "ApiChange": "Enumeration",
+          "ChangedApiName": "cloudPcSourceImageCategory",
+          "ChangeType": "Addition",
+          "Description": "Added the **cloudPcSourceImageCategory** enumeration type.",
+          "Target": "cloudPcSourceImageCategory"
+        },
+        {
+          "Id": "b88cc6c6-4eff-4a61-9835-9086446bdcb6",
+          "ApiChange": "Property",
+          "ChangedApiName": "category",
+          "ChangeType": "Addition",
+          "Description": "Added the **category** property to the [cloudPcSourceDeviceImage](https://learn.microsoft.com/en-us/graph/api/resources/cloudPcSourceDeviceImage?view=graph-rest-beta) resource.",
+          "Target": "cloudPcSourceDeviceImage"
+        }
+      ],
+      "Id": "b88cc6c6-4eff-4a61-9835-9086446bdcb6",
+      "Cloud": "Prod",
+      "Version": "beta",
+      "CreatedDateTime": "2026-01-21T02:49:22.7461765Z",
+      "WorkloadArea": "Devices and app management",
+      "SubArea": "Cloud PC"
+    },
     {
       "ChangeList": [
         {
diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md
@@ -44,6 +44,7 @@ The `TeamsAppInstallation.ManageSelectedForTeam.All` is the least privileged app
 
 - Added `mexico` as a new supported value for the **cloudPcGeographicLocationType** enumeration type. This enum is the return type for the **geographicLocationType** property on [cloudPcDomainJoinConfiguration](/graph/api/resources/cloudpcdomainjoinconfiguration?view=graph-rest-beta&preserve-view=true) and [cloudPcSupportedRegion](/graph/api/resources/cloudpcsupportedregion?view=graph-rest-beta&preserve-view=true).
 - Added the `cloudPCInventoryReport` member to the **cloudPcReportName** enumeration type. This enum is the return type for the **reportName** property on [cloudPcExportJob](/graph/api/resources/cloudPcExportJob?view=graph-rest-beta&preserve-view=true),  [getFrontlineReport action](/graph/api/resources/cloudpcreports-getfrontlinereport?view=graph-rest-beta&preserve-view=true), and [getCloudPcRecommendationReports action](/graph/api/resources/cloudpcreports-getcloudpcrecommendationreports?view=graph-rest-beta&preserve-view=true).
+- Use the **category** property on [cloudPcSourceDeviceImage](/graph/api/resources/cloudpcsourcedeviceimage?view=graph-rest-beta&preserve-view=true) to get the category of the source image that is requested. For more information, see [Get cloudPcSourceDeviceImage objects with a specific category](/graph/api/cloudpcdeviceimage-getsourceimages?view=graph-rest-beta&preserve-view=true#example-2-get-cloudpcsourcedeviceimage-objects-with-a-specific-category).
 
 ### Message trace
 
