virtualEndpoint 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.

The virtualEndpoint resource represents a container for APIs to manage cloud PC.

Use the cloud PC API to provision and manage virtual desktops for employees in an organization. Use it in conjunction with the Intune API to manage physical and virtual endpoints.


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
Get effective permissions String collection View the effective permissions of the currently authenticated user.
List cloudPCs cloudPC collection List properties and relationships of the cloudPC objects.
List deviceImages cloudPcDeviceImage collection List the properties and relationships of cloudPcDeviceImage objects.
Create cloudPcDeviceImage cloudPcDeviceImage Create a new cloudPcDeviceImage object.
List onPremisesConnections cloudPcOnPremisesConnection collection List properties and relationships of the cloudPcOnPremisesConnection objects.
Create cloudPcOnPremisesConnection cloudPcOnPremisesConnection Create a new cloudPcOnPremisesConnection object.
List provisioningPolicies cloudPcProvisioningPolicy collection List properties and relationships of the cloudPcProvisioningPolicy objects.
Create cloudPcProvisioningPolicy cloudPcProvisioningPolicy Create a new cloudPcProvisioningPolicy object.


Property Type Description
id String The unique identifier for the virtual endpoint id. Read-only.


Relationship Type Description
cloudPCs cloudPC collection Cloud managed virtual desktops.
deviceImages cloudPcDeviceImage collection The image resource on cloud PC.
onPremisesConnections cloudPcOnPremisesConnection collection A defined collection of Azure resource information that can be used to establish on-premises network connectivity for cloud PCs.
provisioningPolicies cloudPcProvisioningPolicy collection cloud PC provisioning policy.

JSON representation

The following is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.virtualEndpoint",
  "id": "string"