| title | cloudPC: rename |
|---|---|
| description | Rename a specific cloudPC object. |
| author | xhhzuikeaiya |
| ms.localizationpriority | medium |
| ms.subservice | cloud-pc |
| doc_type | apiPageType |
| ms.date | 04/18/2024 |
Namespace: microsoft.graph
Rename a specific cloudPC object. Use this API to update the displayName of a Cloud PC entity.
[!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]
To rename the specified cloudPC in the organization, using either delegated permission (the signed-in user should be the administrator) or application permission:
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/rename| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
| Content-Type | application/json. Required. |
In the request body, supply a JSON representation of the parameters.
The following table shows the parameter that you can use with this action.
| Property | Type | Description |
|---|---|---|
| displayName | String | The new display name for the Cloud PC. |
If successful, this method returns a 204 No Content response code.
The following example shows a request to rename a Cloud PC for the administrator.
POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/c2bbb5dd-2574-451b-a508-bbaa6ac48ace/rename
Content-Type: application/json
{
displayName: "Cloud PC-HR"
}[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
HTTP/1.1 204 No Content