トレーニング
ラーニング パス
FastTrack サービス、データ管理などを使用して、財務と運用アプリの実装を成功させるためのプロジェクト方法論を計画および設計します。
このブラウザーはサポートされなくなりました。
Microsoft Edge にアップグレードすると、最新の機能、セキュリティ更新プログラム、およびテクニカル サポートを利用できます。
この記事では、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 エラー応答およびリソースの種類」を参照してください。
サービスで問題が発生したか、サービスからアプリケーションに情報が送られました。
予期しないエラーが発生し、要求が失敗しました。
サービスは現在利用できません。
現在のユーザーのアカウントが、アクティブな要求の最大数を超えました。 アプリで要求を繰り返す必要があります。
サービスは要求されたセクション内にページを作成できません。そのセクションはパスワードで保護されています。
要求内で、data-render-src 属性に PDF が含まれる イメージ タグが最大数を超えました。 詳細については、「イメージおよびファイルの追加」を参照してください。
OneNote API は、指定されたセクション内にページを作成できませんでした。そのセクションは破損しています。
現在、サーバーがビジー状態であるため、受信した要求を処理できません。 後でもう一度お試しください。
ユーザーまたはグループの OneDrive にある 1 つ以上のドキュメント ライブラリに 5000 を超える OneNote のアイテム (ノートブック、セクション、セクション グループ) が含まれており、API を使用してクエリを実行することができません。 ユーザーまたはグループのドキュメント ライブラリに 5,000 個を超える OneNote 項目が含まれていないことを確認します。 軽減の手順については「OneNote 開発者ブログ」を参照してください。
エンティティを作成または更新できません。ノートブックが含まれるライブラリの場合、アイテムを編集する前にチェックアウトする必要があるためです。 詳細については、「ファイルのチェックアウトを必須にするようにライブラリを設定する」を参照してください。
ライブラリからチェックアウト要件を削除するか、ノートブックを移動します。
ユーザーまたはグループの OneDrive にある 1 つ以上のドキュメント ライブラリに 20,000 を超えるアイテムが含まれており、API を使用してクエリ用にインデックス付けをすることができません。 ユーザーまたはグループのドキュメント ライブラリに 20,000 を超える項目が含まれていないことを確認します。 軽減の手順については「OneNote 開発者ブログ」を参照してください。
現在、Azure Key Vault がビジー状態であるため、受信した要求を処理できません。 後でもう一度お試しください。
SharePoint は現在利用できません。 後でもう一度お試しください。
ユーザーまたはグループの OneDrive 上のドキュメント ライブラリが、一意のセキュリティ スコープのしきい値の制限を超えました。 ライブラリに設定する固有のセキュリティ スコープの最大数が、50,000 個を超えることはできません。
要求が正しくありません。
未定義のエラーが発生したため、要求は失敗しました。
アプリケーション コードで問題が発生しました。
要求に必須の "Presentation" パートがありません。 1 つだけ必要です。
要求に "Presentation" パートが 2 つ以上あります。 1 つだけ必要です。
"Presentation" パートのコンテンツ タイプは、text/HTML または application/XHTML+XML のいずれかでなければなりません。
"Presentation" パートの HTML に、src プロパティと data-render-src プロパティの両方が設定されている画像タグが含まれています。 API は src プロパティを無視し、 data-render-src プロパティを 使用します。
要求 URI が長すぎます。 URI の最大サイズ (すべてのパラメーターとデータを含む) は 16 KB または 16,384 文字です。
"Presentation" パートの HTML に、src プロパティと data-render-src プロパティのいずれかが設定されている画像タグが含まれています。 API は イメージ タグを無視します。
"Presentation" パートの HTML に含まれる作成日時の文字列が、許可される形式のいずれとも一致しません。
要求のサイズが大きすぎます。
要求のパートに名前が重複しているものがあります。 パートの名前は一意にする必要があります。
指定のコンテンツ タイプには Content-Disposition ヘッダーが指定されていません。
要求にはマルチパート ペイロードが含まれていますが、その形式が不正です。 空白行がない、最後の行がない、パートの区切りの書式が正しくないなどの問題が考えられます。 マルチパート メッセージを手動で作成する場合、ロジックを注意深く確認するか、サードパーティ ライブラリの使用をご検討ください。
この要求は、指定のパートにコンテンツ タイプを指定しません。
要求の中で、指定したパートの Content-Type ヘッダーおよび Content-Disposition ヘッダーが提供されていません。
マルチパート メッセージのパートの長さが最大サイズである 25 MB を超えています。
マルチパート メッセージのパート数が上限の 500 を超えています。
マルチパート メッセージの長さが上限の 75 MB を超えています。
電子メールの MIME の形式が正しくありませんでした。
会議の MIME または ICal の形式が正しくありませんでした。
ICal は見つかりませんでした。
要求の本文に無効な形式の Json がありました。
要求の構文に誤りがあります。
要求したプロパティは存在しません。
存在しないリソースが要求されました。
この要求では 、展開 クエリはサポートされていません。 「サポートされる OData のクエリ文字列オプション」をご覧ください。
pagelevel クエリ オプションは、セクションにあるページ コレクションまたは特定のページに対してクエリを行うときだけサポートされます。 例: 次に例を示します。
GET ../sections/{id}/pages?pagelevel=true
GET ../pages/{id}?pagelevel=true
要求に、サポートされていないクエリ演算子が含まれています。
要求に、サポートされていない OData クエリ パラメーターが含まれています。
PATCH 要求内のペイロードの構成が正しくありません。
データ パートを伴うページ作成要求では、コンテンツが "Presentation" パートを含むマルチパートである必要があります。
要求で使用されている OData 機能はサポートされていません。
ターゲット ノートブック、セクション グループ、セクション、またはページ エンティティの無効な ID が要求に含まれています。
要求で指定されたリソースが削除されました。
名前に無効な文字が含まれています。 ノートブック名には次の文字を含めることはできません: ? * \ / : < > | ' "
指定された名前のアイテムは、指定された場所に既に存在します。
"Presentation" パートの HTML に含まれる data-attachment 属性の形式が無効であるか、またはファイル名には無効な文字 (\ / : * ? < > | "
) が 1 つ以上含まれています。 要求では、エラー メッセージに示されている値に置き換えられました。
要求で指定された PATCH ターゲットが見つかりません。
要求に含まれている PATCH 引数が無効です。 「ページ コンテンツの更新」を参照してください。
要求で指定されている PATCH アクションはサポートされていません。 「ページ コンテンツの更新」を参照してください。
PATCH 要求は、指定されたページを変更できません。
マルチパートの PATCH 要求に、PATCH アクションの JSON 構造を指定した "commands" パートが含まれていません。 「ページ コンテンツの更新」を参照してください。
PATCH 要求にアクションが含まれていません。 「ページ コンテンツの更新」を参照してください。
メッセージ本文に、不正な書式設定の JSON またはこの操作に対してはサポートされていないフィールドが含まれています。
要求で指定された名前は不明なプロパティです。
要求に含まれている OData で、メッセージに示されている位置に構文エラーがあります。
要求に、値が大きすぎる上位のクエリ文字列オプションが含まれます。 ページのクエリの場合、最大値は 100 で、既定値は 20 です。
要求に含まれている URI が指している HTTP リソースが見つかりません。
要求に Content-Type の無効な値が含まれています。 メッセージに指定されている値を使用します。
要求に無効なコンテンツが含まれています。 このエラーのよくある原因は、Content-Type 要求ヘッダーの欠落や、要求の本文にコンテンツが含まれていないことです。
要求では、サポートされていない PATCH ターゲットを指定します。 「ページ コンテンツの更新」を参照してください。
要求に、PATCH アクションのターゲットとして無効な要素が指定されています。 ターゲットが データ ID 識別子を使用する場合は、必ず # 記号でプレフィックスを付けてください。 「ページ コンテンツの更新」を参照してください。
要求では、PATCH 操作でサポートされていないエンティティの種類を指定します。 See Update page content.
要求の data-render-src 属性または data-render-method 属性が無効であるか、属性がありません。 「キャプチャからデータを抽出する」を参照してください。
このターゲット ページにおいて、PATCH 要求はサポートされていません。
PATCH 要求のターゲット要素の種類では、append 操作はサポートされていません。「ページ コンテンツの更新」を参照してください。 See Update page content.
要求に、無効な data-tag 属性値が含まれています。 「ノート シールを使用する」を参照してください。
要求に、無効な data-tag ステータス値が含まれています。 チェック ボックスのノート シールには、completed ステータスを指定できます。
例:
<p data-tag="to-do:completed">To-do note tag in completed state (checked box in the UI)</p>
「ノート シールを使用する」を参照してください。
PATCH 要求のターゲット要素の種類では、指定の操作はサポートされていません。 「ページ コンテンツの更新」を参照してください。
要求には、子エンティティの親または親エンティティの子の 展開 式が含まれていますが、これはサポートされていません。 「サポートされる OData のクエリ文字列オプション」をご覧ください。
OData クエリが無効です。
要求に、ナビゲートでないプロパティに対する expand 式が含まれています。 展開できるのは、ナビゲート プロパティだけです。
要求の select 式または expand 式に、無効な用語が含まれています。
要素で style="position:absolute"
属性が指定されていますが、body 要素で data-absolute-enabled="true"
が指定されていません。この指定は、配置をサポートするためには必須です。 すべての位置設定が無視されます。 「絶対位置で配置された要素の作成」を参照してください。
属性は style="position:absolute"
、 body 要素の直接の子ではない要素で指定されます。これはサポートされていません。 要素が div、 img、または オブジェクトの場合は、本文の直接の子にします。それ以外の場合、位置設定は無視され、そのコンテンツは絶対位置 div 内にレンダリングされます。 「絶対位置で配置された要素の作成」を参照してください。
style="position:absolute"
属性がそれをサポートしない種類の要素で指定されています。 ページ本文の直接の子である div、img、object 要素だけが位置設定をサポートします。 「絶対位置で配置された要素の作成」を参照してください。
要求が指定しているターゲット要素が見つかりません。
要求は、この認証の種類に対して有効ではありません。 代わりに、../me/onenote/
パスを使用してください。
要求は、この認証の種類に対して有効ではありません。
../me/onenote/section/{id}/pages
エンドポイントを使用し、特定のセクションにページを作成します。
エンティティに name 値が指定されていません。 名前を定義する必要があり、その場合、名前には空白を含めることはできません。
エンティティ名に使用できない文字が含まれています。 名前には、以下の文字を含めることはできません: ? * \ / : < > | & # " % ~
エンティティ名を空白で始めることはできません。
名前が長すぎます。 Notebook names have a 128-character limit. Other entity names have a 50-character limit.
宛先リソースの指定された ID が存在しません。
宛先エンティティの指定された ID が無効です。
要求に指定されているサイト URL のメタデータを取得できません。 指定された URL の形式を確認してください。 サポートされている形式は https://domain.sharepoint.com/site-a
と https://domain.com/sites/site-a
です。
指定した ID を持つ Office 365 統合グループを見つけることができません。
コンテキストで、有効なユーザー ID が指定されていません。 一般的なエラーの 1 つとして、PUID/CID が 16 進数ではなく long 型として渡されたことが挙げられます。
アプリケーションは、短時間に非常に多くの要求をユーザーの代理で発行しました。 OneNote API の安定性と応答性を保つために、アプリケーションがリソースを消費しすぎることが検出されると、API は 429 ステータス コードとこのエラーを返します。
詳細については、「 Microsoft Graph サービス固有の調整ガイダンス」を参照してください。
要求で指定されたビデオ ソースはサポートされていません。 現行の一覧については、「サポートされているビデオ サイト」を参照してください。
この要求の最大セクション数を超えています。 セクション数が多いアカウントのページを取得するには、一度に 1 つのセクションのページを取得することをお勧めします ( List pages API を使用)。
ユーザーのアカウントに問題があります。
ユーザー アカウントが OneDrive クォータを超えました。 OneDrive に関するページを参照してください。
要求されたセクションは、最大サイズに達したため、これ以上追加できません。
要求に対するリソース消費量が多すぎます。 対象のユーザー アカウントに大きいデータセットが含まれているか、サービスが同じサイト (ユーザーの個人用サイトやチーム サイトなど) に対する多数の要求を同時に受信しています。
ユーザー アカウントが中断されました。
ユーザーの個人用 OneDrive for Business サイトはプロビジョニングされていないため、ノートブックにアクセスするために必要です。 OneNote サービスは今すぐサイトをプロビジョニングします。 この処理には数分かかることがあります。
OneDrive for Business は、ユーザーのためにプロビジョニング中です。
ユーザーの個人用 OneDrive for Business を取得できませんでした。 次の表に、いくつか考えられる原因を示します。
原因 | 解決策 |
---|---|
ユーザーの個人用サイトがプロビジョニングされていません。 | ユーザーは、OneDrive for Business を開き、サイトをプロビジョニングするためのすべての指示に従います。 これが失敗した場合は、Microsoft 365 テナント管理者に問い合わせる必要があります。 |
ユーザーの個人用サイトは現在プロビジョニング中です。 | 後で要求を再試行してください。 |
ユーザーは、有効な OneDrive for Business ライセンスを持っていません。 | ユーザーは、Microsoft 365 テナント管理者に問い合わせる必要があります。 |
ネットワークの問題により、要求が正常に送信されていません。 | 後で要求をお試しください。 |
要求の一部のユーザーは存在しません。
このテナントの学生情報サービスが登録されていません。
学生情報サービスに一般的なエラーがあります。
要求によって影響を受けた複数のユーザーは、同じユーザー名でした。
ノートブックは、招待を許可するように構成されていません。
必須パラメーターがありません。
ユーザーまたはアプリケーションに、適切なアクセス許可がありません。
要求に、有効な OAuth トークンが含まれていません。 「メモのアクセス許可」を参照してください。
ユーザーは、要求された場所に書き込むアクセス許可を持っていません。
ユーザーは、要求されたリソースにアクセスする許可を持っていません。
OAuth トークンには、要求されたアクションを実行するために必要なスコープが含まれていません。 「メモのアクセス許可」を参照してください。
OAuth トークンには、要求されたアクションを実行するために必要なスコープが含まれていません。 具体的には、編集のアクセス許可です。 「メモのアクセス許可」を参照してください。
ユーザーには、このリソースにアクセスする権限がありません。
このリソースへのアクセスが禁止されています。
コンテナーは、既に別のリソースに使用されています。
トレーニング
ラーニング パス
FastTrack サービス、データ管理などを使用して、財務と運用アプリの実装を成功させるためのプロジェクト方法論を計画および設計します。
ドキュメント
OneNote API によって OneNote コンテンツと構造を取得する - Microsoft Graph
OneNote のコンテンツと構造を取得するには、ターゲット エンドポイントに GET 要求を送信します。 次に、クエリ文字列オプションを使用してクエリをフィルター処理し、パフォーマンスを向上させます。
OneNote API を使用して OneNote ページを作成する - Microsoft Graph
POST 要求を pages エンドポイントに送信して、OneNote ページを作成します。 次に、メッセージ本文でページを定義する HTML を送信します。
OneNote ページ コンテンツを更新する - Microsoft Graph
ページのコンテンツ エンドポイントに PATCH 要求を送信して、OneNote ページのコンテンツを更新します。 次に、メッセージ本文に JSON 変更オブジェクトを送信します。