Microsoft Graph の OneNote API のエラーコード

[アーティクル]
03/26/2023

この記事では、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 を使用してクエリを実行することができません。ユーザーまたはグループのどのドキュメントライブラリについても、その中の OneNote アイテム数が 5000 を超えることがないようにしてください。軽減の手順については「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 は image タグを無視します。

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 アクションのターゲットとして無効な要素が指定されています。ターゲットで data-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

要求に、子エンティティの親、または親エンティティの子に対する expand 式が含まれていますが、それはサポートされていません。「サポートされる OData のクエリ文字列オプション」をご覧ください。

20143

OData クエリが無効です。

20144

要求に、ナビゲートでないプロパティに対する expand 式が含まれています。展開できるのは、ナビゲートプロパティだけです。

20145

要求の select 式または expand 式に、無効な用語が含まれています。

20146

要素で style="position:absolute" 属性が指定されていますが、body 要素で data-absolute-enabled="true" が指定されていません。この指定は、配置をサポートするためには必須です。すべての位置設定が無視されます。「絶対位置で配置された要素の作成」を参照してください。

20147

サポートされていない body 要素の直接の子ではない要素で style="position:absolute" 属性が指定されています。要素が div、img、object の場合、それを body の直接の子にします。直接の子にしない場合、位置設定が無視され、絶対位置で配置された 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

要求に指定されているビデオソースはサポートされていません。現行の一覧については、「サポートされているビデオサイト」を参照してください。

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

コンテナーは、既に別のリソースに使用されています。

Microsoft Graph の OneNote API のエラー コード