Gérer les redirections de boîte aux lettres d’archivage

Une boîte aux lettres d’archivage peut inclure une boîte aux lettres d’archivage principale et une ou plusieurs boîtes aux lettres d’archivage auxiliaires (créées via l’archivage d’extension automatique). Au fil du temps, le contenu des dossiers peut être distribué entre ces boîtes aux lettres.

Dans certains cas, un dossier apparaît dans la boîte aux lettres d’archivage principale, mais son contenu réside en fait dans une boîte aux lettres d’archivage auxiliaire. Ce type de dossier est appelé dossier développé. Il agit comme une représentation logique du dossier dans l’archive principale, mais les données elles-mêmes sont stockées dans une autre boîte aux lettres d’archivage.

Lorsqu’une application accède à un dossier développé, l’API peut retourner une redirection HTTP ou une réponse d’erreur. La réponse indique le point de terminaison approprié pour accéder au contenu.

Mode de fonctionnement

  • Votre application adresse une requête à un dossier ou un élément à l’aide de l’ID de boîte aux lettres d’archivage principale.
  • Si la cible réside dans une archive auxiliaire, l’API retourne une réponse de redirection (telle que HTTP 308 Permanent Redirect) avec une URL de redirection.
  • Votre application effectue une nouvelle demande à l’URL indiquée dans la réponse.

Exemple 1 : Rediriger lors de l’accès à un dossier

Lorsque vous accédez à un dossier qui réside physiquement dans une boîte aux lettres d’archivage auxiliaire, l’API retourne un HTTP 308 Permanent Redirect avec un Location en-tête.

Demande

L’exemple suivant illustre une demande.

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

Réponse

L’exemple suivant montre la réponse pour la redirection.

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

Demande de suivi

Effectuez une nouvelle requête à l’aide de l’URL de l’en-tête Location .

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

Exemple 2 : Exporter des éléments avec une réponse de redirection d’archive

Lorsque vous exportez des éléments à partir d’une boîte aux lettres qui a des dossiers d’archivage automatiquement expandés, certains éléments de la réponse peuvent inclure une ErrorArchiveFolderMovedPermanently erreur au lieu de données. Cela indique que l’élément réside physiquement dans une boîte aux lettres d’archivage auxiliaire. Réexécutez la demande d’exportation pour ces éléments à l’aide de l’URL fournie dans le message d’erreur.

Réponse

L’exemple suivant montre une réponse dans laquelle un élément est exporté avec succès et un autre nécessite une redirection.

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"
            }
        }
    ]
}

Pour l’élément qui a retourné ErrorArchiveFolderMovedPermanently, effectuez une nouvelle requête POST à l’URL dans le message d’erreur avec l’ID d’élément pour l’exporter.

Exemple 3 : Importer dans un dossier d’archivage avec gestion des redirections

Lorsque vous tentez d’importer un élément dans un dossier qui réside physiquement dans une boîte aux lettres d’archivage auxiliaire (automatiquement étendue), vous recevez une HTTP 409 Conflict réponse qui indique la boîte aux lettres cible correcte.

Réponse

L’exemple suivant illustre la réponse.

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."
}

Pour résoudre ce problème, créez une session d’importation ciblant l’ID de boîte aux lettres indiqué dans le message d’erreur (dans ce cas, MBX:f10964a6-4fd0-4f74-8@4d2e-9e48-109351d094ab). Utilisez la propriété importUrl de la nouvelle réponse de session pour réessayer l’importation.

Contenu connexe

  • Last updated on