Fehlercodes für die OneNote-API in Microsoft Graph
In diesem Artikel werden Fehlercodes beschrieben, die die OneNote-API in Microsoft Graph zurückgibt, wenn eine über die API gesendete Anforderung fehlschlägt.
Fehlerantwort-Beispiel
Wenn Ihre Anforderung einen Fehler generiert, hält die OneNote-API die Ausführung der Anforderung an und gibt eine Fehlerantwort als JSON-Objekt zurück. Eine Fehlerantwort enthält den zugehörigen Fehlercode, eine Nachricht und einen Link zum entsprechenden Abschnitt dieses Artikels. Im folgenden Beispiel wird eine Fehlerantwort veranschaulicht.
{
"error":{
"code":"10002",
"message":"The service is currently unavailable. Please try again later.",
"innerError": {
"requestId": "request-id",
"date": "date-time"
}
}
}
Weitere Informationen zu Microsoft Graph-Fehlern finden Sie unter Microsoft Graph-Fehlerantworten und Ressourcentypen.
Codes von 10001-19999
Der Dienst hat Probleme oder sendet Informationen zur Anwendung.
10001
Ein unerwarteter Fehler ist aufgetreten, und die Anforderung ist fehlgeschlagen.
10002
Der Dienst ist derzeit nicht verfügbar.
10003
Das Konto des aktuellen Benutzers hat die maximale Anzahl aktiver Anforderungen überschritten. Ihre App muss die Anforderung wiederholen.
10004
Der Dienst kann keine Seite im angeforderten Abschnitt erstellen, da der Abschnitt kennwortgeschützt ist.
10005
Die Anforderung enthält mehr als die Maximalanzahl an Bildtags, wobei das data-render-src-Attribut eine PDF enthält. Siehe Hinzufügen von Bildern und Dateien
10006
Die OneNote-API konnte keine Seite im angegebenen Abschnitt erstellen, da dieser Abschnitt beschädigt ist.
10007
Der Server ist zu ausgelastet, um die eingehende Anforderung zu bearbeiten. Versuchen Sie es später erneut.
10008
Eine oder mehrere der Dokumentbibliotheken des OneDrive-Benutzers oder der -Gruppe enthalten mehr als 5.000 OneDrive-Elemente (Notizbücher, Abschnitte, Abschnittsgruppen) und können nicht mithilfe der API abgefragt werden. Stellen Sie sicher, dass keine der Dokumentbibliotheken des Benutzers oder der Gruppe mehr als 5.000 OneNote-Elemente enthält. Im OneNote-Entwicklerblog finden Sie Informationen zur Reduzierung der Elemente.
10012
Die Entität kann nicht erstellt oder aktualisiert werden, da aus der Bibliothek, die das Notizbuch enthält, Elemente ausgecheckt werden müssen, bevor diese bearbeitet werden können. Weitere Informationen finden Sie unter Einrichten einer Bibliothek, um das Auschecken von Dateien erforderlich zu machen.
Entfernen Sie entweder die Anforderung zum Auschecken aus der Bibliothek oder verschieben Sie das Notizbuch.
10013
Eine oder mehrere der Dokumentbibliotheken des OneDrive-Benutzers oder der -Gruppe enthalten mehr als 20.000 Elemente und können nicht für die Abfrage mit der API indexiert werden. Stellen Sie sicher, dass keine der Dokumentbibliotheken des Benutzers oder der Gruppe mehr als 20.000 Elemente enthält. Im OneNote-Entwicklerblog finden Sie Informationen zur Reduzierung der Elemente.
10014
Azure Key Vault ist zu ausgelastet, um die eingehende Anforderung zu bearbeiten. Versuchen Sie es später erneut.
10015
SharePoint ist derzeit nicht verfügbar. Versuchen Sie es später erneut.
10016
Die Dokumentbibliothek auf dem OneDrive des Benutzers oder der Gruppe hat den Schwellenwert für eindeutige Sicherheitsbereiche überschritten. Der Sicherheitsschwellwert von 50.000 für die Bibliothek darf nicht überschritten werden.
10017
Ungültige Anforderung.
19999
Die Anforderung ist fehlgeschlagen, da ein unbekannter Fehler aufgetreten ist.
Codes von 20001 bis 29999
Der Anwendungscode hat etwas falsch gemacht.
20001
In der Anforderung fehlt der erforderliche "Präsentation"-Teil. Es ist einer erforderlich.
20002
Die Anforderung enthält zwei oder mehr "Präsentation"-Teile. Es ist einer erforderlich.
20003
Der Inhaltstyp des "Präsentation"-Teils kann nur Text/HTML oder Anwendung/XHTML + XML sein.
20004
Die „Presentation”-Teil-HTML des HTML-Codes enthält ein Bild-Tag mit den festgelegten Eigenschaften src und data-render-src. Die API ignoriert die src-Eigenschaft und verwendet die data-render-src-Eigenschaft .
20005
Die Anforderungs-URI ist zu lang. Der maximale Länge der Anforderungs-URI (einschließlich aller Parameter und Daten) beträgt 16 KB oder 16.384 Zeichen.
20006
Die „Presentation”-Teil-HTML enthält ein Bild-Tag, für das weder eine src- noch eine data-render-src-Eigenschaft festgelegt wurde. Die API ignoriert das Imagetag .
20007
Die „Presentation”-Teil-HTML enthält eine Zeichenfolge mit Erstellungsdatum/-Uhrzeit, die keinem zulässigen Format entspricht.
20008
Die Anforderung ist zu groß.
20009
Die Anforderung enthält Teile mit doppelten Namen. Teilnamen müssen eindeutig sein.
20010
Die Kopfzeile „Content-Disposition“ wurde nicht für den angegebenen Inhaltstyp festgelegt.
20011
Die Anforderung enthält eine ungültige mehrteilige Nutzlast. Das Problem kann durch fehlende Leerzeilen, eine fehlende letzten Zeile, falsch formatierte Teil-Trennzeichen usw. ausgelöst werden. Wenn Sie die mehrteilige Nachricht manuell erstellen, überprüfen Sie sorgfältig die Logik oder ziehen Sie eine Drittanbieter-Bibliothek hinzu.
20012
Die Anforderung stellt keinen Inhaltstyp für das angegebene Teil zur Verfügung.
20013
Die Anforderung stellt keinen Inhaltstyp und keine Kopfzeile für die Content-Disposition für das angegebene Teil zur Verfügung.
20014
Die Länge eines Teils in der mehrteiligen Nachricht überschreitet die maximale Größe von 25 MB.
20015
Die Anzahl der Teile in der mehrteiligen Nachricht überschreitet die Begrenzung von 500.
20016
Die Länge der mehrteiligen Nachricht überschreitet die maximale Größe von 75 MB.
20017
Die E-Mail-MIME ist fehlerhaft.
20018
Die Besprechungs-MIME oder -ICal ist fehlerhaft.
20019
Es wurde kein ICal gefunden.
20020
Es wurde ein fehlerhafter Json-Anforderungstext gefunden.
20100
Etwas stimmt mit der Syntax der Anforderung nicht.
20101
Die angeforderte Eigenschaft ist nicht vorhanden.
20102
Sie haben eine Ressource angefordert, die nicht vorhanden ist.
20103
Die expand-Abfrage wird für diese Anforderung nicht unterstützt. Siehe Unterstützte Zeichenfolge-Optionen für OData-Anfragen.
20104
Die pagelevel-Abfrageoption wird nur unterstützt, wenn Sie eine Abfrage für die Seitensammlung in einem Abschnitt oder für eine bestimmte Seite ausführen. Beispiel:
GET ../sections/{id}/pages?pagelevel=true
GET ../pages/{id}?pagelevel=true
20106
Ihre Anforderung enthält einen Abfrageoperator, der nicht unterstützt wird.
20108
Die Anforderung enthält nicht unterstützte OData-Abfrageparameter.
20109
Die Nutzlast in der PATCH-Anforderung wurde nicht ordnungsgemäß erstellt.
20110
Bei Anfragen für die Erstellung von Seiten mit Datenteilen muss der Inhalt mehrteilig sein und einen „Präsentation“-Teil enthalten.
20111
Ihre Anforderung verwendet ein OData-Feature, das nicht unterstützt wird.
20112
Ihre Anfrage enthält eine ungültige ID für das Ziel-Notebook, die Abschnittsgruppe, den Abschnitt oder die Seitenentität.
20113
Die in der Anforderung angegebene Ressource wurde gelöscht.
20115
Der Name enthält ungültige Zeichen. Der Name des Notizbuchs darf die folgenden Zeichen nicht enthalten: ? * \ / : < > | ' "
20117
Ein Element mit dem angegebenen Namen ist bereits im angegebenen Ort vorhanden.
20119
Die HTML im „Presentation“-Teil enthält ein data-attachment-Attribut, das kein gültiges Format hat oder einen oder mehrere dieser ungültigen Zeichen für einen Dateinamen enthält: \ / : * ? < > | ". Die Anforderung hat den Wert in der Fehlermeldung ersetzt.
20120
Die Anforderung gibt ein PATCH-Ziel an, das nicht gefunden werden kann.
20121
Die Anforderung enthält ein ungültiges PATCH-Argument. Weitere Informationen finden Sie unter Aktualisieren von Seiteninhalt.
20122
Ihre Anforderung gibt eine nicht unterstützte PATCH-Aktion an. Weitere Informationen finden Sie unter Aktualisieren von Seiteninhalt.
20123
Die PATCH-Anforderung kann die angegebene Seite nicht ändern.
20124
Die mehrteilige PATCH-Anforderung beinhaltet keinen „Befehle“-Teil mit der PATCH-Aktion-JSON-Struktur. Siehe Aktualisieren von Seiteninhalt.
20125
Ihre PATCH-Anforderung enthält keine Aktionen. Weitere Informationen finden Sie unter Aktualisieren von Seiteninhalt.
20126
Der Nachrichtentext enthält entweder falsch formatierten JSON-Code oder Felder, die für diesen Vorgang nicht unterstützt werden.
20127
Die Anfrage gibt den Namen einer unbekannten Eigenschaft an.
20128
Die Anforderung enthält einen OData-Syntaxfehler an der in der Nachricht angegebenen Position.
20129
Die Anforderung enthält eine top-Abfrage-Zeichenfolgeoption, deren Wert zu hoch ist. Der Maximalwert für Seitenabfragen beträgt 100, und der Standardwert ist 20.
20130
Die Anforderung enthält einen URI, der zu einer HTTP-Ressource zeigt, die nicht gefunden werden kann.
20131
Die Anforderung enthält einen ungültigen Wert für den Inhaltstyp. Verwenden Sie den in der Nachricht angegeben Wert.
20132
Die Anforderung enthält ungültige Inhalte. Häufige Ursachen hierfür sind eine fehlende Kopfzeile für die Inhaltstyp-Anfrage und/oder keine Inhalte im Textkörper der Anfrage.
20133
Ihre Anforderung gibt ein PATCH-Ziel an, das nicht unterstützt wird. Weitere Informationen finden Sie unter Aktualisieren von Seiteninhalt.
20134
Die Anforderung gibt ein ungültiges Element als Ziel der PATCH-Aktion an. Wenn das Ziel den Daten-ID-Bezeichner verwendet, stellen Sie sicher, dass Sie ihr ein #-Symbol voranstellen. Weitere Informationen finden Sie unter Aktualisieren von Seiteninhalt.
20135
Ihre Anforderung gibt einen Entitätstyp an, der für den PATCH-Vorgang nicht unterstützt wird. Weitere Informationen finden Sie unter Aktualisieren von Seiteninhalt.
20136
Ihre Anforderung enthält ein ungültiges oder fehlendes data-render-src- oder data-render-method-Attribut. Siehe Extrahieren von Daten aus Bildschirmausschnitten.
20137
Die Zielseite unterstützt keine PATCH-Anforderungen.
20138
Das Ziel in der PATCH-Anforderung unterstützt die angegebene appendAktion nicht. Weitere Informationen finden Sie unter Aktualisieren von Seiteninhalt.
20139
Die Anforderung enthält einen ungültigen data-tag-Attributwert. Weitere Informationen finden Sie unter Verwenden von Notiztags.
20140
Die Anforderung enthält einen ungültigen data-tag-Statuswert. Kontrollkästchen-Notiztags können den Status completed besitzen.
Beispiel:
<p data-tag="to-do:completed">To-do note tag in completed state (checked box in the UI)</p>
Siehe Verwenden von Notiztags.
20141
Der Zielelementtyp in der PATCH-Anforderung unterstützt die angegebene Aktion nicht. Weitere Informationen finden Sie unter Aktualisieren von Seiteninhalt.
20142
Ihre Anforderung enthält einen Erweiterungsausdruck für ein übergeordnetes Element von untergeordneten Entitäten oder ein untergeordnetes Element von übergeordneten Entitäten, der nicht unterstützt wird. Siehe Unterstützte Zeichenfolge-Optionen für OData-Anfragen.
20143
Die OData-Abfrage ist ungültig.
20144
Die Anforderung enthält einen expand-Ausdruck für eine Nicht-Navigationseigenschaft. Nur Navigationseigenschaften können erweitert werden.
20145
Der select- oder expand-Ausdruck in der Anforderung enthält einen ungültigen Term.
20146
Das style="position:absolute"-Attribut wurde für ein Element angegeben, aber das body-Element gibt data-absolute-enabled="true" nicht an, das jedoch für die Unterstützung der Positionierung erforderlich ist. Alle Positionseinstellungen werden ignoriert. Siehe Erstellen von absolut positionierten Elementen.
20147
Das style="position:absolute" Attribut wird für ein Element angegeben, das kein direktes untergeordnetes Element des Body-Elements ist, was nicht unterstützt wird. Wenn das Element ein div-, img- oder -Objekt ist, machen Sie es zu einem direkten untergeordneten Element des Texts. Andernfalls werden die Positionseinstellungen ignoriert, und ihr Inhalt wird innerhalb eines absoluten positionierten div-Elements gerendert. Siehe Erstellen von absolut positionierten Elementen.
20148
Das style="position:absolute"-Attribut ist für einen nicht unterstützten Elementyp angegeben. Nur div-, img- und object-Elemente, die direkt untergeordnete Elemente des Seitentextes sind, unterstützten die Positionierung. Siehe Erstellen von absolut positionierten Elementen.
20149
Die Anforderung gibt ein Zielelement an, das nicht gefunden werden kann.
20150
Die Anforderung ist für diesen Authentifizierungstyp ungültig. Verwenden Sie stattdessen den ../me/onenote/-Pfad.
20151
Die Anforderung ist für diesen Authentifizierungstyp ungültig. Verwenden Sie den ../me/onenote/section/{id}/pages-Endpunkt, um eine Seite in einem bestimmten Abschnitt zu erstellen.
20152
Für die Entität ist kein name-Wert angegeben. Der Name muss definiert werden, und er darf nicht nur aus Leerzeichen bestehen.
20153
Der Entitätsname enthält ungültige Zeichen. Der Name darf die folgenden Zeichen nicht enthalten: ? * \ / : < > | & # " % ~
20154
Der Entitätsname darf nicht mit einem Leerzeichen beginnen.
20155
Der Entitätsname ist zu lang. Namen für Notizbücher dürfen maximal 128 Zeichen lang sein. Andere Entitätsnamen dürfen maximal 50 Zeichen lang sein.
20156
Die angegebene ID für die Zielressource ist nicht vorhanden.
20157
Die angegebene ID für die Zielentität ist ungültig.
20158
Die Metadaten für die in der Anforderung angegebene Website-URL können nicht abgerufen werden. Überprüfen Sie das Format der angegebenen URL. Zu den unterstützten Formate gehören https://domain.sharepoint.com/site-a und https://domain.com/sites/site-a.
20160
Es kann keine einheitliche Office 365-Gruppe mit der angegebenen ID gefunden werden.
20161
Der Kontext gibt keine gültige Benutzer-ID an. Ein häufiger Fehler ist, dass die PUID/CID in Langform statt als Hexadezimalwert übergeben wurde.
20166
Die Anwendung hat zu viele Anfragen im Auftrag eines Benutzers innerhalb eines kurzen Zeitraums ausgegeben. Um sicherzustellen, dass die OneNote-API stabil und reaktionsschnell bleibt, gibt die API den Statuscode 429 und diesen Fehler aus, wenn sie erkennt, dass eine Anwendung zu viele Ressourcen verwendet.
Weitere Informationen finden Sie unter Dienstspezifische Drosselungsanleitung für Microsoft Graph.
20168
Die in der Anforderung angegebene Videoquelle wird nicht unterstützt. Eine aktuelle Liste finden Sie unter Unterstützte Video-Websites.
20266
Die maximale Anzahl von Abschnitten wird für diese Anforderung überschritten. Zum Abrufen von Seiten für Konten mit einer hohen Anzahl von Abschnitten wird empfohlen, Seiten für jeweils einen Abschnitt abzurufen (verwenden Sie die API für Listenseiten ).
Codes von 30001 bis 39999
Etwas stimmt nicht mit dem Benutzerkonto.
30101
Das Benutzerkonto hat sein OneDrive-Kontingent überschritten. Siehe OneDrive.
30102
Es kann nichts mehr zum angeforderten Abschnitt hinzugefügt werden, da dieser seine maximale Größe ereicht hat.
30103
Der Ressourceverbrauch ist zu hoch für die Anforderung. Entweder weist das Benutzerkonto ein zu großes Datenset auf, oder der Dienst erhält eine große Anzahl konkurrierender Anforderungen für dieselbe Website (z. B. die persönliche Website des Benutzers oder eine Teamwebsite).
30104
Das Benutzerkonto wurde gesperrt.
30105
Die persönliche OneDrive for Business-Website des Benutzers wird nicht bereitgestellt, was für den Zugriff auf Notizbücher erforderlich ist. Der OneNote-Dienst stellt die Seite jetzt bereit. Dieser Vorgang kann mehrere Minuten dauern.
30106
OneDrive for Business wird für den Benutzer bereitgestellt.
30108
Das persönliche OneDrive for Business des Benutzers konnte nicht abgerufen werden. Die folgende Tabelle enthält mögliche Ursachen.
| Ursache | Lösung |
|---|---|
| Die persönliche Website des Benutzers wurde nicht bereitgestellt. | Der Benutzer sollte OneDrive for Business öffnen und die Anweisungen befolgen, um die Website bereitzustellen. Wenn dies fehlschlägt, sollten sie sich an ihren Microsoft 365-Mandantenadministrator wenden. |
| Die persönliche Website des Benutzers wird derzeit bereitgestellt. | Senden Sie die Anforderung später erneut. |
| Der Benutzer besitzt keine gültige OneDrive for Business-Lizenz. | Der Benutzer sollte sich an seinen Microsoft 365-Mandantenadministrator wenden. |
| Die Anfrage konnte aufgrund eines Netzwerkfehlers nicht erfolgreich versendet werden. | Senden Sie die Anforderung später erneut. |
30109
Einige Benutzer in der Anforderung sind nicht vorhanden.
30110
Student Information Services wurde nicht für diesen Mandanten registriert.
30111
Es ist ein allgemeiner Fehler mit Student Information Services aufgetreten.
30112
Mehrere Benutzer, die von dieser Anforderung betroffen waren, besitzen den gleichen Benutzernamen.
30113
Das Notebook ist nicht so konfiguriert, dass es Einladungen zulässt.
30114
Ein erforderlicher Parameter fehlt.
Codes von 40001 bis 49999
Der Benutzer oder die Anwendung besitzt nicht die erforderlichen Berechtigungen.
40001
Die Anforderung enthält kein gültiges OAuth-Token. Siehe Notizberechtigungen.
40002
Der Benutzer hat keine Berechtigung, an den angeforderten Ort zu schreiben.
40003
Der Benutzer hat keine Berechtigung, auf die angeforderte Ressource zuzugreifen.
40004
Das OAuth-Token hat nicht den erforderlichen Umfang, um die angeforderte Aktion durchzuführen. Siehe Notizberechtigungen.
40006
Das OAuth-Token hat nicht den erforderlichen Umfang, um die angeforderte Aktion durchzuführen. Bearbeiten Sie die Berechtigung entsprechend. Siehe Notizberechtigungen.
40007
Der Benutzer hat nicht die Berechtigungen, auf diese Ressource zuzugreifen.
40008
Der Zugriff ist für diese Ressource nicht zulässig.
40009
Der Container wird bereits von einer anderen Ressource verwendet.