cloudPC resource type

Namespace: microsoft.graph


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a cloud-managed virtual desktop.


The cloud PC API is in preview and is currently available only to a select group of customers. Please contact your Modern Workplace GBBs for more information.


Method Return type Description
List cloudPCs cloudPC collection List properties and relationships of the cloudPC objects.
Get cloudPC cloudPC Read the properties and relationships of a cloudPC object.
Reprovision None Reprovision a cloudPC object.


Property Type Description
id String Unique identifier for the cloud PC. Read-only.
displayName String The cloud PC display name.
imageDisplayName String Name of the OS image that's on the cloud PC.
managedDeviceId String The cloud PC’s Intune device ID.
managedDeviceName String The cloud PC’s Intune device name.
provisioningPolicyId String The cloud PC's provisioning policy ID.
servicePlanId String The cloud PC's service plan ID.
servicePlanName String The cloud PC's service plan name.
status cloudPcStatus Status of the cloud PC. Possible values are: notProvisioned, provisioning, provisioned, upgrading, inGracePeriod, deprovisioning, failed.
statusDetails cloudPcStatusDetails The details of the cloud PC status.
userPrincipalName String The user principal name (UPN) of the user assigned to the cloud PC.
lastModifiedDateTime DateTimeOffset The cloud PC's last modified date and time. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.



JSON representation

The following is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.cloudPC",
  "id": "String (identifier)",
  "displayName": "String",
  "imageDisplayName": "String",
  "managedDeviceId": "String",
  "managedDeviceName": "String",
  "provisioningPolicyId": "String",
  "servicePlanId": "String",
  "servicePlanName": "String",
  "status": "String",
  "userPrincipalName": "String",
  "lastModifiedDateTime": "String (timestamp)"