cloudPC : renommer
Espace de noms: microsoft.graph
Renommez un objet cloudPC spécifique. Utilisez cette API pour mettre à jour le displayName d’une entité PC cloud.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | CloudPC.ReadWrite.All | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | CloudPC.ReadWrite.All | Non disponible. |
Requête HTTP
Pour renommer le cloudPC spécifié dans le organization, à l’aide de l’autorisation déléguée (l’utilisateur connecté doit être l’administrateur) ou de l’autorisation d’application :
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/rename
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Content-Type | application/json. Obligatoire. |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON des paramètres.
Le tableau suivant montre le paramètre que vous pouvez utiliser avec cette action.
Propriété | Type | Description |
---|---|---|
displayName | Chaîne | Nouveau nom d’affichage du PC cloud. |
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 204 No Content
.
Exemples
Demande
L’exemple suivant montre une demande de renommage d’un PC cloud pour l’administrateur.
POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/c2bbb5dd-2574-451b-a508-bbaa6ac48ace/rename
Content-Type: application/json
{
displayName: "Cloud PC-HR"
}
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 204 No Content