Lidar com redirecionamentos de caixa de correio de arquivo morto

Uma caixa de correio de arquivo morto pode incluir uma caixa de correio de arquivo morto principal e uma ou mais caixas de correio de arquivo morto auxiliares (criadas por meio da expansão automática do arquivo morto). Com o tempo, o conteúdo da pasta pode ser distribuído entre essas caixas de correio.

Em alguns casos, uma pasta aparece na caixa de correio de arquivo principal, mas seu conteúdo na verdade reside em uma caixa de correio de arquivo auxiliar. Esse tipo de pasta é chamado de pasta expandida. Ele atua como uma representação lógica da pasta no arquivo principal, mas os dados em si são armazenados em uma caixa de correio de arquivo morto diferente.

Quando um aplicativo acessa uma pasta expandida, a API pode retornar um redirecionamento HTTP ou uma resposta de erro. A resposta indica o ponto de extremidade correto para acessar o conteúdo.

Observação

Nomes de pastas conhecidos não têm suporte para caixas de correio de arquivo morto. Faça referência a pastas em caixas de correio de arquivo morto por ID de pasta em vez de por nome de pasta conhecido.

Como funciona

  • Seu aplicativo faz uma solicitação para uma pasta ou item usando a ID da caixa de correio de arquivo morto principal.
  • Se o destino residir em um arquivo auxiliar, a API retornará uma resposta de redirecionamento (como HTTP 308 Permanent Redirect) com uma URL de redirecionamento.
  • Seu aplicativo faz uma nova solicitação para a URL indicada na resposta.

Exemplo 1: Redirecionamento ao acessar uma pasta

Quando você acessa uma pasta que reside fisicamente em uma caixa de correio de arquivo auxiliar, a API retorna 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 a seguir 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==

Solicitação de acompanhamento

Faça uma nova solicitação usando a 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 morto

Ao exportar itens de uma caixa de correio que possui pastas de arquivo morto expandidas automaticamente, alguns itens na resposta podem incluir um ErrorArchiveFolderMovedPermanently erro em vez de dados. Isso indica que o item reside fisicamente em uma caixa de correio auxiliar de arquivo morto. Emita novamente a solicitação de exportação para esses itens usando a URL fornecida na mensagem de erro.

Resposta

O exemplo a seguir 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 retornou ErrorArchiveFolderMovedPermanently, faça uma nova solicitação POST para a URL na mensagem de erro com a ID do item para exportá-la.

Exemplo 3: importar para uma pasta de arquivo morto com tratamento de redirecionamento

Ao tentar importar um item para uma pasta que reside fisicamente em uma caixa de correio de arquivo morto auxiliar (expandida automaticamente), você recebe uma HTTP 409 Conflict resposta indicando 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 resolver esse problema, crie uma nova sessão de importação direcionada à ID da caixa de correio indicada na mensagem de erro (neste caso, MBX:f10964a6-4fd0-4f74-8@4d2e-9e48-109351d094ab). Use a propriedade importUrl da nova resposta de sessão para tentar a importação novamente.

Conteúdo relacionado

  • Last updated on