Microsoft Graph の OneNote API のエラー コード
この記事では、API を介して送信される要求が失敗したときに、Microsoft Graph の OneNote API から返されるエラー コードについて説明します。
エラー応答例
送信した要求でエラーが発生すると、OneNote API はその要求の実行を停止し、エラー応答を JSON オブジェクトとして返します。 エラー応答には、関連付けられているエラー コード、メッセージ、およびこの記事の該当するセクションへのリンクが含まれます。 次の例は、エラー応答の様子を示しています。
{
"error":{
"code":"10002",
"message":"The service is currently unavailable. Please try again later.",
"innerError": {
"requestId": "request-id",
"date": "date-time"
}
}
}
Microsoft Graph エラーの詳細については、「Microsoft Graph エラー応答およびリソースの種類」を参照してください。
10001 から 19999 のコード
サービスで問題が発生したか、サービスからアプリケーションに情報が送られました。
10001
予期しないエラーが発生し、要求が失敗しました。
10002
サービスは現在利用できません。
10003
現在のユーザーのアカウントが、アクティブな要求の最大数を超えました。 アプリで要求を繰り返す必要があります。
10004
サービスは要求されたセクション内にページを作成できません。そのセクションはパスワードで保護されています。
10005
要求内で、data-render-src 属性に PDF が含まれる イメージ タグが最大数を超えました。 詳細については、「イメージおよびファイルの追加」を参照してください。
10006
OneNote API は、指定されたセクション内にページを作成できませんでした。そのセクションは破損しています。
10007
現在、サーバーがビジー状態であるため、受信した要求を処理できません。 後でもう一度お試しください。
10008
ユーザーまたはグループの OneDrive にある 1 つ以上のドキュメント ライブラリに 5000 を超える OneNote のアイテム (ノートブック、セクション、セクション グループ) が含まれており、API を使用してクエリを実行することができません。 ユーザーまたはグループのドキュメント ライブラリに 5,000 個を超える OneNote 項目が含まれていないことを確認します。 軽減の手順については「OneNote 開発者ブログ」を参照してください。
10012
エンティティを作成または更新できません。ノートブックが含まれるライブラリの場合、アイテムを編集する前にチェックアウトする必要があるためです。 詳細については、「ファイルのチェックアウトを必須にするようにライブラリを設定する」を参照してください。
ライブラリからチェックアウト要件を削除するか、ノートブックを移動します。
10013
ユーザーまたはグループの OneDrive にある 1 つ以上のドキュメント ライブラリに 20,000 を超えるアイテムが含まれており、API を使用してクエリ用にインデックス付けをすることができません。 ユーザーまたはグループのドキュメント ライブラリに 20,000 を超える項目が含まれていないことを確認します。 軽減の手順については「OneNote 開発者ブログ」を参照してください。
10014
現在、Azure Key Vault がビジー状態であるため、受信した要求を処理できません。 後でもう一度お試しください。
10015
SharePoint は現在利用できません。 後でもう一度お試しください。
10016
ユーザーまたはグループの OneDrive 上のドキュメント ライブラリが、一意のセキュリティ スコープのしきい値の制限を超えました。 ライブラリに設定する固有のセキュリティ スコープの最大数が、50,000 個を超えることはできません。
10017
要求が正しくありません。
19999
未定義のエラーが発生したため、要求は失敗しました。
20001 から 29999 のコード
アプリケーション コードで問題が発生しました。
20001
要求に必須の "Presentation" パートがありません。 1 つだけ必要です。
20002
要求に "Presentation" パートが 2 つ以上あります。 1 つだけ必要です。
20003
"Presentation" パートのコンテンツ タイプは、text/HTML または application/XHTML+XML のいずれかでなければなりません。
20004
"Presentation" パートの HTML に、src プロパティと data-render-src プロパティの両方が設定されている画像タグが含まれています。 API は src プロパティを無視し、 data-render-src プロパティを 使用します。
20005
要求 URI が長すぎます。 URI の最大サイズ (すべてのパラメーターとデータを含む) は 16 KB または 16,384 文字です。
20006
"Presentation" パートの HTML に、src プロパティと data-render-src プロパティのいずれかが設定されている画像タグが含まれています。 API は イメージ タグを無視します。
20007
"Presentation" パートの HTML に含まれる作成日時の文字列が、許可される形式のいずれとも一致しません。
20008
要求のサイズが大きすぎます。
20009
要求のパートに名前が重複しているものがあります。 パートの名前は一意にする必要があります。
20010
指定のコンテンツ タイプには Content-Disposition ヘッダーが指定されていません。
20011
要求にはマルチパート ペイロードが含まれていますが、その形式が不正です。 空白行がない、最後の行がない、パートの区切りの書式が正しくないなどの問題が考えられます。 マルチパート メッセージを手動で作成する場合、ロジックを注意深く確認するか、サードパーティ ライブラリの使用をご検討ください。
20012
この要求は、指定のパートにコンテンツ タイプを指定しません。
20013
要求の中で、指定したパートの Content-Type ヘッダーおよび Content-Disposition ヘッダーが提供されていません。
20014
マルチパート メッセージのパートの長さが最大サイズである 25 MB を超えています。
20015
マルチパート メッセージのパート数が上限の 500 を超えています。
20016
マルチパート メッセージの長さが上限の 75 MB を超えています。
20017
電子メールの MIME の形式が正しくありませんでした。
20018
会議の MIME または ICal の形式が正しくありませんでした。
20019
ICal は見つかりませんでした。
20020
要求の本文に無効な形式の Json がありました。
20100
要求の構文に誤りがあります。
20101
要求したプロパティは存在しません。
20102
存在しないリソースが要求されました。
20103
この要求では 、展開 クエリはサポートされていません。 「サポートされる OData のクエリ文字列オプション」をご覧ください。
20104
pagelevel クエリ オプションは、セクションにあるページ コレクションまたは特定のページに対してクエリを行うときだけサポートされます。 例: 次に例を示します。
GET ../sections/{id}/pages?pagelevel=true
GET ../pages/{id}?pagelevel=true
20106
要求に、サポートされていないクエリ演算子が含まれています。
20108
要求に、サポートされていない OData クエリ パラメーターが含まれています。
20109
PATCH 要求内のペイロードの構成が正しくありません。
20110
データ パートを伴うページ作成要求では、コンテンツが "Presentation" パートを含むマルチパートである必要があります。
20111
要求で使用されている OData 機能はサポートされていません。
20112
ターゲット ノートブック、セクション グループ、セクション、またはページ エンティティの無効な ID が要求に含まれています。
20113
要求で指定されたリソースが削除されました。
20115
名前に無効な文字が含まれています。 ノートブック名には次の文字を含めることはできません: ? * \ / : < > | ' "
20117
指定された名前のアイテムは、指定された場所に既に存在します。
20119
"Presentation" パートの HTML に含まれる data-attachment 属性の形式が無効であるか、またはファイル名には無効な文字 (\ / : * ? < > | ") が 1 つ以上含まれています。 要求では、エラー メッセージに示されている値に置き換えられました。
20120
要求で指定された PATCH ターゲットが見つかりません。
20121
要求に含まれている PATCH 引数が無効です。 「ページ コンテンツの更新」を参照してください。
20122
要求で指定されている PATCH アクションはサポートされていません。 「ページ コンテンツの更新」を参照してください。
20123
PATCH 要求は、指定されたページを変更できません。
20124
マルチパートの PATCH 要求に、PATCH アクションの JSON 構造を指定した "commands" パートが含まれていません。 「ページ コンテンツの更新」を参照してください。
20125
PATCH 要求にアクションが含まれていません。 「ページ コンテンツの更新」を参照してください。
20126
メッセージ本文に、不正な書式設定の JSON またはこの操作に対してはサポートされていないフィールドが含まれています。
20127
要求で指定された名前は不明なプロパティです。
20128
要求に含まれている OData で、メッセージに示されている位置に構文エラーがあります。
20129
要求に、値が大きすぎる上位のクエリ文字列オプションが含まれます。 ページのクエリの場合、最大値は 100 で、既定値は 20 です。
20130
要求に含まれている URI が指している HTTP リソースが見つかりません。
20131
要求に Content-Type の無効な値が含まれています。 メッセージに指定されている値を使用します。
20132
要求に無効なコンテンツが含まれています。 このエラーのよくある原因は、Content-Type 要求ヘッダーの欠落や、要求の本文にコンテンツが含まれていないことです。
20133
要求では、サポートされていない PATCH ターゲットを指定します。 「ページ コンテンツの更新」を参照してください。
20134
要求に、PATCH アクションのターゲットとして無効な要素が指定されています。 ターゲットが データ ID 識別子を使用する場合は、必ず # 記号でプレフィックスを付けてください。 「ページ コンテンツの更新」を参照してください。
20135
要求では、PATCH 操作でサポートされていないエンティティの種類を指定します。 See Update page content.
20136
要求の data-render-src 属性または data-render-method 属性が無効であるか、属性がありません。 「キャプチャからデータを抽出する」を参照してください。
20137
このターゲット ページにおいて、PATCH 要求はサポートされていません。
20138
PATCH 要求のターゲット要素の種類では、append 操作はサポートされていません。「ページ コンテンツの更新」を参照してください。 See Update page content.
20139
要求に、無効な data-tag 属性値が含まれています。 「ノート シールを使用する」を参照してください。
20140
要求に、無効な data-tag ステータス値が含まれています。 チェック ボックスのノート シールには、completed ステータスを指定できます。
例:
<p data-tag="to-do:completed">To-do note tag in completed state (checked box in the UI)</p>
「ノート シールを使用する」を参照してください。
20141
PATCH 要求のターゲット要素の種類では、指定の操作はサポートされていません。 「ページ コンテンツの更新」を参照してください。
20142
要求には、子エンティティの親または親エンティティの子の 展開 式が含まれていますが、これはサポートされていません。 「サポートされる OData のクエリ文字列オプション」をご覧ください。
20143
OData クエリが無効です。
20144
要求に、ナビゲートでないプロパティに対する expand 式が含まれています。 展開できるのは、ナビゲート プロパティだけです。
20145
要求の select 式または expand 式に、無効な用語が含まれています。
20146
要素で style="position:absolute" 属性が指定されていますが、body 要素で data-absolute-enabled="true" が指定されていません。この指定は、配置をサポートするためには必須です。 すべての位置設定が無視されます。 「絶対位置で配置された要素の作成」を参照してください。
20147
属性は style="position:absolute" 、 body 要素の直接の子ではない要素で指定されます。これはサポートされていません。 要素が div、 img、または オブジェクトの場合は、本文の直接の子にします。それ以外の場合、位置設定は無視され、そのコンテンツは絶対位置 div 内にレンダリングされます。 「絶対位置で配置された要素の作成」を参照してください。
20148
style="position:absolute" 属性がそれをサポートしない種類の要素で指定されています。 ページ本文の直接の子である div、img、object 要素だけが位置設定をサポートします。 「絶対位置で配置された要素の作成」を参照してください。
20149
要求が指定しているターゲット要素が見つかりません。
20150
要求は、この認証の種類に対して有効ではありません。 代わりに、../me/onenote/ パスを使用してください。
20151
要求は、この認証の種類に対して有効ではありません。
../me/onenote/section/{id}/pages エンドポイントを使用し、特定のセクションにページを作成します。
20152
エンティティに name 値が指定されていません。 名前を定義する必要があり、その場合、名前には空白を含めることはできません。
20153
エンティティ名に使用できない文字が含まれています。 名前には、以下の文字を含めることはできません: ? * \ / : < > | & # " % ~
20154
エンティティ名を空白で始めることはできません。
20155
名前が長すぎます。 Notebook names have a 128-character limit. Other entity names have a 50-character limit.
20156
宛先リソースの指定された ID が存在しません。
20157
宛先エンティティの指定された ID が無効です。
20158
要求に指定されているサイト URL のメタデータを取得できません。 指定された URL の形式を確認してください。 サポートされている形式は https://domain.sharepoint.com/site-a と https://domain.com/sites/site-a です。
20160
指定した ID を持つ Office 365 統合グループを見つけることができません。
20161
コンテキストで、有効なユーザー ID が指定されていません。 一般的なエラーの 1 つとして、PUID/CID が 16 進数ではなく long 型として渡されたことが挙げられます。
20166
アプリケーションは、短時間に非常に多くの要求をユーザーの代理で発行しました。 OneNote API の安定性と応答性を保つために、アプリケーションがリソースを消費しすぎることが検出されると、API は 429 ステータス コードとこのエラーを返します。
詳細については、「 Microsoft Graph サービス固有の調整ガイダンス」を参照してください。
20168
要求で指定されたビデオ ソースはサポートされていません。 現行の一覧については、「サポートされているビデオ サイト」を参照してください。
20266
この要求の最大セクション数を超えています。 セクション数が多いアカウントのページを取得するには、一度に 1 つのセクションのページを取得することをお勧めします ( List pages API を使用)。
30001 から 39999 のコード
ユーザーのアカウントに問題があります。
30101
ユーザー アカウントが OneDrive クォータを超えました。 OneDrive に関するページを参照してください。
30102
要求されたセクションは、最大サイズに達したため、これ以上追加できません。
30103
要求に対するリソース消費量が多すぎます。 対象のユーザー アカウントに大きいデータセットが含まれているか、サービスが同じサイト (ユーザーの個人用サイトやチーム サイトなど) に対する多数の要求を同時に受信しています。
30104
ユーザー アカウントが中断されました。
30105
ユーザーの個人用 OneDrive for Business サイトはプロビジョニングされていないため、ノートブックにアクセスするために必要です。 OneNote サービスは今すぐサイトをプロビジョニングします。 この処理には数分かかることがあります。
30106
OneDrive for Business は、ユーザーのためにプロビジョニング中です。
30108
ユーザーの個人用 OneDrive for Business を取得できませんでした。 次の表に、いくつか考えられる原因を示します。
| 原因 | 解決策 |
|---|---|
| ユーザーの個人用サイトがプロビジョニングされていません。 | ユーザーは、OneDrive for Business を開き、サイトをプロビジョニングするためのすべての指示に従います。 これが失敗した場合は、Microsoft 365 テナント管理者に問い合わせる必要があります。 |
| ユーザーの個人用サイトは現在プロビジョニング中です。 | 後で要求を再試行してください。 |
| ユーザーは、有効な OneDrive for Business ライセンスを持っていません。 | ユーザーは、Microsoft 365 テナント管理者に問い合わせる必要があります。 |
| ネットワークの問題により、要求が正常に送信されていません。 | 後で要求をお試しください。 |
30109
要求の一部のユーザーは存在しません。
30110
このテナントの学生情報サービスが登録されていません。
30111
学生情報サービスに一般的なエラーがあります。
30112
要求によって影響を受けた複数のユーザーは、同じユーザー名でした。
30113
ノートブックは、招待を許可するように構成されていません。
30114
必須パラメーターがありません。
40001 から 49999 のコード
ユーザーまたはアプリケーションに、適切なアクセス許可がありません。
40001
要求に、有効な OAuth トークンが含まれていません。 「メモのアクセス許可」を参照してください。
40002
ユーザーは、要求された場所に書き込むアクセス許可を持っていません。
40003
ユーザーは、要求されたリソースにアクセスする許可を持っていません。
40004
OAuth トークンには、要求されたアクションを実行するために必要なスコープが含まれていません。 「メモのアクセス許可」を参照してください。
40006
OAuth トークンには、要求されたアクションを実行するために必要なスコープが含まれていません。 具体的には、編集のアクセス許可です。 「メモのアクセス許可」を参照してください。
40007
ユーザーには、このリソースにアクセスする権限がありません。
40008
このリソースへのアクセスが禁止されています。
40009
コンテナーは、既に別のリソースに使用されています。