Compartir a través de


call: keepAlive

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.

Realice una solicitud a esta API cada 15 a 45 minutos para asegurarse de que una llamada en curso permanece activa. Una llamada que no recibe esta solicitud en un plazo de 45 minutos se considera inactiva y finaliza.

Al menos una solicitud correcta debe realizarse en un plazo de 45 minutos a partir de la solicitud anterior o el inicio de la llamada.

Se recomienda enviar una solicitud en intervalos de tiempo más cortos (cada 15 minutos). Asegúrese de que estas solicitudes se realicen correctamente para evitar que la llamada se agote y finalice.

Al intentar enviar una solicitud a una llamada que finalizó, se produce un 404 Not Found error. Los recursos relacionados con la llamada deben limpiarse en la aplicación.

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) No admitida. No admitida.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Calls.Initiate.All Calls.AccessMedia.All

Nota: Los permisos se comprueban cuando se crea la llamada; no se realiza ninguna comprobación de permisos adicional al llamar a esta API. Calls.AccessMedia.All solo es necesario para las llamadas que usan medios hospedados por la aplicación.

Solicitud HTTP

POST /communications/calls/{id}/keepAlive

Encabezados de solicitud

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

Cuerpo de la solicitud

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

Respuesta

Este método devuelve un código de 200 OK respuesta HTTP.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/communications/calls/2e1a0b00-2db4-4022-9570-243709c565ab/keepAlive

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK