cloudPC: cambiar el nombre
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta
de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Cambie el nombre de un equipo en la nube específico. Use esta API para actualizar displayName para la entidad pc en la nube.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
---|---|---|
Delegado (cuenta profesional o educativa) | CloudPC. ReadWrite. All | No disponible. |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | CloudPC. ReadWrite. All | No disponible. |
Solicitud HTTP
Para cambiar el nombre de cloudPC del usuario especificado (que es el usuario que inició sesión) en la organización mediante el permiso delegado:
POST /me/cloudPCs/{cloudPCId}/rename
POST /users/{userId}/cloudPCs/{cloudPCId}/rename
Para cambiar el nombre de cloudPC especificado en la organización, use el permiso delegado (el usuario que inició sesión debe ser el administrador) o el permiso de aplicación:
POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/rename
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Content-Type | application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON de los parámetros.
La siguiente tabla muestra los parámetros que se pueden usar con esta acción.
Propiedad | Tipo | Descripción |
---|---|---|
displayName | Cadena | Nuevo nombre para mostrar del equipo en la nube. |
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content
.
Ejemplos
Ejemplo 1: Cambiar el nombre de cloudPC para el administrador
Solicitud
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/c2bbb5dd-2574-451b-a508-bbaa6ac48ace/rename
Content-Type: application/json
{
displayName: "Cloud PC-HR"
}
Respuesta
HTTP/1.1 204 No Content
Ejemplo 2: Cambiar el nombre de cloudPC para el usuario que ha iniciado sesión
Solicitud
POST https://graph.microsoft.com/beta/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002/rename
Respuesta
HTTP/1.1 204 No Content
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de