cloudPC: getCloudPcLaunchInfo (obsoleto)

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.

Precaución

  • Los /me/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo puntos de conexión y /users/{userId}/cloudPCs/{id}/getCloudPcLaunchInfo están en desuso y dejarán de devolver datos el 30 de octubre de 2026.
  • El /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo punto de conexión está en desuso y dejará de devolver datos el 18 de junio de 2026.
  • De ahora en adelante, usa la API retrieveCloudPcLaunchDetail .

Obtenga cloudPCLaunchInfo para un cloudPC específico que pertenezca al usuario que ha iniciado sesión actualmente.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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.Read.All CloudPC. ReadWrite. All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Solicitud HTTP

Para obtener el permiso delegado de un cloudPCLaunchInfo para un cloudPC específico del usuario especificado (que es el usuario que ha iniciado sesión) en la organización:

GET /me/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo
GET /users/{userId}/cloudPCs/{id}/getCloudPcLaunchInfo

Para obtener cloudPCLaunchInfo para un cloudPC específico de la organización mediante un permiso delegado (el usuario que ha iniciado sesión debe ser el administrador):

GET /deviceManagement/virtualEndpoint/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se realiza correctamente, esta función devuelve un 200 OK código de respuesta y un objeto cloudPcLaunchInfo en el cuerpo de la respuesta.

Ejemplos

Solicitud

GET https://graph.microsoft.com/beta/me/cloudPCs/{cloudPCId}/getCloudPcLaunchInfo

Respuesta

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.cloudPcLaunchInfo",
  "cloudPcId": "a20d556d-85f7-88cc-bb9c-08d9902bb7bb",
  "cloudPcLaunchUrl": "https://rdweb-r0.wvdselfhost.microsoft.com/api/arm/weblaunch/tenants/662009bc-7732-4f6f-8726-25883518b33e/resources/662009bc-7732-4f6f-8726-25883518b33e",
  "windows365SwitchCompatible":false,
  "windows365SwitchNotCompatibleReason":"CPCHardwareNotMeetRequirement"
}
  • Last updated on