次の方法で共有


Microsoft Graph コネクタでのエラー応答

UI には限られた数の接続エラーが表示されます。包括的な一覧については、次の手順に従って、PowerShell スクリプトを使用して詳細なエラー レポートを生成します。

  1. 管理者権限でWindows PowerShellを開きます。
  2. 次のコマンドを使用して、PowerShell ギャラリーからスクリプトをインストールします
    Install-Script -Name DownloadErrorScript

このスクリプトを使用すると、Microsoft Graph コネクタ接続から項目エラーをダウンロードできます。 接続に関連付けられているテナント資格情報を使用して MSAL トークンを生成します。 スクリプトのインストールには、MSAL.PS モジュールが自動的に含まれます。 この問題が発生しない場合は、 を使用してモジュールを手動でインストールします。

    Install-Module -Name MSAL.PS

詳細については、「 エラー スクリプトのダウンロード」を参照してください。

  1. インストール後、スクリプトを実行します
    DownloadErrorScript.ps1
  1. エラー レポートをダウンロードする接続の接続 ID を指定します。
  2. 出力ファイルの名前を拡張子なしで指定します (拡張子なし、既定値は .csv)。
  3. エラーをダウンロードするためのバッチ サイズを定義します。 大量のバッチは、データ取得時間を最小限に抑えるために何千ものエラーに適していますが、エラーの可能性が高くなる可能性があります。 最大バッチ サイズは 5,000 エラーです。 テナント アカウントを使用してログインすると、ダウンロード プロセスが開始されます。
  4. バッチ サイズとエラー数に応じて、ダウンロード期間が異なります。 生成されたファイルは、指定した名前のスクリプトの実行パスに保存されます。

エラー レポートをダウンロードするための PowerShell スクリプトの実行を示すスクリーンショット。

エラーの監視

エラーを監視するには、[ データ ソース>アクティブ コネクタ] に移動すると、既存のクロール エラーが [現在のクロール>Errors] に表示されます。 このセクションでは、

  • エラー コード - 発生したさまざまなエラー コードをListsします。
  • Count - 各エラー コードの出現回数を表示します。
  • エラー ログのダウンロード - エラー ログをダウンロードするためのオプションを提供します。

特定のエラーに関する詳細情報を表示するには、対応するエラー コードを選択します。

現在のクロールと、選択したコネクタの [エラー] セクションを示す詳細ウィンドウを示すスクリーンショット。

次の一覧は、任意の接続に対して発生する可能性があるさまざまなエラーを示しています。

