Freigeben über

Häufige Fehlerantworten und Codes

  • Artikel

Fehler in der OneDrive-API werden mithilfe der standardmäßigen HTTP-Statuscodes sowie eines JSON-Fehlerantwortobjekts zurückgegeben. Die folgenden HTTP-Statuscodes können erwartet werden.

Statuscode Statusmeldung Beschreibung
400 Ungültige Anforderung (Bad Request) Die Anforderung kann nicht verarbeitet werden, da sie fehlerhaft oder falsch ist.
401 Nicht autorisiert (Unauthorized) Erforderliche Authentifizierungsinformationen fehlen oder sind für die Ressource nicht gültig.
403 Forbidden Der Zugriff auf die angeforderte Ressource wird verweigert. Der Benutzer verfügt möglicherweise nicht über ausreichende Berechtigungen.
404 Nicht gefunden (Not Found) Die angeforderte Ressource ist nicht vorhanden.
405 Methode nicht zulässig (Method Not Allowed) Die HTTP-Methode in der Anforderung ist für die Ressource nicht zulässig.
406 Nicht zulässig (Not Acceptable) Dieser Dienst unterstützt nicht das im Accept-Header angeforderte Format.
409 Conflict Der aktuellen Status steht im Konflikt mit dem, was die Anforderung erwartet. Beispielsweise ist der angegebene übergeordnete Ordner nicht vorhanden.
410 Nicht vorhanden (Gone) Die angeforderte Ressource ist nicht mehr auf dem Server verfügbar.
411 Länge erforderlich (Length Required) Ein Content-Length-Header ist für die Anforderung erforderlich.
412 Fehler bei Vorbedingung (Precondition Failed) Eine in der Anforderung bereitgestellte Vorbedingung (z. B. ein if-match-Header) entspricht nicht dem aktuellen Status der Ressource.
413 Anforderungseinheit zu groß (Request Entity Too Large) Die Größe der Anforderung überschreitet den zulässigen Höchstwert.
415 Nicht unterstützter Medientyp (Unsupported Media Type) Der Inhaltstyp der Anfrage hat ein Format, das vom Dienst nicht unterstützt wird.
416 Angeforderter Bereich kann nicht erfüllt werden (Requested Range Not Satisfiable) Der angegebene Bytebereich ist ungültig oder nicht verfügbar.
422 Einheit kann nicht bearbeitet werden (Unprocessable Entity) Die Anforderung kann nicht verarbeitet werden, da sie semantisch falsch ist.
429 Zu viele Anforderungen (Too Many Requests) Die Clientanwendung wurde gedrosselt und sollte nicht versuchen, die Anforderung zu wiederholen, bis eine bestimmte Zeitspanne abgelaufen ist.
500 Interner Serverfehler (Internal Server Error) Beim Verarbeiten der Anforderung ist ein interner Serverfehler aufgetreten.
501 Nicht implementiert (Not Implemented) Das angeforderte Feature ist nicht implementiert.
503 Service Unavailable Der Dienst ist vorübergehend nicht verfügbar. Sie können die Anfrage nach einer kurzen Wartezeit wiederholen. Es ist möglicherweise ein Retry-After-Header vorhanden.
507 Unzureichender Speicher (Insufficient Storage) Das maximale Speicherkontingent wurde erreicht.
509 Bandwidth Limit Exceeded Die App wurde gedrosselt, da sie die maximale Bandbreite überschritten hat. Die App kann die Anforderung nach einiger Zeit wiederholen.

Die Fehlerantwort ist ein einzelnes JSON-Objekt, das eine einzige Eigenschaft mit dem Namen error enthält. Dieses Objekt enthält alle Fehlerdetails. Sie können die hier zurückgegebenen Informationen anstelle von oder zusätzlich zu dem zurückgegebenen HTTP-Statuscode verwenden. Nachfolgend finden Sie ein Beispiel für einen vollständige JSON-Fehlertext.

{
  "error": {
    "code": "invalidRange",
    "message": "Uploaded fragment overlaps with existing data.",
    "innererror": {
      "code": "fragmentOverlap"
    }
  }
}

Die Codeeigenschaft

