| title | cloudPC: retrieveFrontlineCloudPcDetail |
|---|---|
| description | Get the frontline availability of a frontline Cloud PC. |
| author | AshleyYangSZ |
| ms.localizationpriority | medium |
| ms.subservice | cloud-pc |
| doc_type | apiPageType |
| ms.date | 10/14/2025 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Get the frontlineCloudPcDetail of a frontline Cloud PC.
This API only supports shared-use licenses. For more information, see cloudPcProvisioningPolicy. Shared-use licenses allow three users per license, with one user signed in at a time. Callers can get the latest frontline Cloud PC availability and determine whether the frontline Cloud PC is available to a user.
[!INCLUDE national-cloud-support]
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. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
[!INCLUDE permissions-table]
Get the frontline Cloud PC details such as availability.
GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/retrieveFrontlineCloudPcDetail| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Don't supply a request body for this method.
If successful, this function returns a 200 OK response code and a frontlineCloudPcDetail object in the response body. If the Cloud PC was provisioned as a dedicated device, this method returns a 400 Bad Request response code.
The following example shows a request.
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/88019b18-57ae-4973-98c4-3cd728323887/retrieveFrontlineCloudPcDetail[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.frontlineCloudPcDetail",
"frontlineCloudPcAvailability": "available"
}