エラー コード エラー メッセージ ソリューション
1000 データ ソースは使用できません。 インターネット接続を確認するか、コネクタからデータ ソースに引き続きアクセスできることを確認します。 このエラーは、ネットワークの問題が原因でデータ ソースに到達できない場合、またはデータ ソース自体が削除、移動、または名前変更されたときに発生します。 指定されたデータ ソースの詳細がまだ有効かどうかを確認します。
1001 データ ソースがコネクタを調整しているため、データを更新できません。 データ ソースを取り消すには、スケール制限を増やすか、トラフィックが少ない時間帯まで待機できるかどうかをチェックします。
1002 データ ソースで認証できません。 このデータ ソースに関連付けられている資格情報が正しいことを確認します。 [ 編集] を 選択して、認証資格情報を更新します。
1003 コネクタに関連付けられているアカウントには、アイテムにアクセスするためのアクセス許可がありません。 適切なアカウントが、インデックスを作成するアイテムにアクセスできることを確認します。
1005 このデータ ソースに関連付けられている資格情報の有効期限が切れています。 資格情報を更新し、接続を更新します。 [ 編集] を 選択して、認証資格情報を更新します。
1008 テナントのクォータ使用率の合計が上限に達しました。 接続を削除してクォータの一部を解放するか、インジェスト フィルターを調整してデータを少なくしてみてください。 これらの手順で問題が解決しない場合は、Microsoft サポートにお問い合わせください。
1009 接続のクォータ使用率の合計が上限に達しました。 インジェスト フィルターを調整して、少ないデータを取り込んでみます。 この手順で問題が解決しない場合は、Microsoft サポートにお問い合わせください。
1010 Azure AD 以外のグループのインデックス作成に対するクォータ使用率の合計が 100 K の制限に達しました。 接続を削除してクォータの一部を解放するか、インジェスト フィルターを調整してデータを少なくしてみてください。 これらの手順で問題が解決しない場合は、Microsoft サポートにお問い合わせください。
1011 Microsoft Graph コネクタ エージェント に到達できないか、オフラインです。
1012 サポートされていない認証モードのため、接続への認証に失敗しました。 接続を編集して、接続の認証設定を更新します。
1015 このエージェントで作成されたConnectionsは、アクセス許可が不足しているために失敗します。 登録に使用する Microsoft Azure アプリに ExternalItem.ReadWrite.OwnedBy アクセス許可を付与して、アプリがサインインしているユーザーなしですべての外部アイテムの読み取りと書き込みを行い、クロールを再開できるようにします。 エージェントの登録に使用される Azure アプリに ExternalItem.ReadWrite.OwnedBy アクセス許可があることを確認します。
1016 このエージェントで作成されたConnectionsは、アクセス許可が不足しているために失敗します。 登録に使用する Microsoft Azure アプリに Directory.Read.All アクセス許可を付与して、organizationのディレクトリ内のデータを読み取り、クロールを再開します。 エージェントの登録に使用される Azure アプリに Directory.Read.All アクセス許可があることを確認します。
1017 ネットワークが使用できないため、アイテムにインデックスを作成できません。 ネットワークを復元し、次のクロールが行われ、アイテムのインデックスが作成されるまで待ちます。
1018 入力したユーザー アカウントに、Microsoft Graph コネクタ エージェントがインストールされているコンピューターに対する対話型ログオン権限があることを確認してください。 ユーザー アカウントに、Microsoft Graph コネクタ エージェントがインストールされているコンピューターに対する対話型ログオン権限があることを確認します。 詳細については、 ドキュメント を参照してください。
1019 GCA インスタンスに指定されたアプリ資格情報が無効であるか、有効期限が切れているため、接続に失敗しました。 資格情報を更新してください。 接続に関連付けられている GCA インスタンスのアプリ資格情報を確認します。
1020 接続に関連付けられている Microsoft Graph コネクタ エージェントは、GRPC コネクタ サーバーに接続できません。 GCA インスタンスは、GRPC 経由でカスタム コネクタに接続する際に問題が発生するため、データ ソースをクロールできませんでした。
1025 この接続に関連付けられている Microsoft Graph コネクタ エージェントは、重大な問題のため非推奨です。最新バージョンにアップグレードしてください。 詳しくは、以下を参照してください。https://aka.ms/gca 最新バージョンをhttps://aka.ms/GCAdownloadからダウンロードして、Microsoft Graph コネクタ エージェントのバージョンをアップグレードする|
1026 関連付けられている Microsoft Graph コネクタ エージェントに重大な問題があるため、TH 接続が失敗しました。 最新バージョンにアップグレードするか、サポートに問い合わせて問題を解決してください。 詳しくは、以下を参照してください。https://aka.ms/gca 最新バージョンをhttps://aka.ms/GCAdownloadからダウンロードして、Microsoft Graph コネクタ エージェントのバージョンをアップグレードする|
2001 キュー内の更新プログラムが多数あるため、インデックス作成が調整されます。 キューによっては、更新が完了するまでに時間がかかる場合があります。 キューがクリアされるまで待ちます。
2002 サポートされていない項目の書式設定のため、インデックス作成に失敗しました。 詳細については、コネクタ固有のドキュメントを参照してください。
2003 サポートされていない項目のコンテンツが原因でインデックス作成に失敗しました。 詳細については、コネクタ固有のドキュメントを参照してください。
2004 サポートされていない項目またはファイル サイズが原因でインデックス作成に失敗しました。 詳細については、コネクタ固有のドキュメントを参照してください。
2005 URI が長すぎるため、インデックス作成に失敗しました。 詳細については、コネクタ固有のドキュメントを参照してください。
2006 無効なマッピング式またはこのプロパティを持つMicrosoft Entraユーザーがないため、ユーザー マッピングが失敗しました。 別のマッピング式を使用して接続を削除して再作成してみてください。
2007 このアイテムを表示するアクセス許可のない一部のユーザーまたはグループにインデックスを作成できなかったため、このアイテムは Microsoft Search に表示されません。
2008 Connections 50,000 を超えるメンバーを持つ Azure AD 以外のグループを含めることはできません。 グループからユーザーを削除するか、インジェストからそのグループに関連付けられた項目を削除して、接続を再作成してください。
2009 Azure AD 以外のグループインデックス作成は、多数の要求が原因で一時的に一時停止されます。 システムがこれらの要求の処理を完了すると、インデックス作成が再開されます。 後でもう一度ご確認ください。
2010 この接続は、Microsoft によって行われた更新により無効になりました。 接続を削除し、新しい接続を作成します。
5000 問題が発生しました。 この問題が解決しない場合は、サポートにお問い合わせください。