Controlar redireccionamientos de buzones de archivo

Un buzón de archivo puede incluir un buzón de archivo principal y uno o varios buzones de archivo auxiliares (creados mediante el archivo de autoexpandación). Con el tiempo, el contenido de la carpeta podría distribuirse entre estos buzones.

En algunos casos, aparece una carpeta en el buzón de archivo principal, pero su contenido reside realmente en un buzón de archivo auxiliar. Este tipo de carpeta se denomina carpeta expandida. Actúa como una representación lógica de la carpeta en el archivo principal, pero los propios datos se almacenan en un buzón de archivo diferente.

Cuando una aplicación accede a una carpeta expandida, la API podría devolver una respuesta de error o redirección HTTP. La respuesta indica el punto de conexión correcto para acceder al contenido.

Cómo funciona

  • La aplicación realiza una solicitud a una carpeta o elemento mediante el identificador de buzón de archivo principal.
  • Si el destino reside en un archivo auxiliar, la API devuelve una respuesta de redireccionamiento (como HTTP 308 Permanent Redirect) con una dirección URL de redireccionamiento.
  • La aplicación realiza una nueva solicitud a la dirección URL indicada en la respuesta.

Ejemplo 1: Redirección al acceder a una carpeta

Al acceder a una carpeta que reside físicamente en un buzón de archivo auxiliar, la API devuelve un HTTP 308 Permanent Redirect con un Location encabezado.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:e0643f21@a7809c93/folders/NJWt2LeVEAAAIBDAAAAA==

Respuesta

En el ejemplo siguiente se muestra la respuesta para el redireccionamiento.

HTTP/1.1 308 Permanent Redirect
Content-Length: 0
Location: https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:767fh867@a7809c93/folders/NJWt2LeVEAAAIBDAAAAA==

Solicitud de seguimiento

Realice una nueva solicitud mediante la dirección URL del Location encabezado.

GET https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:767fh867@a7809c93/folders/NJWt2LeVEAAAIBDAAAAA==

Ejemplo 2: Exportación de elementos con una respuesta de redireccionamiento de archivo

Al exportar elementos de un buzón de correo que tiene carpetas de archivo autoexpandadas, algunos elementos de la respuesta pueden incluir un ErrorArchiveFolderMovedPermanently error en lugar de datos. Esto indica que el elemento reside físicamente en un buzón de archivo auxiliar. Vuelva a emitir la solicitud de exportación para esos elementos mediante la dirección URL proporcionada en el mensaje de error.

Respuesta

En el ejemplo siguiente se muestra una respuesta en la que un elemento se exporta correctamente y otro requiere una redirección.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.exportItemResponse)",
    "value": [
        {
            "itemId": "AAMkADHGHGDDDSSAFDHGJ",
            "changeKey": "CQAAABYAAAC92FzB9+QsR5Q6SPVnShx0AAAAABQ/",
            "data": "AQAAAAgAAAAAAAAAAQAAAAQAA"
        },
        {
            "itemId": "AQMkADVmZgBkYzA2OSADDSG",
            "Error": {
                "message": "https://graph.microsoft.com/beta/admin/exchange/mailboxes/MBX:5ffdc069-c31e-43fa-9542-eaf862ce18c0@601eaae7-815e-4d2e-9e48-109351d094ab/exportItems",
                "code": "ErrorArchiveFolderMovedPermanently"
            }
        }
    ]
}

Para el elemento que devolvió ErrorArchiveFolderMovedPermanently, realice una nueva solicitud POST a la dirección URL del mensaje de error con el identificador de elemento para exportarlo.

Ejemplo 3: Importación a una carpeta de archivo con control de redirección

Al intentar importar un elemento en una carpeta que reside físicamente en un buzón de archivo auxiliar (autoexpandado), recibe una HTTP 409 Conflict respuesta que indica el buzón de destino correcto.

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 409 Conflict
Content-type: application/json

{
    "Message": "Invalid import session. The target session is expected in mailbox MBX:f10964a6-4fd0-4f74-8@4d2e-9e48-109351d094ab."
}

Para resolver este problema, cree una nueva sesión de importación destinada al identificador de buzón indicado en el mensaje de error (en este caso, MBX:f10964a6-4fd0-4f74-8@4d2e-9e48-109351d094ab). Use la propiedad importUrl de la nueva respuesta de sesión para volver a intentar la importación.

Contenido relacionado

  • Last updated on