Die code-Eigenschaft enthält einen von 15 möglichen Werten. Ihre Apps müssen in der Lage sein, diese Fehler behandeln zu können.

Code Beschreibung
accessDenied Der Aufrufer hat nicht die Berechtigung zum Ausführen der Aktion.
activityLimitReached Die App oder der Benutzer wurde gedrosselt.
generalException Ein nicht angegebener Fehler ist aufgetreten.
invalidRange Der angegebene Bytebereich ist ungültig oder nicht verfügbar.
invalidRequest Die Anforderung ist fehlerhaft oder falsch.
itemNotFound Die Ressource konnte nicht gefunden werden.
malwareDetected In der angeforderten Ressource wurde Schadsoftware erkannt.
nameAlreadyExists Der angegebene Elementname ist bereits vorhanden.
notAllowed Diese Aktion ist im System nicht zulässig.
notSupported Die Anforderung wird vom System nicht unterstützt.
resourceModified Die zu aktualisierende Ressource wurde geändert, seit der Aufrufer sie zuletzt gelesen hat.Dies ist in der Regel ein eTag-Konflikt.
resyncRequired Das Deltatoken ist nicht mehr gültig, und die App muss den Synchronisierungszustand zurücksetzen.
serviceNotAvailable Der Dienst ist nicht verfügbar. Wiederholen Sie die Anforderung nach einer Weile. Es ist möglicherweise ein Retry-After-Header vorhanden.
quotaLimitReached Der Benutzer hat sein Kontingent erschöpft.
unauthenticated Der Aufrufer konnte nicht authentifiziert werden.

Das innererror-Objekt kann rekursiv mehrere innererror-Objekte mit weiteren, spezifischeren Fehlercodes enthalten. Bei der Behandlung eines Fehlers sollten Apps alle verfügbaren Fehlercodes durchlaufen und den detailliertesten Fehlercode, den sie interpretieren können, verwenden. Einige der detaillierteren Codes sind unten auf dieser Seite aufgeführt.

Um zu überprüfen, ob es sich bei einem Fehlerobjekt um einen erwarteten Fehler handelt, müssen Sie die innererror-Objekte durchlaufen und dabei nach den erwarteten Fehlercodes suchen. Beispiel:

public bool IsError(string expectedErrorCode)
{
    OneDriveInnerError errorCode = this.Error;
    while (null != errorCode)
    {
        if (errorCode.Code == expectedErrorCode)
            return true;
        errorCode = errorCode.InnerError;
    }
    return false;
}

Ein umfassendes Beispiel für die ordnungsgemäße Behandlung von Fehlern finden Sie unter Behandlung von Fehlercodes in OneDrive.

Die message-Eigenschaft im Stamm enthält eine Fehlermeldung, die für den Entwickler vorgesehen ist. Fehlermeldungen werden nicht lokalisiert und sollten dem Benutzer nicht direkt angezeigt werden. Bei der Behandlung von Fehlern sollte Ihr Code nicht von message-Werte abhängen, da sie sich jederzeit ändern können und häufig dynamische Informationen zur fehlgeschlagenen Anforderung enthalten. Sie sollten den Code nur in Bezug auf Fehlercodes schreiben, die in code-Eigenschaften zurückgegeben werden.

Weitere Informationen zu der Ressource, die in der Fehlerantwort zurückgegeben wird, finden Sie im Thema Fehlerressourcentyp.

Detaillierte Fehlercodes

Im Folgenden finden Sie einige zusätzliche Fehler, die für Ihre App innerhalb der geschachtelten innererror Objekte auftreten können. Apps müssen diese nicht verarbeiten, können aber, wenn sie möchten. Der Dienst kann jederzeit neue Fehlercodes hinzufügen oder die Rückgabe alter Fehlercodes beenden. Daher ist es wichtig, dass alle Apps in der Lage sind, die oben genannten Grundlegenden 15 zu verarbeiten.

