cloudPC: umbenennen
Namespace: microsoft.graph
Benennen Sie ein bestimmtes cloudPC-Objekt um. Verwenden Sie diese API, um den displayName einer Cloud-PC-Entität zu aktualisieren.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | CloudPC.ReadWrite.All | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | CloudPC.ReadWrite.All | Nicht verfügbar. |
HTTP-Anforderung
Um den angegebenen cloudPC im organization umzubenennen, verwenden Sie entweder die delegierte Berechtigung (der angemeldete Benutzer sollte der Administrator sein) oder die Anwendungsberechtigung:
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/rename
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.
Die folgende Tabelle zeigt den Parameter, den Sie mit dieser Aktion verwenden können.
Eigenschaft | Typ | Beschreibung |
---|---|---|
displayName | String | Der neue Anzeigename für den Cloud-PC. |
Antwort
Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content
zurückgegeben.
Beispiele
Anforderung
Das folgende Beispiel zeigt eine Anforderung zum Umbenennen eines Cloud-PCs für den 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"
}
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 204 No Content