Behandeln von Archivpostfachumleitungen

Ein Archivpostfach kann ein Hauptarchivpostfach und ein oder mehrere zusätzliche Archivpostfächer (erstellt durch automatisches Erweitern des Archivs) enthalten. Im Laufe der Zeit können Ordnerinhalte auf diese Postfächer verteilt werden.

In einigen Fällen wird ein Ordner im Hauptarchivpostfach angezeigt, aber sein Inhalt befindet sich tatsächlich in einem hilfsigen Archivpostfach. Dieser Ordnertyp wird als erweiterter Ordner bezeichnet. Es fungiert als logische Darstellung des Ordners im Hauptarchiv, aber die Daten selbst werden in einem anderen Archivpostfach gespeichert.

Wenn eine Anwendung auf einen erweiterten Ordner zugreift, gibt die API möglicherweise eine HTTP-Umleitung oder eine Fehlerantwort zurück. Die Antwort gibt den richtigen Endpunkt für den Zugriff auf den Inhalt an.

So funktioniert es

  • Ihre App sendet eine Anforderung an einen Ordner oder ein Element mithilfe der Hauptpostfach-ID des Archivs.
  • Wenn sich das Ziel in einem Hilfsarchiv befindet, gibt die API eine Umleitungsantwort (z HTTP 308 Permanent Redirect. B. ) mit einer Umleitungs-URL zurück.
  • Ihre App sendet eine neue Anforderung an die in der Antwort angegebene URL.

Beispiel 1: Umleitung beim Zugriff auf einen Ordner

Wenn Sie auf einen Ordner zugreifen, der sich physisch in einem zusätzlichen Archivpostfach befindet, gibt die API einen HTTP 308 Permanent Redirect mit einem Header zurück Location .

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort für die Umleitung.

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

Folgeanforderung

Stellen Sie eine neue Anforderung mithilfe der URL aus dem Location Header.

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

Beispiel 2: Exportieren von Elementen mit einer Archivumleitungsantwort

Wenn Sie Elemente aus einem Postfach exportieren, das automatisch erweiterte Archivordner enthält, enthalten einige Elemente in der Antwort möglicherweise einen ErrorArchiveFolderMovedPermanently Fehler anstelle von Daten. Dies gibt an, dass sich das Element physisch in einem zusätzlichen Archivpostfach befindet. Führen Sie die Exportanforderung für diese Elemente mithilfe der in der Fehlermeldung angegebenen URL erneut aus.

Antwort

Das folgende Beispiel zeigt eine Antwort, bei der ein Element erfolgreich exportiert wird und ein anderes eine Umleitung erfordert.

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

Stellen Sie für das Element, das zurückgegeben hat ErrorArchiveFolderMovedPermanently, eine neue POST-Anforderung an die URL in der Fehlermeldung mit der Element-ID, um sie zu exportieren.

Beispiel 3: Importieren in einen Archivordner mit Umleitungsverarbeitung

Wenn Sie versuchen, ein Element in einen Ordner zu importieren, der sich physisch in einem zusätzlichen (automatisch erweiterten) Archivpostfach befindet, erhalten Sie eine HTTP 409 Conflict Antwort, die das richtige Zielpostfach angibt.

Antwort

Das folgende Beispiel zeigt die Antwort.

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

Um dieses Problem zu beheben, erstellen Sie eine neue Importsitzung für die in der Fehlermeldung angegebene Postfach-ID (in diesem Fall MBX:f10964a6-4fd0-4f74-8@4d2e-9e48-109351d094ab). Verwenden Sie die importUrl-Eigenschaft aus der neuen Sitzungsantwort, um den Import erneut zu versuchen.

Verwandte Inhalte

  • Last updated on