Processar redirecionamentos de caixa de correio de arquivo

Uma caixa de correio de arquivo pode incluir uma caixa de correio de arquivo principal e uma ou mais caixas de correio de arquivo auxiliares (criadas através do arquivo de análise automática). Ao longo do tempo, os conteúdos das pastas podem ser distribuídos por estas caixas de correio.

Em alguns casos, é apresentada uma pasta na caixa de correio de arquivo principal, mas os respetivos conteúdos residem numa caixa de correio de arquivo auxiliar. Este tipo de pasta é denominado pasta expandida. Funciona como uma representação lógica da pasta no arquivo principal, mas os próprios dados são armazenados numa caixa de correio de arquivo diferente.

Quando uma aplicação acede a uma pasta expandida, a API pode devolver um redirecionamento HTTP ou uma resposta de erro. A resposta indica o ponto final correto para aceder ao conteúdo.

Como funciona

  • A sua aplicação faz um pedido a uma pasta ou item com o ID da caixa de correio de arquivo principal.
  • Se o destino residir num arquivo auxiliar, a API devolve uma resposta de redirecionamento (como HTTP 308 Permanent Redirect) com um URL de redirecionamento.
  • A sua aplicação faz um novo pedido ao URL indicado na resposta.

Exemplo 1: Redirecionar ao aceder a uma pasta

Quando acede a uma pasta que reside fisicamente numa caixa de correio de arquivo auxiliar, a API devolve um HTTP 308 Permanent Redirect com um Location cabeçalho.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

Resposta

O exemplo seguinte mostra a resposta para o redirecionamento.

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

Pedido de seguimento

Faça um novo pedido com o URL do Location cabeçalho.

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

Exemplo 2: Exportar itens com uma resposta de redirecionamento de arquivo

Ao exportar itens de uma caixa de correio que tenha pastas de arquivo com um intervalo automático, alguns itens na resposta podem incluir um ErrorArchiveFolderMovedPermanently erro em vez de dados. Isto indica que o item reside fisicamente numa caixa de correio de arquivo auxiliar. Volte a enviar o pedido de exportação para esses itens com o URL fornecido na mensagem de erro.

Resposta

O exemplo seguinte mostra uma resposta em que um item é exportado com êxito e outro requer um redirecionamento.

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 o item que devolveu ErrorArchiveFolderMovedPermanently, faça um novo pedido POST ao URL na mensagem de erro com o ID do item para exportá-lo.

Exemplo 3: Importar para uma pasta de arquivo com processamento de redirecionamento

Quando tenta importar um item para uma pasta que reside fisicamente numa caixa de correio de arquivo auxiliar (com um ecrã automático), recebe uma HTTP 409 Conflict resposta que indica a caixa de correio de destino correta.

Resposta

O exemplo a seguir mostra a resposta.

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 resolve este problema, crie uma nova sessão de importação direcionada para o ID da caixa de correio indicado na mensagem de erro (neste caso, MBX:f10964a6-4fd0-4f74-8@4d2e-9e48-109351d094ab). Utilize a propriedade importUrl da nova resposta de sessão para repetir a importação.

Conteúdo relacionado

  • Last updated on