message: recall

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.

Recupere un mensaje en la carpeta Elementos enviados del buzón de usuario especificado.

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)	Mail.ReadWrite	No disponible.
Delegado (cuenta personal de Microsoft)	Mail.ReadWrite	No disponible.
Aplicación	Mail.ReadWrite	No disponible.

Solicitud HTTP

POST /me/mailFolders/sentitems/messages/{id}/recall
POST /users/{id | userPrincipalName}/mailFolders/sentitems/messages/{id}/recall

Encabezados de solicitud

Encabezado	Valor
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

Si se ejecuta correctamente, este método devuelve un 202 Accepted código de respuesta y una cadena que contiene información del servidor en el cuerpo de la respuesta.

Si el identificador no es válido, este método devuelve y 400 Bad request la información de error detallada en el cuerpo de la respuesta.

Ejemplo

En el siguiente ejemplo se muestra cómo llamar a esta API.

Solicitud

La siguiente solicitud recupera el mensaje especificado en la carpeta de elementos enviados del buzón de correo del usuario especificado.

Nota: El identificador aquí se abrevia para mejorar la legibilidad.

POST https://graph.microsoft.com/beta/me/mailFolders/sentitems/messages/AAMkADhAAATs28OAAA=/recall

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "Successfully submitted recall request to Hub server LV8PR00MB1800.NAMPRD00.PROD.OUTLOOK.COM, MessageId is CSRUBSZRRANU4.HEXMGAAG0OPH2@dm6pr00mb0830."
}