Code Beschreibung
accessRestricted Der Zugriff ist auf den Besitzer des Elements beschränkt.
cannotSnapshotTree Fehler beim Abrufen eines konsistenten Deltasnapshots. Versuchen Sie es später erneut.
childItemCountExceeded Höchstwert für die Anzahl der untergeordneten Elemente wurde erreicht.
entityTagDoesNotMatch Das ETag stimmt nicht mit dem aktuellen Wert des Elements überein.
fragmentLengthMismatch Die deklarierte Gesamtgröße für dieses Fragment unterscheidet sich von der Uploadsitzung.
fragmentOutOfOrder Hochgeladenes Fragment funktioniert nicht ordnungsgemäß.
fragmentOverlap Hochgeladenes Fragment überschneidet sich mit den vorhandenen Daten.
invalidAcceptType Ungültiger Accept-Typ.
invalidParameterFormat Ungültiges Parameterformat.
invalidPath Name enthält ungültige Zeichen.
invalidQueryOption Ungültige Abfrageoption.
invalidStartIndex Ungültiger Startindex.
lockMismatch Sperrtoken entspricht nicht der vorhandenen Sperre.
lockNotFoundOrAlreadyExpired Das Element hat derzeit keine nicht abgelaufene Sperre.
lockOwnerMismatch Die ID des Sperrenbesitzers entspricht nicht der angegebenen ID.
malformedEntityTag ETag-Heder ist fehlerhaft. ETags müssen in Anführungszeichen eingeschlossene Zeichenfolgen sein.
maxDocumentCountExceeded Höchstwert für die Anzahl der Dokumente wurde erreicht.
maxFileSizeExceeded Die maximale Dateigröße wurde erreicht.
maxFolderCountExceeded Die maximale Anzahl von Ordnern wurde erreicht.
maxFragmentLengthExceeded Die maximale Dateigröße wurde erreicht.
maxItemCountExceeded Die maximale Anzahl von Elementen wurde erreicht.
maxQueryLengthExceeded Die maximale Abfragelänge wurde überschritten.
maxStreamSizeExceeded Die maximale Streamgröße wurde überschritten.
parameterIsTooLong Der Parameter überschreitet die maximale Länge.
parameterIsTooSmall Der Parameter ist kleiner als der Mindestwert.
pathIsTooLong Der Pfad überschreitet die maximale Länge.
pathTooDeep Die maximale Tiefe der Ordnerhierarchie wurde erreicht.
propertyNotUpdateable Die Eigenschaft kann nicht aktualisiert werden.
resyncApplyDifferences Erneute Synchronisierung erforderlich. Ersetzen Sie alle lokalen Elemente durch die Serverversion (einschließlich gelöschter Elemente), wenn Sie sicher sind, dass der Dienst bei der letzten Synchronisierung mit den lokalen Änderungen aktualisiert wurde. Laden Sie alle lokalen Änderungen hoch, die dem Server noch nicht bekannt sind.
resyncRequired Erneute Synchronisierung erforderlich.
resyncUploadDifferences Erneute Synchronisierung erforderlich. Laden Sie alle lokalen Elemente hoch, die der Dienst nicht zurückgegeben hat, und laden Sie alle Dateien hoch, die sich von der Version auf dem Server unterscheiden (wobei Sie beide Kopien beibehalten, wenn Sie nicht sicher sind, welche die aktuelle ist).
serviceNotAvailable Der Server kann die aktuelle Anforderung nicht verarbeiten.
serviceReadOnly Ressource ist vorübergehend schreibgeschützt.
throttledRequest Zu viele Anforderungen.
tooManyResultsRequested Zu viele Ergebnisse angefordert.
tooManyTermsInQuery Zu viele Ausdrücke in der Abfrage.
totalAffectedItemCountExceeded Vorgang ist nicht zulässig, da die Anzahl der betroffenen Elemente den Schwellenwert überschreitet.
truncationNotAllowed Datenkürzung ist nicht zulässig.
uploadSessionFailed Fehler beim der Uploadsitzung.
uploadSessionIncomplete Uploadsitzung ist nicht vollständig.
uploadSessionNotFound Uploadsitzung nicht gefunden.
virusSuspicious Dieses Dokument ist verdächtig und hat möglicherweise ein Virus.
zeroOrFewerResultsRequested Es wurden null oder weniger Ergebnisse angefordert.